matrixdotorg/dendrite-monolith

Dendrite 单体部署镜像

镜像概述和主要用途

这些是Dendrite单体部署的Docker镜像，将所有Dendrite组件整合在单个进程中运行。主要用于简化Dendrite的部署架构，适合不需要分布式组件分离、希望减少配置复杂度的场景，通过单体进程简化维护和资源管理。

核心功能和特性

• 单体集成架构：所有Dendrite组件（如客户端API、联邦API、房间服务器等）集成在单个进程中，减少跨组件通信开销
• 简化部署流程：提供预配置的示例docker-compose文件，降低环境搭建难度
• 标准化配置管理：通过卷挂载统一管理配置文件和密钥，确保部署一致性

使用场景和适用范围

适用于对部署复杂度敏感的场景，如：

• 小型Matrix服务器实例
• 开发/测试环境
• 资源受限或追求简单架构的生产环境
• 不需要横向扩展的个人或小型组织使用

详细使用方法和配置说明

示例 Compose 文件

Dendrite仓库的https://github.com/matrix-org/dendrite/tree/master/build/docker%E4%B8%AD%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BB%A5%E4%B8%8B%E7%A4%BA%E4%BE%8B%60docker-compose%60%E6%96%87%E4%BB%B6%EF%BC%9A

• docker-compose.deps.yml：运行Postgres（可选Kafka）等依赖服务
• docker-compose.monolith.yml：运行Dendrite单体部署实例

配置要求

docker-compose文件引用容器内的/etc/dendrite卷作为运行时配置目录，挂载的本地文件夹必须包含以下文件：

• dendrite.yaml：配置文件（基于Dendrite仓库https://github.com/matrix-org/dendrite%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E7%9A%84%E7%A4%BA%E4%BE%8B%60dendrite-config.yaml%60%EF%BC%89
• matrix_key.pem：服务器密钥，通过generate-keys工具生成
• server.crt：TLS证书文件
• server.key：TLS证书对应的私钥文件

生成密钥和证书

使用以下命令生成所需的服务器密钥和TLS证书：

bash
go run github.com/matrix-org/dendrite/cmd/generate-keys \
  --private-key=matrix_key.pem \  # 生成服务器私钥文件
  --tls-cert=server.crt \          # 生成TLS证书文件
  --tls-key=server.key             # 生成TLS私钥文件

生成的文件需放置在挂载到容器/etc/dendrite卷的本地目录中，确保容器启动时可访问。