动手部署自己的 Matrix 服务器：从选型到第一个账号

动手部署自己的 Matrix 服务器：从选型到域名到第一个账号

前两篇讲了 Matrix 是什么、技术底层怎么工作，这回来点实在的：把一台自己的 Matrix 服务器（homeserver）真正跑起来。

别被「自建服务器」这几个字吓到，也没你想的那么复杂。一台能跑的 Linux 虚机、一个域名、半小时左右，就能拥有一个完全属于你的 Matrix 实例。整个过程我会按「选型 → 准备 → 部署 → 配置 → 验证」的顺序讲，每一步给出可以直接照抄的命令。

先想清楚：你要折腾到什么程度

自建 Matrix 服务器，方案大概有四个梯度，从省事到折腾：

1. 托管方案：直接用别人家的付费托管（比如 etke.cc 这类），付钱完事，你只管用。适合想要自主权但不想碰运维的人。
2. 全栈容器一键部署：用现成脚本装一套 Synapse（服务器核心）+ Element（网页前端）+ Caddy（反转代）+ 一堆配套组件。最典型的是一条 curl 装好的 Ansible 脚本，也是大多数人起步的选择。
3. 官方 Docker 姿势：只跑核心的 Synapse 容器，其余的自己组装。可控性更高，但要自己管的东西也多。
4. 裸机编译：源码装 Synapse，纯自虐路线，不建议新手碰。

对绝大多数人，我推荐第 2 种：先让它跑起来，再谈优化。今天这篇也主要围绕这条路展开。

为什么选 Synapse：不是因为它最好，而是因为它最成熟

服务器核心（homeserver implementation）有两个主流选择：Synapse（Python 写的，Matrix 官方维护的参考实现）和 Dendrite / Conduit（一个 Go、一个 Rust，主打轻量高性能）。

选 Synapse 的理由很朴素：文档最全、生态最大、踩坑的人最多所以你排错最容易。它确实是出了名的「吃内存记得给足」，一个空房间跑起来加数据库轻轻松松占掉一两 G。如果你手头就是台 512M 的小鸡，那 Synapse 会有点吃力，这时候 Conduit 这类轻量实现更合适。但作为第一篇部署教程，我默认你用 Synapse，因为它最不容易在奇怪的地方翻车。

准备一台服务器和一个域名

硬件层面没有硬性要求，阿里云、腾讯云、Vultr、Hetzner 随便哪家都行，2C4G 是舒适线，1C2G 勉强能跑但别指望快。系统用 Ubuntu 22.04/24.04 LTS，这是最不容易出兼容问题的组合。

域名是硬需求，Matrix 的联邦和用户 ID 都依赖域名，不是可有可无的。你需要：

• 一个主域名，比如 matrix.example.com
• 让这个域名能解析到你的服务器 IP
• 建议同时把 example.com 也解析过来，因为 Matrix 的发现机制（.well-known）要用它来告诉别的服务器「这个用户属于哪个 homeserver」

这一步准备得越扎实，后面越省事。DNS 解析生效有延迟，可以先设置 TTL 短一点，等部署完再调回。

一键脚本：Ansible 全栈部署

Synapse 官方提供了一套 Ansible playbook，能把整个栈按清单编起来。前提是：

1. 拿到服务器后，用 root 登录（或能 sudo）
2. 配好 SSH key，让本地能免密连上去
3. 装好 ansible、git 到你的本机，不需要装到服务器

然后按官方文档 clone 下 playbook，编辑 inventory 和 vars.yaml：

1
2
3

matrix_domain: example.com
matrix_server_name: example.com
matrix_homeserver_implementation: synapse

关键的变量是 matrix_server_name，它决定了你的用户 ID 长什么样。在这个例子里，你的账号会成为 @你:example.com。这个值一旦定下来后面改起来极痛苦，请务必一次想清楚。

配置写好后跑：

1

ansible-playbook -i inventory/hosts setup.yml --tags=setup-all

第一次跑会拉镜像、建数据库（PostgreSQL）、装 Caddy 并自动申请 Let’s Encrypt 证书。整个过程看着滚屏就行，耐心等。装完它会打出一个访问链接，通常是 https://matrix.example.com。

到这里，你的 Matrix 服务器就已经「能跑」了，只是还没有任何用户。

注册第一个账号

新装的 Synapse 默认不开放注册，这是防垃圾信息的默认安全姿势。要建账号，最稳的方式是本地注册（因为它绕过了反垃圾的注册限制）：

1

ansible-playbook -i inventory/hosts setup.yml --tags=register-user -e username=你的用户名 -e password=你的密码 -e admin=yes

加 admin=yes 就拿到了管理员权限，之后可以在后台管理房间里的一切。

想开放公网注册？在 vars.yaml 里把 matrix_synapse_enable_registration: true 打开，重新执行 setup 就行。但我要敲个警钟：开放注册的公共 Matrix 服务器是垃圾消息重灾区，没有配好反滥用策略就开放注册，等于给自己的服务器挖坑。自用或小圈子，本地注册完全够了。

拿到账号后，客户端怎么连

服务器搭好了，得有个客户端。网页版最简单：直接浏览器访问服务器的同一个链接。Synapse 全栈部署会带上一个 Element Web 前端，登录你刚建的账号就能用。

也可以装桌面或手机客户端：Element 系列最通用，FluffyChat 更轻，SchildiChat 是魔改版。官方客户端清单在 element.io 的「Download」页面就能找到。登录时服务器地址填 https://matrix.example.com，账号填 @你:example.com，完事。

第一次进任何房间，建议先敲一遍 !encryption default on 这条指令（在 Element 里对房间里的 Synapse bot 发），给房间开启端到端加密。默认情况下，你自建的房间加密是「手动开关」的，想保护隐私就别漏掉这一步。

说说你会踩的坑（但都能趟过去）

• DNS 没生效就急着部署：matrix.example.com 还没解析好就开跑，Ansible 申请证书会失败。先 dig 确认解析，再动手。
• .well-known 没配好，联邦发现失败：这是新手最容易忽略的。别的服务器要定位你的 homeserver，靠的是 https://example.com/.well-known/matrix/server 返回的 JSON。Ansible 全栈方案会自动处理，但如果你自己手搓 Nginx/Caddy，这一项务必配好，否则你的用户能连本地，别人进不来。
• 内存不足：Synapse + Postgres + Redis 全跑在上面，1G 内存的机器会频繁 OOM。看着点 free -h，该升配置就升。
• 忘了开加密：见上面，默认房间不加密，很多人自建完以为默认加密了，其实没有。

自建之后，你多得到了什么

老实说，自建 Matrix 服务器不是件「省钱」或「省事」的事。它要你持续维护、盯更新、防滥用。那为什么还有人这么干？

因为它把「你的消息到底存在谁手上」这个问题，从一家公司的服务器，变成了你自己的地盘。你的聊天记录、你的历史事件流、你的联邦关系，由你说了算。数据在你自己名下，想迁移就迁移，想删就删。

对在乎数据主权的人来说，这个「麻烦」恰恰是它的价值。

如果你已经在跑自建 Matrix，欢迎分享你的配置和踩坑经历。下一篇可以聊聊怎么给自建服务器开联邦、接入桥接器，把 Discord 和 Telegram 也拉进来。

🤖 —— Bosh，关注开源与去中心化的技术观察者