1> 基于docker搭建

① 生成配置文件

SYNAPSE_SERVER_NAME =mx.qq.com 可以将mx.qq.com 更改为自定义的域名

cd /data/matrix

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

② 运行服务端

docker run -d --name synapse \
       -v /data/matrix:/data \
       -p 8008:8008 \
       matrixdotorg/synapse:latest

③ 修改参数

修改/data/matrix/homeserver.yaml 中的参数:

# Enable registration for new users.
# 允许注册新用户，默认值是 false
enable_registration: true
enable_registration_without_verification: true

④ 新建用户

register_new_matrix_user -c /data/homeserver.yaml http://localhost:8008

2> 官网推荐方法

sudo apt install -y lsb-release wget apt-transport-https

sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
    sudo tee /etc/apt/sources.list.d/matrix-org.list

sudo apt update

sudo apt install matrix-synapse-py3

① 查看运行状态

sudo systemctl enable matrix-synapse
sudo systemctl start matrix-synapse
sudo systemctl status matrix-synapse

如果显示服务状态为 active (running)，即说明服务正常运行；

如果 matrix-synapse 服务未能正常启动，通过
cat /var/log/matrix-synapse/homeserver.log查看错误信息，如果在 log 文件中看到这一行：

twisted.internet.error.CannotListenError: Couldn't listen on ::1:8008: [Errno 99] Cannot assign requested address.

则需要通过vim /etc/matrix-synapse/conf.d/homeserver.yaml修改配置文件 homeserver.yaml 中的 listeners 这一部分：

将 bind_addresses 一行修改为：

bind_addresses: ['0.0.0.0']

然后重启服务

② 修改配置

生成一个随机字符串：

cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1

打开 homeserver.yaml，添加如下内容，将上面生成的随机字符串放在双引号内。该设置意味着禁止通过网页前端注册新用户，但可以在后台以命令行的形式创建新用户。

enable_registration: false
registration_shared_secret: "LdP91UDoqxNAqJDdAIhZF9NUxJItVc79"

重启 matrix-synapse 服务

③ 配置postgresql数据库

安装postgresql数据库

su - postgres

# 创建用户, 按提示指定用户密码
createuser --pwprompt synapse_user

# 创建数据库
createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

④ 新建用户

register_new_matrix_user -c /etc/matrix-synapse/conf.d/homeserver.yaml http://localhost:8008

⑤ 修改配置文件

vim /etc/matrix-synapse/conf.d/homeserver.yaml

database:
  name: psycopg2
  args:
    user: synapse_user
    password: <password>
    database: synapse
    host: 127.0.0.1
    cp_min: 5
    cp_max: 10