使用 Ansible 和 Docker 搭建 Matrix（一个用于安全、去中心化通信的开放网络）服务器

目的

这个 Ansible playbook 旨在帮助您运行自己的 Matrix 家庭服务器，以及与之相关的各种服务。

也就是说，它允许您使用自己的 @<用户名>:<您的域名> 标识符加入 Matrix 网络，所有服务都托管在您自己的服务器上（参见前提条件）。

我们在 Docker 容器中运行所有服务（参见我们使用的容器镜像），这让我们能够在多个支持的发行版（参见前提条件）和架构（推荐 x86/amd64）上拥有可预测且最新的设置。

使用 Ansible 自动化安装（升级）和一些维护任务（参见我们的 Ansible 指南）。

自托管或托管服务 / SaaS

这个 Ansible playbook 试图使自托管和维护 Matrix 服务器变得相当容易。尽管如此，顺利运行任何服务仍然需要知识、时间和精力。

如果您喜欢这个 Ansible playbook 的 FOSS 精神，但更愿意将责任交给其他人，您也可以从 etke.cc 获得托管的 Matrix 服务器（托管和本地部署） - 这是一个基于这个 Ansible playbook 构建的服务，但具有额外组件和服务，它们都可以帮助您轻松运行 Matrix 服务器。请注意，etke.cc 采用基于订阅的方式运营，没有"只设置一次服务器就完事"的选项。

支持的服务

使用这个 playbook，您可以在服务器上配置以下服务列表。基本上，这个 playbook 旨在让您无需做任何其他事情就能启动并运行 Matrix 所需的所有必要组件。

注意：以下列表是详尽的。它包括一些可选或甚至高级组件，您很可能不需要这些组件。 坚持使用默认设置（安装上述组件的子集）是最佳选择，尤其是对于新安装。 您以后随时可以重新运行 playbook 来添加或删除组件。

家庭服务器

家庭服务器是您的 Matrix 系统的骨干。从以下列表中选择一个。

客户端

您可以在自己的域名上托管的 Matrix 网页客户端。

服务器组件

在服务器上运行以使安装的各个部分正常工作的服务。

身份验证

扩展和修改用户在您的家庭服务器上的身份验证方式。

文件存储

使用替代文件存储来代替默认的 media_store 文件夹。

桥接器

桥接器可用于将您的 Matrix 安装与第三方通信网络连接。

机器人

机器人为您的安装提供各种额外功能。

管理

帮助您管理和监控Matrix安装的服务。

其他

不属于任何其他类别的各种服务。

安装

要在您自己的服务器上配置和安装Matrix，请参阅docs/目录中的README。

更改

该剧本随时间不断发展，有时会有不向后兼容的变更。

更新剧本时，请参阅更新日志了解新内容。

支持

• Matrix房间：#matrix-docker-ansible-deploy:devture.com

• IRC频道：Libera Chat IRC网络（irc.libera.chat:6697）上的#matrix-docker-ansible-deploy

• GitHub问题：spantaleev/matrix-docker-ansible-deploy/issues

相关

您可能还对mash-playbook感兴趣 - 另一个用于自托管非Matrix服务的Ansible剧本（查看其支持的服务列表）。

mash-playbook还使用Traefik作为反向代理，通过进行一些小的互操作性调整，您可以使matrix-docker-ansible-deploy和mash-playbook共存，在同一服务器上托管Matrix和非Matrix服务。