turt2live/matrix-media-repo

matrix-media-repo

MMR是一个高度可配置的Matrix多服务器媒体仓库。它是家庭服务器设置的可选组件，仅推荐用于大型独立服务器或托管多个服务器的提供商。

如果您正在寻找S3连接器，请考虑使用https://github.com/matrix-org/synapse-s3-storage-provider%E3%80%82

较小的家庭服务器也可以设置此仓库，但可能会发现部署或使用困难。使用此仓库需具备Matrix家庭服务器栈的高级知识。

文档和支持

Matrix房间：#media-repo:t2bot.io

文档：docs.t2bot.io

开发者

MMR在开发环境中运行前至少需要编译一次。继续之前，请参阅编译步骤。

该项目提供了一个开发环境，您可以用于测试客户端和家庭服务器。

首次设置时，运行：

bash
docker run --rm -it -v ./dev/synapse-db:/data -e SYNAPSE_SERVER_NAME=localhost -e SYNAPSE_REPORT_STATS=no matrixdotorg/synapse:latest generate

然后您可以运行docker compose -f dev/docker-compose.yaml up以启动服务。家庭服务器将位于nginx反向代理之后，该代理将媒体请求路由到http://host.docker.internal:8001。为准确测试，建议将以下家庭服务器配置添加到媒体仓库配置中：

yaml
name: "localhost"
csApi: "http://localhost:8008" # 由nginx容器暴露

此设置下，联合媒体请求应正常工作，但家庭服务器本身无法联合。为方便起见，element-web实例也托管在同一端口的根目录下。

docker栈还创建了一个postgresql服务器以便使用。要使用它，请将以下内容添加到配置中：

yaml
database:
  postgres: "postgres://postgres:test1234@127.0.0.1:5432/postgres?sslmode=disable"
  pool:
    maxConnections: 10
    maxIdleConnections: 10

请注意，postgresql镜像不安全，不推荐用于生产环境。它也不遵循数据库管理的最佳实践 - 风险自负。

注意：运行Go测试需要Docker，并且可能会用大量层污染您的缓存镜像。建议不时手动清理这些镜像，或依赖临时构建系统。