1. 为什么你需要自建消息推送系统每天我们都被各种消息轰炸——微信、短信、邮件、APP推送...但真正重要的信息往往被淹没在垃圾通知里。更糟的是当你需要接收服务器报警、自动化脚本执行结果这类关键信息时依赖第三方服务总让人提心吊胆服务突然下线怎么办推送延迟导致故障响应不及时怎么办这就是为什么越来越多的开发者和运维开始搭建私有化消息中枢。Gotify就像是你家的私人邮差只为你服务。它完全开源且轻量用Docker部署只要5分钟不依赖任何第三方推送服务。我自己用Gotify接入了十几台服务器的监控告警再也不用担心错过重要通知。最棒的是所有数据都掌握在自己手里既不用看广告也不用担心隐私泄露。2. 5分钟快速部署Gotify服务端2.1 环境准备你需要一台Linux服务器1核1G配置就够用安装好Docker和docker-compose。如果还没安装用这个命令一键搞定curl -fsSL https://get.docker.com | sh systemctl enable --now docker pip install docker-compose建议专门创建一个目录存放配置避免文件散落各处。我习惯把所有自建服务都放在/data目录下mkdir -p /data/gotify cd /data/gotify2.2 编写docker-compose配置用vim创建docker-compose.yaml文件这个配置是我经过多次优化后的版本version: 3 services: gotify: image: gotify/server container_name: gotify restart: unless-stopped ports: - 10080:80 # 把10080改成你想要的端口 environment: - GOTIFY_DEFAULTUSER_NAMEadmin - GOTIFY_DEFAULTUSER_PASSYourStrongPassword123! volumes: - ./data:/app/data几个关键点说明restart: unless-stopped保证服务崩溃后自动重启端口建议不要用80避免冲突密码一定要改我就吃过亏用了弱密码被扫描到2.3 启动服务一行命令搞定部署docker-compose up -d用这个命令查看日志确认服务正常启动docker logs -f gotify看到类似这样的输出就成功了[GIN] 2023/08/20 - 10:00:00 | 200 | 188.427µs | 172.17.0.1 | GET /version3. 安全配置与Web管理3.1 首次登录配置浏览器访问http://你的服务器IP:端口用刚才设置的admin账号登录。首次登录建议立即在右上角用户菜单修改默认密码进入Users页面创建普通用户不要用admin日常操作在Apps页面创建你的第一个应用重要提示如果服务需要暴露在公网务必配置HTTPS可以用Nginx反向代理加上Lets Encrypt证书。3.2 应用Token管理每个应用都有唯一的Token相当于推送密钥。点击应用卡片右上角的i图标就能看到。这里有个实用技巧# 把Token存入环境变量方便使用 export GOTIFY_TOKENAzBlIAbqugCKca-我建议为不同用途创建独立应用比如服务器监控CI/CD通知自动化脚本家庭IoT设备4. Android客户端完美适配4.1 安装与配置从GitHub下载最新APK官方没上架应用商店wget https://github.com/gotify/android/releases/download/v2.7.1/Gotify.apk安装后打开APP配置项填写Server URL: http://你的服务器IP:端口登录账号密码实测发现如果服务器在内网手机需要连接同一网络外网访问需要配置端口转发。4.2 消息分类技巧在服务端创建应用时可以设置不同优先级1-10。我在客户端设置了优先级≥8振动响铃用于紧急告警优先级5-7仅通知栏显示普通通知优先级≤4静默接收日志类信息5. 实战从命令行发送推送5.1 基础推送示例用curl测试推送功能curl http://localhost:10080/message?token$GOTIFY_TOKEN \ -F title服务器告警 \ -F messageCPU负载超过90% \ -F priority85.2 进阶脚本集成这是我的监控脚本片段当检测到异常时触发推送#!/bin/bash ALERT_MSG$(df -h | awk $5 90 {print $6 使用率 $5}) if [ -n $ALERT_MSG ]; then curl -sS http://localhost:10080/message?token$GOTIFY_TOKEN \ -F title磁盘空间告警 \ -F message$ALERT_MSG \ -F priority9 fi6. 高级功能与优化技巧6.1 WebSocket实时订阅除了REST APIGotify还支持WebSocket实时接收消息。这是我用Python写的订阅脚本import websocket def on_message(ws, message): print(收到新消息:, message) ws websocket.WebSocketApp(ws://localhost:10080/stream?tokenYOUR_TOKEN, on_messageon_message) ws.run_forever()6.2 数据库备份策略虽然Gotify消息默认存储在SQLite但建议定期备份# 每天凌晨备份 0 3 * * * docker exec gotify /bin/sh -c sqlite3 /app/data/gotify.db .backup /app/data/backup.db6.3 性能调优当消息量较大时可以调整这些参数修改docker-compose.yml添加环境变量environment: - GOTIFY_DATABASE_CONNECTIONMAXIDLE5 - GOTIFY_DATABASE_CONNECTIONMAXOPEN20对Nginx反向代理启用gzip压缩7. 常见问题排坑指南消息发送失败怎么办检查Token是否正确我曾经复制错Token折腾半小时确认服务端防火墙开放了端口查看docker日志docker logs gotifyAndroid客户端收不到推送检查手机是否关闭了电池优化测试服务端直接访问是否正常尝试用4G网络排除WiFi问题如何迁移到新服务器备份整个/data/gotify目录在新服务器相同路径恢复重新运行docker-compose up -d现在我的所有服务器监控、家庭自动化设备、甚至快递物流提醒都接入了Gotify。每天早上醒来手机通知栏里只有真正需要我关注的信息这种清爽的感觉你值得拥有。如果遇到任何问题欢迎在评论区交流——毕竟我踩过的坑没必要让你再踩一次。
从零构建你的专属消息中枢：基于Gotify的轻量级推送系统搭建指南
1. 为什么你需要自建消息推送系统每天我们都被各种消息轰炸——微信、短信、邮件、APP推送...但真正重要的信息往往被淹没在垃圾通知里。更糟的是当你需要接收服务器报警、自动化脚本执行结果这类关键信息时依赖第三方服务总让人提心吊胆服务突然下线怎么办推送延迟导致故障响应不及时怎么办这就是为什么越来越多的开发者和运维开始搭建私有化消息中枢。Gotify就像是你家的私人邮差只为你服务。它完全开源且轻量用Docker部署只要5分钟不依赖任何第三方推送服务。我自己用Gotify接入了十几台服务器的监控告警再也不用担心错过重要通知。最棒的是所有数据都掌握在自己手里既不用看广告也不用担心隐私泄露。2. 5分钟快速部署Gotify服务端2.1 环境准备你需要一台Linux服务器1核1G配置就够用安装好Docker和docker-compose。如果还没安装用这个命令一键搞定curl -fsSL https://get.docker.com | sh systemctl enable --now docker pip install docker-compose建议专门创建一个目录存放配置避免文件散落各处。我习惯把所有自建服务都放在/data目录下mkdir -p /data/gotify cd /data/gotify2.2 编写docker-compose配置用vim创建docker-compose.yaml文件这个配置是我经过多次优化后的版本version: 3 services: gotify: image: gotify/server container_name: gotify restart: unless-stopped ports: - 10080:80 # 把10080改成你想要的端口 environment: - GOTIFY_DEFAULTUSER_NAMEadmin - GOTIFY_DEFAULTUSER_PASSYourStrongPassword123! volumes: - ./data:/app/data几个关键点说明restart: unless-stopped保证服务崩溃后自动重启端口建议不要用80避免冲突密码一定要改我就吃过亏用了弱密码被扫描到2.3 启动服务一行命令搞定部署docker-compose up -d用这个命令查看日志确认服务正常启动docker logs -f gotify看到类似这样的输出就成功了[GIN] 2023/08/20 - 10:00:00 | 200 | 188.427µs | 172.17.0.1 | GET /version3. 安全配置与Web管理3.1 首次登录配置浏览器访问http://你的服务器IP:端口用刚才设置的admin账号登录。首次登录建议立即在右上角用户菜单修改默认密码进入Users页面创建普通用户不要用admin日常操作在Apps页面创建你的第一个应用重要提示如果服务需要暴露在公网务必配置HTTPS可以用Nginx反向代理加上Lets Encrypt证书。3.2 应用Token管理每个应用都有唯一的Token相当于推送密钥。点击应用卡片右上角的i图标就能看到。这里有个实用技巧# 把Token存入环境变量方便使用 export GOTIFY_TOKENAzBlIAbqugCKca-我建议为不同用途创建独立应用比如服务器监控CI/CD通知自动化脚本家庭IoT设备4. Android客户端完美适配4.1 安装与配置从GitHub下载最新APK官方没上架应用商店wget https://github.com/gotify/android/releases/download/v2.7.1/Gotify.apk安装后打开APP配置项填写Server URL: http://你的服务器IP:端口登录账号密码实测发现如果服务器在内网手机需要连接同一网络外网访问需要配置端口转发。4.2 消息分类技巧在服务端创建应用时可以设置不同优先级1-10。我在客户端设置了优先级≥8振动响铃用于紧急告警优先级5-7仅通知栏显示普通通知优先级≤4静默接收日志类信息5. 实战从命令行发送推送5.1 基础推送示例用curl测试推送功能curl http://localhost:10080/message?token$GOTIFY_TOKEN \ -F title服务器告警 \ -F messageCPU负载超过90% \ -F priority85.2 进阶脚本集成这是我的监控脚本片段当检测到异常时触发推送#!/bin/bash ALERT_MSG$(df -h | awk $5 90 {print $6 使用率 $5}) if [ -n $ALERT_MSG ]; then curl -sS http://localhost:10080/message?token$GOTIFY_TOKEN \ -F title磁盘空间告警 \ -F message$ALERT_MSG \ -F priority9 fi6. 高级功能与优化技巧6.1 WebSocket实时订阅除了REST APIGotify还支持WebSocket实时接收消息。这是我用Python写的订阅脚本import websocket def on_message(ws, message): print(收到新消息:, message) ws websocket.WebSocketApp(ws://localhost:10080/stream?tokenYOUR_TOKEN, on_messageon_message) ws.run_forever()6.2 数据库备份策略虽然Gotify消息默认存储在SQLite但建议定期备份# 每天凌晨备份 0 3 * * * docker exec gotify /bin/sh -c sqlite3 /app/data/gotify.db .backup /app/data/backup.db6.3 性能调优当消息量较大时可以调整这些参数修改docker-compose.yml添加环境变量environment: - GOTIFY_DATABASE_CONNECTIONMAXIDLE5 - GOTIFY_DATABASE_CONNECTIONMAXOPEN20对Nginx反向代理启用gzip压缩7. 常见问题排坑指南消息发送失败怎么办检查Token是否正确我曾经复制错Token折腾半小时确认服务端防火墙开放了端口查看docker日志docker logs gotifyAndroid客户端收不到推送检查手机是否关闭了电池优化测试服务端直接访问是否正常尝试用4G网络排除WiFi问题如何迁移到新服务器备份整个/data/gotify目录在新服务器相同路径恢复重新运行docker-compose up -d现在我的所有服务器监控、家庭自动化设备、甚至快递物流提醒都接入了Gotify。每天早上醒来手机通知栏里只有真正需要我关注的信息这种清爽的感觉你值得拥有。如果遇到任何问题欢迎在评论区交流——毕竟我踩过的坑没必要让你再踩一次。
