Docker-Gotify(消息通知)

[Gotify](https://gotify.net/) 简单的服务器来发送和接收消息(每个 WebSocket 都是实时的)

相关链接：
---
- 官网：https://gotify.net/
- Doc：https://gotify.net/docs/
- Server端：https://github.com/gotify/server
- Android-APP：https://github.com/gotify/android
- Cli：https://github.com/gotify/cli
- Nginx反向代理：https://gotify.net/docs/nginx
- 推送消息示例(基础)：https://gotify.net/docs/pushmsg
- 推送消息示例(各类语言)：https://gotify.net/docs/more-pushmsg

## Docker run
```bash
docker run -p 8080:80 -e TZ="Asia/Shanghai" -v $PWD:/app/data gotify/server
  # gotify/server-arm7 和 gotify/server-arm64  # ARM7(Raspberry Pi) 和 ARM-64
  # 也有GitHub源的镜像，ghcr.io/gotify/server
```
默认用户名/密码：admin

## docker-compose
```bash
mkdir data  # 创建所需文件夹
nano docker-compose.yml
docker-compose up -d
```
`docker-compose.yml`
```yaml
services:
  gotify:
    image: gotify/server  # gotify/server-arm7、gotify/server-arm64
    ports:
      - 8080:80  # 对外开放端口
    environment:
      TZ: Asia/Shanghai   # 时区
      # ###################### 用户配置 ######################
      GOTIFY_DEFAULTUSER_NAME: admin  # 默认用户名
      GOTIFY_DEFAULTUSER_PASS: admin   # 默认用户密码
      # GOTIFY_REGISTRATION: true  # 启用注册
      # GOTIFY_PASSSTRENGTH: 10  # 密码强度
      # ############################ 服务器配置 ############################
      # GOTIFY_SERVER_LISTENADDR:  # 服务器监听地址
      # GOTIFY_SERVER_PORT: 80   # 监听端口
      # GOTIFY_SERVER_KEEPALIVEPERIODSECONDS: 0  # 服务器保持活动周期秒(0为禁用)
      # GOTIFY_SERVER_TRUSTEDPROXIES=[127.0.0.1,192.168.178.2/24]  # 信任的代理
      # ############################ SSL ############################
      # GOTIFY_SERVER_SSL_ENABLED: false  # 启用SSL
      # GOTIFY_SERVER_SSL_REDIRECTTOHTTPS: true  # 启用SSL时重定向到HTTPS
      # GOTIFY_SERVER_SSL_LISTENADDR:   # 服务器SSL监听地址
      # GOTIFY_SERVER_SSL_PORT: 443  # SSL端口
      # GOTIFY_SERVER_SSL_CERTFILE:  # SSL证书文件
      # GOTIFY_SERVER_SSL_CERTKEY:  # SSL密钥文件
      # ############################ Let's Encrypt ############################
      # GOTIFY_SERVER_SSL_LETSENCRYPT_ENABLED: false  # 启用Let's Encrypt
      # GOTIFY_SERVER_SSL_LETSENCRYPT_ACCEPTTOS: false  # 接受Let's Encrypt的条款
      # GOTIFY_SERVER_SSL_LETSENCRYPT_CACHE: certs  # Let's Encrypt缓存目录
      # GOTIFY_SERVER_SSL_LETSENCRYPT_HOSTS: [mydomain.tld, myotherdomain.tld]  # Let's Encrypt主机
      # ############################ 安全设置 ############################
      # GOTIFY_SERVER_RESPONSEHEADERS: {X-Custom-Header: "custom value", x-other: value}  # 自定义响应头
      # GOTIFY_SERVER_CORS_ALLOWORIGINS: [.+\.example\.com, otherdomain\.com]  # 跨域允许的源
      # GOTIFY_SERVER_CORS_ALLOWMETHODS: [GET, POST]  # 跨域允许的方法
      # GOTIFY_SERVER_CORS_ALLOWHEADERS: [X-Gotify-Key, Authorization]  # 跨域允许的头部
      # GOTIFY_SERVER_STREAM_ALLOWEDORIGINS: [.+.example\.com, otherdomain\.com]  # 流式传输允许的源
      # GOTIFY_SERVER_STREAM_PINGPERIODSECONDS: 45  # 流式传输ping周期秒
      # ############################ 数据库设置 ############################
      # GOTIFY_DATABASE_DIALECT: sqlite3  # 数据库类型
      # GOTIFY_DATABASE_CONNECTION: data/gotify.db  # 数据库连接字符串
      # GOTIFY_UPLOADEDIMAGESDIR: data/images  # 上传的图片存储路径
      # GOTIFY_PLUGINSDIR: data/plugins  # 插件存储路径
    volumes:
      - "./data:/app/data"  # 挂载本地路径
    restart: always  # 始终重启
```

## [消息推送](https://gotify.net/docs/pushmsg)
Gotify 消息推送是基于应用来进行推送的，每个用户可以有多个应用程序(只能一对一推送,群发要挨个推)
1. 创建应用程序并获取令牌
Web访问，登录账号，APPS 创建应用(Priority 为默认优先级,0~10越高越优先)，获取 Token
>s 也可使用命令来创建应用并获取Token：
> `curl -u {用户名}:{密码} http(s)://{服务器地址}/application -F "name={应用的名称}" -F "description={应用描述}"`
2. 使用 [Android 应用](https://github.com/gotify/android) 的需要设置服务器并登录账号
最好还要开启通知和后台运行，这样才能第一时间收到消息
>s 汉化APP：`...\共享盘\服务器\Gotify(消息通知)\`
3. [消息推送](https://gotify.net/docs/more-pushmsg)
任何可以发送 POST 请求的设备都可发送，只有 `message(内容)`为必须的，其它参数可以不设置(token肯定也是需要的)
```bash
# 多种方式：
curl "https://push.example.de/message?token=<apptoken>" -F "title=my title" -F "message=my message" -F "priority=5"
http -f POST "https://push.example.de/message?token=<apptoken>" title="my title" message="my message" priority="5"
# http://blynk.space:8888/message?token=AuXAjS309sU36xS&message=你好  # POST
```

## [Nginx 反向代理](https://gotify.net/docs/nginx)
注意，使用Nginx反代在部署时 `不可启用SSL`，并且APP连接时要 `禁用SSL验证`
APP验证时会拿网站与安卓内部证书进行验证，自颁布证书安卓中没有(也可以手动添加证书)，所以需要禁用验证
```bash
upstream gotify {
  server 127.0.0.1:8080;  # gotify 服务器的地址和端口
}

server {
  listen 80;  # HTTP 端口
  server_name push.example.com;  # 你的域名

location / {  # 匹配所有请求(主路径)，也可设置为 /gotify/ 以匹配子路径
    proxy_pass http://gotify;  # 将请求转发到 gotify 服务器
    # rewrite ^/gotify(/.*) $1 break; # 确保 URL 保持不变(子路径需要)
    proxy_http_version 1.1;  # 确保使用 HTTP/1.1

# 确保可以使用 websocket
    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://;

# 代理必须保留主机，因为gotify会验证主机与来源
    # 用于 WebSocket 连接
    proxy_set_header   Host $http_host;

# 这些设置超时，以便 websocket 可以保持活动状态
    proxy_connect_timeout   1m;
    proxy_send_timeout      1m;
    proxy_read_timeout      1m;
  }
}
```

## 高级功能
```yaml
{
  "extras": {
    # text/plain 纯文本;text/markdown Markdown (Web/Android支持)
    # Markdown "要改成\"，换行改为\n，\改为\\
    "client::display": {
      "contentType": "text/markdown"
    },
    # 在单击通知时打开 URL (Android支持)
    "client::notification": {
      "click": { "url": "https://gotify.net" }
    },
    # 在通知中显示大图像(不启用则在通知栏不显示图片) (Android支持)
    "client::notification": {
      "bigImageUrl": "https://placekitten.com/400/300"
    },
    # APP提示打开意向 URL (Android支持)
    "android::action": {
      "onReceive": { "intentUrl": "https://gotify.net" }
    }
  }
}
```