昨天网友 sincoslong
提到了一个很好的建议：
docker
注册表版本别选择 latest
选择具体版本号。
有的新版本，数据库、 php
各种依赖，都升级。小白如果选择最近更新的版本，估计写个 blog
都是记录如何失败的。
虽然有的人也会看看你发布日期，看看当时什么版本。但是有的没有历史版本了。基本就不能照葫芦画瓢操作了。
老苏虚心接受，其实老苏之前也想过这个问题，写 latest
主要是图个方便省事。
从本文开始改正，对于建议前已完成的稿件，老苏会添加版本说明；对于建议之后开始撰写的稿件，直接选择具体的版本号，感谢 sincoslong
!
什么是 Gotify ？
Gotify
是一个简单的消息推送服务器，用于通过WebSocket
实时发送和接收消息。（包括一个时尚的网络用户界面）
老苏之前写过推送系统 ntfy.sh
，这两个都是使用 golang
开发的推送系统，老苏没有深入研究，直观感觉就是 Gotify
不需要像 ntfy.sh
去订阅 ，而且似乎也不支持 iOS
客户端
文章传送门：无需注册的通知服务ntfy
安装
在群晖上以 Docker 方式安装。
在注册表中搜索 gotify
，选择第一个 gotify/server
，版本选择 latest
。
本文写作时，
latest
版本对应为2.2.2
；
卷
在 docker
文件夹中，创建一个新文件夹 gotify
，并在其中建一个子文件夹 data
| 文件夹 | 装载路径 | 说明 |
|---|---|---|
docker/gotify/data | /app/data | 存放数据库等 |
端口
本地端口不冲突就行，不确定的话可以用命令查一下
# 查看端口占用
netstat -tunlp | grep 端口号复制
| 本地端口 | 容器端口 |
|---|---|
8385 | 80 |
环境
| 可变 | 值 |
|---|---|
GOTIFY_DEFAULTUSER_NAME | 后台管理员账号 |
GOTIFY_DEFAULTUSER_PASS | 后台管理员密码 |
更多的环境变量请看官方文档：https://gotify.net/docs/config#environment-variables
命令行安装
如果你熟悉命令行，可能用 docker cli
更快捷
# 新建文件夹 gotify 和 子目录
mkdir -p /volume2/docker/gotify/data
# 进入目录
cd /volume2/docker/gotify
# 运行容器
docker run -d \
--restart unless-stopped \
--name gotify \
-p 8385:80 \
-v $(pwd)/data:/app/data \
-e GOTIFY_DEFAULTUSER_NAME:laosu \
-e GOTIFY_DEFAULTUSER_PASS:7uZFj9Ctf4 \
gotify/server:2.2.2复制
也可以用 docker-compose
安装，将下面的内容保存为 docker-compose.yml
文件
version: "3"
services:
gotify:
image: gotify/server:2.2.2
container_name: gotify
restart: unless-stopped
ports:
- 8385:80
environment:
- GOTIFY_DEFAULTUSER_NAME=laosu
- GOTIFY_DEFAULTUSER_PASS=7uZFj9Ctf4
volumes:
- "./data:/app/data"复制
然后执行下面的命令
# 新建文件夹 gotify 和 子目录
mkdir -p /volume2/docker/gotify/data
# 进入目录
cd /volume2/docker/gotify
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d复制
运行
在浏览器中输入 http://群晖IP:8385
就能看到登录界面
用前面设置的 GOTIFY_DEFAULTUSER_NAME
和 GOTIFY_DEFAULTUSER_PASS
登录，成功后的主界面
如果你没设置，可以用默认的
admin/admin
推送消息
从右上方的 apps
--> Create Application
，创建一个应用
创建成功之后，点眼睛
按钮，可以看到 Token
的值，这个后面会用到
尝试发送一条消息，在 SSH
客户中直接执行下面的命令
# 格式
curl "https://yourdomain.com/message?token=<apptoken>" -F "title=my title" -F "message=my message" -F "priority=5"
# 示例
curl "http://192.168.0.197:8385/message?token=AdVPoP7WecontPA" -F "title=my title" -F "message=从web发送的消息" -F "priority=5"复制
回到网页
官方文档详细介绍及各个语言调用例子：https://gotify.net/docs/pushmsg
反向代理
如果要远程使用，需要做反代处理，还是以 npm
为例
老苏还是习惯全部勾选
除了上面的，还需要在 Advanced
中添加下面的代码，否则网页端会不能登录
location {
# We set up the reverse proxy
proxy_pass http://192.168.0.197:8385;
proxy_http_version 1.1;
# Ensuring it can use websockets
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto http;
proxy_redirect http:// $scheme://;
# The proxy must preserve the host because gotify verifies the host with the origin
# for WebSocket connections
proxy_set_header Host $http_host;
# These sets the timeout so that the websocket can stay alive
proxy_connect_timeout 1m;
proxy_send_timeout 1m;
proxy_read_timeout 1m;
}复制
现在你可以尝试用域名发消息了
# 域名示例
curl "https://mess.laosu.ml:444/message?token=AdVPoP7WecontPA" -F "title=my title" -F "message=从web域名发送的消息" -F "priority=5"复制
如果出现下面👇这样的问题
添加 -k
参数，用于忽略证书验证就可以了
# 域名示例（忽略证书验证)
curl -k "https://mess.laosu.ml:444/message?token=AdVPoP7WecontPA" -F "title=my title" -F "message=从web通过域名发送的消息" -F "priority=5"复制
想深入了解 SSL
证书验证，可以看：https://curl.se/docs/sslcerts.html
启用
https
协议后访问Web
后台 ，可以设置网页消息提醒
移动端
似乎只有 Android
客户端，可以在下面两个地址下载：
https://github.com/gotify/android/releases https://f-droid.org/zh_Hans/packages/com.github.gotify
包非常小，跟现在动则几百兆的应用形成了鲜明的对比
输入服务器地址，点 CHECK URL
，如果连接成功会显示服务端的版本，并需要登录
如果有问题，可以尝试在设置中勾选 Disble SSL Validation
设置完客户端名称后，就可以看到之前发送的消息了
Android
端还可以发送消息
参数是一样的
发送成功
回到网页
接口文档
Gotify
提供了完善的 REST-API
文档：https://gotify.github.io/api-docs
将 spec.json
导入 apifox
，可以测试收消息
也可以发
回到网页
参考文档
gotify/server: A simple server for sending and receiving messages in real-time per WebSocket. (Includes a sleek web-ui)
地址：https://github.com/gotify/serverGotify · a simple server for sending and receiving messages
地址：https://gotify.net/Installation · Gotify
地址：https://gotify.net/docs/install
@所有人：写文不易，如果你都看到了这里，请点个赞
和在看
，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。
