Conduit Matrix 服务器安装指南

By | 2026-02-28

Conduit Matrix 部署

Matrix (Element) 是目前开源社区中生态最成熟、功能最全的即时通讯（IM）方案之一。其架构遵循“存算分离”的设计哲学：Matrix 充当底层通信协议（后端服务），而 Element 则是目前最主流的跨平台官方客户端（前端界面）。

在本方案中，后端服务器采用 Conduit —— 它是 Matrix 协议的高效轻量化实现，极大地降低了资源占用。在前端选择上，除了功能丰富、适合作为生产力的 Element 外，我们也兼顾了追求极简体验的 FluffyChat 等轻量化客户端，以满足不同场景下的连接需求。

一、 环境与权限准备

# 1. 创建专用系统用户
sudo useradd -r -M -s /usr/sbin/nologin conduit

# 2. 创建目录
sudo mkdir -p /etc/conduit
sudo mkdir -p /var/lib/matrix-conduit

# 3. 设置权限归属
sudo chown -R conduit:conduit /etc/conduit /var/lib/matrix-conduit

二、 下载二进制包

从 GitLab Artifacts 获取最新构建版本。

# 1. 下载并解压
wget "https://gitlab.com/famedly/conduit/-/jobs/13093361282/artifacts/download?file_type=archive" -O conduit_artifacts.zip
unzip conduit_artifacts.zip

# 2. 安装至系统目录并赋权
sudo mv x86_64-unknown-linux-musl /usr/local/bin/conduit
sudo chmod +x /usr/local/bin/conduit

# 3. 验证
conduit --version

三、 编写配置文件

请确保 server_name 正确设置为域名。

  1. 打开文件： sudo vi /etc/conduit/conduit.toml
[global]
# 域名后缀
server_name = "pite.site"

# 数据库配置
database_path = "/var/lib/matrix-conduit/"
database_backend = "rocksdb"

# 网络设置
address = "0.0.0.0"
port = 6167

# 权限设置
allow_registration = true
allow_federation = true
max_request_size = 20000000

四、 创建 Systemd 服务文件 (使用 vi)

  1. 打开文件： sudo vi /etc/systemd/system/conduit.service
[Unit]
Description=Conduit Matrix Server (pite.site)
After=network.target

[Service]
User=conduit
Group=conduit
Restart=always
Environment="CONDUIT_CONFIG=/etc/conduit/conduit.toml"
ExecStart=/usr/local/bin/conduit
WorkingDirectory=/var/lib/matrix-conduit

[Install]
WantedBy=multi-user.target

五、 启动与状态检查

# 1. 重载与启动
sudo systemctl daemon-reload
sudo systemctl reset-failed conduit
sudo systemctl enable --now conduit

# 2. 检查状态
sudo systemctl status conduit

六、 账号管理 (Admin Room 指令)

当你在 Element 中成功连接到服务器后，搜索并私聊本地管理员 @admin:pite.site。

创建新用户：

指令格式：
create-user <用户名> [密码]

操作示例：

  1. 在私聊框输入：create-user jack 12345678
  2. 系统回复创建成功后，新用户即可登录。

其他常用指令：

  • list-users: 查看服务器现有用户。
  • make-admin <@用户名:pite.site>: 将普通用户设为管理员。
  • deactivate-user <@用户名:pite.site>: 停用某个账号。

软件界面

PC element

https://element.io/app 下载的64位Windows
PC 版示例

Android FluffyChat

Android 版示例

IOS FluffyChat

IOS 版示例

⚠️ 提醒：

  1. 如果你的域名切换必须清空旧数据库：sudo rm -rf /var/lib/matrix-conduit/*（否则会因为 ID 不匹配报错）。
  2. HTTPS 证书：手机端 Element 连接域名时强制要求 HTTPS。如果你还没有配置反向代理（如 Caddy/Nginx）来提供证书，手机端可能会提示“找不到服务器”。