telota/mattermost-team-edition

Docker Mattermost（团队版）

本镜像提供Mattermost团队版聊天应用服务器的Docker镜像，适用于企业内部协作、项目团队沟通等场景，支持文件上传、实时消息等核心功能。

升级说明

自3.8版本起，Mattermost支持通过环境变量设置配置值，本镜像移除了原有的配置文件生成逻辑以提升可维护性。若您使用3.8版本前的镜像，需重新定义环境变量，请参考CHANGELOG.md获取关键变量信息。

快速开始

通过docker-compose快速部署：

1. 复制https://raw.githubusercontent.com/telota/docker-mattermost/master/docker-compose.yml%E6%96%87%E4%BB%B6%E5%B9%B6%E8%B0%83%E6%95%B4%E9%85%8D%E7%BD%AE%EF%BC%9B
2. 启动容器：

   bash
   docker-compose up
   

3. （可选）生成随机盐值（测试环境可跳过）：

   bash
   pwgen -s1 32
   

4. 访问http://localhost:8080创建管理员账户，即可开始使用。

配置说明

配置文件与环境变量

• 镜像包含默认配置文件，可通过挂载自定义文件到/opt/mattermost/mattermost/config替换；
• 推荐使用环境变量覆盖配置，参考官方文档了解变量命名及选项；
• 必须设置的唯一值配置项：MM_EMAILSETTINGS_INVITESALT、MM_EMAILSETTINGS_PASSWORDRESETSALT、MM_SQLSETTINGS_ATRESTENCRYPTKEY，以及MM_SERVICESETTINGS_SITEURL；
• 设置DEBUG=true可开启详细日志和调试模式。

文件资产存储

镜像定义卷/opt/mattermost/data用于存储文件上传、头像等资产。

数据库配置

支持MariaDB/MySQL或Postgres：

1. 自动发现：通过docker-compose配置数据库服务（如postgres/mysql），镜像自动探测并使用默认值，确保DB_PASS与数据库密码一致；
2. 数据源URL：通过MM_SQLSETTINGS_DATASOURCE和MM_SQLSETTINGS_DRIVERNAME直接定义连接；
3. 细粒度变量：可通过DB_HOST、DB_NAME、DB_PASS等变量组合生成数据源URL。

使用CLI工具

执行容器内CLI工具（如邀请用户）：

bash
docker exec -t <容器名/ID> platform user invite johndoe@example.com central_committee

构建镜像

本地构建镜像：

bash
make

参考链接

• 镜像源码仓库：https://github.com/telota/docker-mattermost
• Docker Hub仓库：https://hub.docker.com/r/telota/mattermost-team-edition/
• Mattermost官方文档：[***]