Gotify服务器:5分钟搭建私有实时消息推送系统
Gotify服务器:5分钟搭建私有实时消息推送系统
【免费下载链接】server A simple server for sending and receiving messages in real-time per WebSocket. (Includes a sleek web-ui) 项目地址: https://gitcode.com/gh_mirrors/serv/server
Gotify是一个开源的自托管消息推送服务器,通过WebSocket实现实时消息传递。它提供了REST API发送消息和精美的Web界面管理用户,是替代商业推送服务的理想选择。
📋 项目概览
Gotify服务器采用Go语言开发,包含现代化的Web用户界面,支持多平台部署。核心功能包括消息推送、用户管理、客户端管理和插件扩展,适用于家庭自动化、服务器监控、开发调试等多种场景。

🚀 快速上手
环境准备
确保系统中已安装Go语言环境(1.16+版本)和Git工具。
安装步骤
-
克隆项目
git clone https://gitcode.com/gh_mirrors/serv/server -
安装依赖
cd server go mod tidy -
构建项目
go build . -
配置运行
- 复制配置文件:
cp config.example.yml config.yml - 启动服务器:
./server
- 复制配置文件:
首次访问
默认情况下,Gotify会在80端口启动。打开浏览器访问 http://localhost,使用默认管理员账户登录:
- 用户名:
admin - 密码:
admin
⚙️ 核心功能详解
消息推送系统
Gotify的核心是消息推送功能,支持两种方式发送消息:
REST API推送
curl -X POST -H "X-Gotify-Key: your-app-token"
-d '{"message": "Hello Gotify!", "title": "测试消息"}'
http://localhost/message
WebSocket实时接收 客户端通过WebSocket连接实时接收推送消息,实现毫秒级延迟。
用户与权限管理
在用户管理界面中,可以:
- 添加新用户并设置权限
- 管理用户的应用和客户端
- 配置消息推送规则
应用管理
每个应用都有独立的Token,用于API身份验证:
- 创建应用时自动生成Token
- Token可在应用详情中查看和重置
- 支持应用级别的消息过滤
插件系统
Gotify支持插件扩展,在plugin/目录下提供丰富的插件示例:
- 时钟插件:
plugin/example/clock/ - 回显插件:
plugin/example/echo/ - 最小化插件:
plugin/example/minimal/
🔧 进阶技巧
配置文件优化
编辑config.yml文件进行个性化配置:
基础服务器配置
server:
port: 8080 # 自定义端口
listenaddr: "" # 绑定所有地址
数据库配置
database:
dialect: sqlite3
connection: data/gotify.db
安全加固建议
- 修改默认密码:首次登录后立即修改管理员密码
- 启用HTTPS:在生产环境中配置SSL证书
- 限制访问IP:通过防火墙规则限制服务器访问
性能调优
- 调整
keepaliveperiodseconds参数优化连接保持 - 配置
stream.pingperiodseconds优化WebSocket心跳
插件开发
参考plugin/example/目录下的示例,了解插件开发规范:
- 插件接口定义:
plugin/messagehandler.go - 管理器实现:
plugin/manager.go
监控与日志
- 启用数据库健康检查:
database/ping.go - 配置错误处理:
error/handler.go
💡 实用场景
服务器监控
接收服务器状态通知、备份完成提醒、异常登录警报等。
开发调试
在开发过程中实时推送调试信息、API调用结果等。
家庭自动化
与智能家居系统集成,接收设备状态变化和操作结果。
🎯 总结
Gotify服务器是一个功能完善、易于部署的私有消息推送解决方案。通过简单的安装步骤和直观的Web界面,用户可以快速搭建属于自己的实时消息系统。无论是个人使用还是团队协作,Gotify都能提供稳定可靠的消息推送服务。
通过灵活的配置和插件系统,Gotify可以适应各种不同的使用场景,是替代商业推送服务的优秀选择。
【免费下载链接】server A simple server for sending and receiving messages in real-time per WebSocket. (Includes a sleek web-ui) 项目地址: https://gitcode.com/gh_mirrors/serv/server








