Gotify私有消息推送平台部署与实战
1. Gotify是什么？为什么你需要它？
第一次听说Gotify时，我也和大多数人一样疑惑：已经有这么多成熟的推送服务，为什么还要折腾自建？直到我的团队因为第三方推送服务突然调整API导致业务中断，才真正体会到私有化推送平台的价值。
Gotify本质上是一个轻量级的实时消息推送服务器，采用Go语言编写。它最吸引我的特点是完全自托管——所有数据都留在你自己的服务器上，不像某些云服务会收集用户设备信息。我实测下来，单台2核4G的云服务器就能轻松支撑日均10万+的消息推送，这对于中小团队完全够用。
与商业推送服务相比，Gotify的核心优势在于：
- 零依赖：不需要注册开发者账号、不需要申请API密钥
- 协议透明：基于标准的WebSocket和REST API，没有黑箱逻辑
- 数据自主：消息历史、用户信息全部存储在本地数据库
- 成本可控：没有按推送量计费的模式，服务器成本固定
举个例子，我们团队用Gotify做的智能家居报警系统：当传感器检测到异常时，通过curl命令触发推送，Android设备秒级收到通知。整个过程完全走内网，既不用担心消息泄露，也不受外网服务波动影响。
2. 快速部署：Docker方案详解
2.1 基础环境准备
在开始前，请确保你的Linux服务器已经安装：
- Docker Engine 20.10+
- Docker Compose 2.0+
- 开放8385端口（或自定义端口）
我强烈建议使用固定版本而非latest标签。比如当前稳定版是2.2.2，可以避免后续版本升级带来的兼容性问题。这是我踩过的坑：有次自动更新到新版本导致客户端连接异常，回滚花了半天时间。
2.2 两种部署方式对比
方案A：直接运行容器
mkdir -p /opt/gotify/data docker run -d \ --name gotify \ -p 8385:80 \ -v /opt/gotify/data:/app/data \ -e GOTIFY_DEFAULTUSER_NAME=admin \ -e GOTIFY_DEFAULTUSER_PASS=yourpassword \ gotify/server:2.2.2方案B：使用docker-compose（推荐）
version: "3" services: gotify: image: gotify/server:2.2.2 container_name: gotify restart: unless-stopped ports: - "8385:80" environment: - GOTIFY_DEFAULTUSER_NAME=admin - GOTIFY_DEFAULTUSER_PASS=yourpassword volumes: - "./data:/app/data"两种方式我都长期使用过，最终选择了docker-compose方案。原因有三：
- 配置文件可版本化管理
- 环境变量更易维护
- 扩展性强（后续加Redis等组件更方便）
2.3 关键配置解析
这些环境变量值得特别关注：
GOTIFY_SERVER_SSL_ENABLED：启用HTTPS（需配合证书）GOTIFY_DATABASE_CONNECTION：自定义数据库连接GOTIFY_UPLOADEDIMAGESDIR：图片附件存储路径
部署完成后，访问http://服务器IP:8385，用预设的账号密码登录就能看到管理界面。如果遇到端口冲突，把8385改成其他未占用端口即可。
3. 消息推送实战指南
3.1 创建第一个应用
登录后点击"Apps"→"Create Application"，这里有个实用技巧：为不同业务创建独立应用。比如：
- 服务器监控用"Server-Alert"
- 代码部署用"CI-Notification"
- 个人提醒用"My-Reminder"
创建成功后，务必保存好Token。这个Token相当于API密钥，泄露会导致他人能冒充你的应用发消息。我就曾因为把Token提交到公开仓库，导致收到一堆垃圾消息。
3.2 发送消息的三种方式
方法1：CURL命令（最快测试）
curl "http://your-server:8385/message?token=APP_TOKEN" \ -F "title=紧急告警" \ -F "message=CPU使用率超过95%" \ -F "priority=8"方法2：Python脚本
import requests url = "http://your-server:8385/message" params = {"token": "APP_TOKEN"} data = { "title": "数据备份完成", "message": "数据库备份文件已生成", "priority": 5 } response = requests.post(url, params=params, data=data) print(response.status_code)方法3：通过Web界面管理后台的"Messages"标签页可以直接发送测试消息，适合非技术人员使用。
优先级参数(priority)范围是0-10，数字越大通知越强烈。在Android客户端上，优先级≥8的消息会触发全屏提醒。
3.3 消息格式进阶技巧
除了文本，还支持富媒体内容：
# 发送带图片的消息 curl "http://your-server:8385/message?token=APP_TOKEN" \ -F "title=现场照片" \ -F "message=最新拍摄的现场图" \ -F "priority=5" \ -F "file=@/path/to/photo.jpg"我们团队用这个功能传送监控截图，比单纯文字描述直观得多。不过要注意附件大小限制，默认是10MB，可以通过GOTIFY_UPLOADEDIMAGESDIR环境变量调整。
4. 客户端配置全攻略
4.1 Android客户端配置
官方客户端在GitHub和F-Droid都有发布。安装后按步骤配置：
- 服务器URL填
http://your-server:8385 - 关闭SSL验证（仅测试环境）
- 登录账号密码与Web端相同
实测发现几个实用功能：
- 消息分类：不同应用的消息自动分组
- 本地缓存：无网络时消息不会丢失
- 自定义通知：可为每个应用设置单独铃声
4.2 Web客户端集成
如果你想在自己的网页中接收推送，可以用以下代码：
const socket = new WebSocket(`ws://your-server:8385/stream?token=CLIENT_TOKEN`); socket.onmessage = (event) => { const msg = JSON.parse(event.data); console.log("收到新消息:", msg.title, msg.message); // 这里添加通知显示逻辑 };注意要替换CLIENT_TOKEN（在用户设置页面获取）。我在内部OA系统中集成这个功能后，审批提醒的打开率提升了60%。
4.3 反向代理配置
如果要通过域名访问，建议用Nginx做反向代理：
location / { proxy_pass http://localhost:8385; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; }特别提醒：WebSocket连接需要特殊配置，否则会出现连接立即断开的问题。这是我们调试了2小时才解决的坑。
5. 高阶应用场景
5.1 与自动化工具结合
通过Gotify+HomeAssistant实现智能家居提醒：
# HomeAssistant配置示例 automation: - alias: "门窗异常报警" trigger: - platform: state entity_id: binary_sensor.door_window to: "on" action: - service: rest_command.gotify_alert data: title: "安全告警" message: "{{ trigger.to_state.attributes.friendly_name }}被打开" rest_command: gotify_alert: url: "http://gotify-server:8385/message?token=APP_TOKEN" method: POST content_type: "multipart/form-data" payload: "title={{ title }}&message={{ message }}&priority=10"5.2 消息持久化方案
默认使用SQLite存储消息，对于高频使用场景建议改用MySQL：
environment: - GOTIFY_DATABASE_CONNECTION=user:password@tcp(mysql-server:3306)/gotify?charset=utf8mb4我们团队的日志监控系统每天产生约5万条消息，切换到MySQL后查询速度提升明显。记得定期清理旧消息，可以用内置的GOTIFY_MESSAGE_MESSAGES_DAYSOLD参数设置保留天数。
5.3 安全加固建议
- 启用HTTPS：避免敏感信息明文传输
- 定期轮换Token：每个季度更新一次应用Token
- 限制访问IP：通过防火墙规则只允许可信IP连接
- 开启基础认证：在Nginx层添加二次认证
有次我们的测试服务器被入侵，攻击者就是因为拦截到HTTP协议的消息内容。后来全切HTTPS后再没出现过类似问题。