mattermost/mattermost-push-proxy

Mattermost Push Proxy

镜像概述

Mattermost Push Proxy是Mattermost官方提供的推送代理服务，作为Mattermost服务器与移动推送服务（如Apple Push Notification service (APNs)、Firebase Cloud Messaging (FCM)）之间的中间层，负责接收Mattermost服务器发送的通知请求，并转发至相应的移动推送平台，最终确保iOS和Android设备用户及时接收消息通知。

核心功能与特性

• 跨平台推送支持：同时兼容iOS（通过APNs）和Android（通过FCM）设备，满足不同移动平台的推送需求。
• 与Mattermost深度集成：无缝对接Mattermost服务器，支持标准的通知协议，无需额外开发即可快速集成。
• 通知转发与管理：处理通知的接收、验证和转发流程，支持通知重试机制（如网络异常时），保障推送可靠性。
• 安全通信：支持通过TLS加密与推送服务通信，可配置证书和密钥认证，确保通知传输过程的安全性。
• 轻量级设计：服务架构精简，资源占用低，支持水平扩展以应对高并发通知场景。

使用场景与适用范围

• Mattermost移动推送部署：企业或团队在部署Mattermost协作平台时，若需为移动用户提供消息推送功能，需部署此服务。
• 私有网络环境：在无法直接访问公共推送服务的内网环境中，作为代理节点转发通知请求。
• 定制化推送需求：需要对推送通知进行中间处理（如过滤、日志记录）的场景，可基于此服务扩展功能。

使用方法与配置说明

前提条件

• 已部署Mattermost服务器（版本需与Push Proxy兼容，建议参考官方兼容性文档）。
• 已获取APNs证书（iOS推送，.p12或.pem格式）和/或FCM服务器密钥（Android推送）。
• 安装Docker Engine（1.13+）或Docker Desktop。

基本部署（Docker Run）

1. 准备配置文件

创建config.json配置文件，示例如下（根据实际需求调整）：

json
{
  "ListenAddress": ":8066",
  "ApplePushSettings": {
    "Type": "apns",
    "ApplePushCertPath": "/config/certs/apns-cert.pem",
    "ApplePushKeyPath": "/config/certs/apns-key.pem",
    "ApplePushTopic": "com.mattermost.Mattermost",
    "ApplePushEnvironment": "production",
    "ApplePushUseDevelopment": false
  },
  "AndroidPushSettings": {
    "Type": "fcm",
    "AndroidAPIKey": "your-fcm-server-key",
    "AndroidEndpoint": "https://fcm.googleapis.com/fcm/send"
  },
  "MattermostSettings": {
    "MattermostSiteURL": "https://your-mattermost-url.com",
    "AllowedUntrustedInternalConnections": "mattermost-server:8065"
  },
  "LogSettings": {
    "EnableConsole": true,
    "ConsoleLevel": "info"
  }
}

2. 启动容器

通过docker run命令启动服务，挂载配置文件和证书目录：

bash
docker run -d \
  --name mattermost-push-proxy \
  -p 8066:8066 \
  -v $(pwd)/config.json:/config/config.json \
  -v $(pwd)/certs:/config/certs \  # 挂载包含APNs证书的目录
  --restart unless-stopped \
  mattermost/push-proxy

Docker Compose部署

创建docker-compose.yml文件，简化部署流程：

yaml
version: '3'
services:
  push-proxy:
    image: mattermost/push-proxy
    container_name: mattermost-push-proxy
    ports:
      - "8066:8066"
    volumes:
      - ./config.json:/config/config.json
      - ./certs:/config/certs  # 本地证书目录，包含APNs证书和密钥
    environment:
      - TZ=UTC  # 设置时区
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

关键配置参数说明

与Mattermost服务器集成

1. 登录Mattermost服务器管理界面，进入系统控制台 > 环境 > 推送通知。
2. 设置推送通知服务器类型为local。
3. 配置推送通知服务器URL为Push Proxy的访问地址（如http://push-proxy:8066，容器间通信可使用服务名）。
4. 保存配置并重启Mattermost服务器。

注意事项

• 证书管理：APNs证书需定期更新（通常有效期1年），FCM密钥需妥善保管，避免泄露。
• 网络连通性：确保Push Proxy容器可访问互联网（以连接APNs/FCM），同时Mattermost服务器可访问Push Proxy的8066端口。
• 日志排查：建议配置日志输出至文件或日志系统（如ELK），通过日志排查推送失败问题（日志路径可在config.json的LogSettings中配置）。
• 版本兼容性：需确保Push Proxy版本与Mattermost服务器版本匹配，具体参考官方版本矩阵。