【docker】私有IM | Matrix的部署与使用
本文发布于262天前,最后更新于244天前,其中的信息可能有所发展或是发生改变。如有疑问请联系邮箱:admin@yemengstar.com。

1. 前言

打造自己的私有IM,私有聊天室~

官网:Matrix.org

官方安装文档:Installation – Synapse (matrix-org.github.io)

官方docker:matrixdotorg/synapse – Docker Image | Docker Hub

演示:

2. 准备

夜梦这里使用的是雨云的服务器,长期全场景九折 + 首月五折优惠链接:https://www.rainyun.com/

更多服务器推荐请看:服务器推荐 | 部分服务器测评

此项目必须使用域名,通过 namesilo 注册域名可以使用1美元优惠码:yemeng。

在开始部署之前,你需要安装 docker和docker-compose。具体安装见:【docker】在服务器上安装 docker/docker-compose

3. 部署

3.1 生成配置文件

创建文件夹:

mkdir -p /root/data/docker_data/matrix/data
cd /root/data/docker_data/matrix

需要将域名解析到服务器,然后修改下面代码中SYNAPSE_SERVER_NAME的值为你的域名,例如matrix.yemengstar.com

docker run -it --rm \
    -v /root/data/docker_data/matrix/data:/data \
    -e SYNAPSE_SERVER_NAME=matrix.yemengstar.com \
    -e SYNAPSE_REPORT_STATS=yes \
    matrixdotorg/synapse:latest generate

运行以后,homeserver.yaml会自动生成在/var/lib/docker/volumes/synapse-data/_data中,你可以查看这个配置文件,必要的时候可以进行修改。

查看homeserver.yaml

cd data
vim homeserver.yaml

默认生成的配置如下:

# Configuration file for Synapse.
#
# This is a YAML file: see [1] for a quick introduction. Note in particular
# that *indentation is important*: all the elements of a list or dictionary
# should have the same indentation.
#
# [1] https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html
#
# For more information on how to configure Synapse, including a complete accounting of
# each option, go to docs/usage/configuration/config_documentation.md or
# https://element-hq.github.io/synapse/latest/usage/configuration/config_documentation.html
server_name: "matrix.yemengstar.com"
pid_file: /data/homeserver.pid
listeners:
  - port: 8008
    tls: false
    type: http
    x_forwarded: true
    resources:
      - names: [client, federation]
        compress: false
database:
  name: sqlite3
  args:
    database: /data/homeserver.db
log_config: "/data/matrix.yemengstar.com.log.config"
media_store_path: /data/media_store
registration_shared_secret: "***"
report_stats: true
macaroon_secret_key: "***"
form_secret: "***"
signing_key_path: "/data/matrix.yemengstar.com.signing.key"
trusted_key_servers:
  - server_name: "matrix.org"


# vim:ft=yaml

默认的配置文件没有开启注册功能,所以需要我们手动开启一下。

英文输入法下按i进入编辑模式后,在这个配置文件的最后加入:

enable_registration: true
enable_registration_without_verification: true

esc后,输入:wq保存退出。当然你可以选择直接把这个配置文件删了然后编辑好全部贴入。

你也可以新添加一些环境变量,夜梦因为用不到所以就不写了(懒),需要的小伙伴可以查看官方给出的额外的环境变量的配置:matrixdotorg/synapse – Docker Image | Docker Hub

3.2 运行synapse[1]

/root/data/docker_data/matrix文件夹中创建运行配置文件:

vim docker-compose.yml

贴入:

version: "3.3"

services:
  synapse:
    image: "matrixdotorg/synapse:latest"
    container_name: "matrix_synapse"
    restart: unless-stopped
    ports:
      - 8008:8008
    volumes:
      - "./data:/data"
    environment:
      VIRTUAL_HOST: "matrix.yemengstar.com"
      VIRTUAL_PORT: 8008
      LETSENCRYPT_HOST: "matrix.yemengstar.com"
      SYNAPSE_SERVER_NAME: "matrix.yemengstar.com"
      SYNAPSE_REPORT_STATS: "yes"

设置默认权限:

chown -R 991:991 /root/data/docker_data/matrix/data

运行:

docker-compose up -d

4. 反向代理

你需要完成反向代理并开启SSL,具体为你的域名->服务器IP:8008,反代可以参考下面两篇文章:

【docker】反向代理神器 ——Nginx Proxy Manager 的安装

【docker】Nginx Proxy Manager 的使用

具体如下图所示:

访问域名可以看到下面的界面:

5. 配合element

夜梦推荐直接下载官方的app用,省的折腾了~

下载地址:Download Element

官方客户端安装好打开,长下面这样:

我们点编辑,添加自己的服务器(域名):

创建新用户:

注册需要强密码。成功登录~

强烈建议在注册完用户以后,关闭注册功能:

enable_registration: false
enable_registration_without_verification: false

然后重启一下docker容器:

docker restart <CONTAINER ID>

聊天~

参考

  1. ^https://iwanlab.com/docker-compose-install-matrix-element/
本文为夜梦星尘原创文章。
文章作者:夜梦星尘
文章链接:【docker】私有IM | Matrix的部署与使用
版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自夜梦星尘
支持作者:夜梦星尘的爱发电
上一篇
下一篇