matrix-construct/tuwunel

这是什么？

核心功能

• 01基本完整实现 Matrix 规范，适配大多数使用场景。
• 02使用 RocksDB 存储数据，可原地迁移 Conduit 和 conduwuit 的数据库。
• 03通过单个 TOML 配置文件进行设置，支持配置注册令牌。
• 04首个注册的账号自动成为服务器管理员。
• 05提供 Docker 镜像、静态二进制文件以及 Deb、RPM、Nix 等安装包。

适用场景

• 为家庭、团队或社区搭建私有 Matrix 聊天服务器。
• 在支持迁移的前提下，将 Synapse 替换为更轻量的 Rust 主服务器。
• 为 Matrix 客户端、桥接服务和机器人提供主服务器支持。
• 在 Debian、Ubuntu、Fedora 或 NixOS 上部署自建 Matrix 服务。

快速上手

1. 1

   拉取官方 Docker 镜像

   docker pull jevolk/tuwunel:latest
2. 2

   或克隆源代码

   git clone https://github.com/matrix-construct/tuwunel.git
3. 3

   复制并编辑 tuwunel-example.toml，设置 server_name 和 database_path

4. 4

   启动服务器，连接客户端并注册；第一个注册的用户成为管理员

使用前须知

• !目前尚不支持从 Synapse 迁移。
• !服务器名 server_name 设置后无法更改，请谨慎选择。

收录于专题

标签

常见问题

tuwunel 是什么？

用 Rust 编写的 Matrix 主服务器，可替代 Synapse，是 conduwuit 的官方后继项目。 Tuwunel 是完全用 Rust 编写的 Matrix 主服务器，可与现有的 Matrix 客户端、桥接和机器人协同工作，目标是除少数小众场景外完整实现 Matrix 规范。它定位为 Synapse 的替代方案，适合希望自建聊天服务器的用户。

tuwunel 可以免费使用吗？用的什么许可证？

tuwunel 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

tuwunel 还在维护吗？

活跃维护中。tuwunel 最近一次提交是在 2026年11月6日。

tuwunel 适合用来做什么？

为家庭、团队或社区搭建私有 Matrix 聊天服务器。 在支持迁移的前提下，将 Synapse 替换为更轻量的 Rust 主服务器。 为 Matrix 客户端、桥接服务和机器人提供主服务器支持。 在 Debian、Ubuntu、Fedora 或 NixOS 上部署自建 Matrix 服务。

tuwunel 怎么安装和运行？

拉取官方 Docker 镜像: docker pull jevolk/tuwunel:latest 或克隆源代码: git clone https://github.com/matrix-construct/tuwunel.git 复制并编辑 tuwunel-example.toml，设置 server_name 和 database_path 启动服务器，连接客户端并注册；第一个注册的用户成为管理员

在哪里获取 tuwunel？

源代码和安装说明在 GitHub 上：https://github.com/matrix-construct/tuwunel