NAS 与运维

Gotify:私有通知服务器与 Android 接收端

  • 0 次阅读
  • 0 条评论
文章摘要

Gotify 为应用提供推送接口,并通过网页或 Android 客户端接收通知。应用发送 Token 与客户端登录凭据用途不同,应分别管理。 应用通过独立 Token 发送消息,客户端通过会话实时接收。按应用分开凭据,便于定位来源和撤销某个任务权限。 适合 Android 与网页接收 NAS 通知。手机客户端的后台限制会影响及时性,需要单独验证。

项目介绍

Gotify 为应用提供推送接口,并通过网页或 Android 客户端接收通知。应用发送 Token 与客户端登录凭据用途不同,应分别管理。

应用通过独立 Token 发送消息,客户端通过会话实时接收。按应用分开凭据,便于定位来源和撤销某个任务权限。

适合 Android 与网页接收 NAS 通知。手机客户端的后台限制会影响及时性,需要单独验证。

核心功能

功能 作用与使用方式
应用推送 为任务建立发送入口
实时接收 网页和客户端保持连接
消息优先级 区分提醒等级
多应用隔离 单独撤销发送权限
历史记录 查看过去事件

功能示意

Gotify 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

Gotify 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 gotify/server
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 按官方容器说明设置持久化数据与管理员初始密码,完成登录后检查账号设置。
  2. 创建一个测试应用取得发送 Token,发送一条消息并核对优先级。
  3. 在 Android 客户端连接同一服务,检查后台连接和系统电池限制,再接入 NAS 任务。

发送测试通知

登录后创建一个测试应用,取得该应用令牌。用当前地址发送一条不含敏感内容的消息:

curl -X POST "http://NAS_IP:8088/message?token=替换为自己的应用令牌" \
  -F "title=NAS 测试" \
  -F "message=这是一条测试消息" \
  -F "priority=5"

应用令牌用于发布消息,不应公开。接收端仍需使用自己的账号或客户端连接服务。

首次使用与操作检查

创建备份测试应用,发送普通与高优先级消息。手机锁屏一段时间后再测实际提示。

发送 Token 不能当作管理员密码使用。反向代理检查 WebSocket,收不到消息先区分发布失败与客户端断开。

Docker Compose

按 Gotify 官方安装页的镜像、端口和数据目录整理。先创建 data 目录,在 .env 设置 GOTIFY_ADMIN_PASSWORD,打开 http://NAS_IP:8088 初始化并核对账号。此变量用于首次创建默认用户,不等于修改既有用户密码。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/gotify/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/gotify /volume1/docker/gotify/data
cd /volume1/docker/gotify
umask 077
touch .env
if ! grep -q "^GOTIFY_ADMIN_PASSWORD=." .env; then
  generated_secret=$(openssl rand -hex 32)
  printf 'GOTIFY_ADMIN_PASSWORD=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/gotify

所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/gotify/.env;该文件只保留在本机。

services:
  gotify:
    image: gotify/server:latest
    restart: unless-stopped
    ports:
      - "8088:80"
    environment:
      TZ: Asia/Shanghai
      GOTIFY_DEFAULTUSER_PASS: "${GOTIFY_ADMIN_PASSWORD}"
    volumes:
      - /volume1/docker/gotify/data:/app/data

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 远程访问时检查代理的 WebSocket 支持,不能只看网页能否打开。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

保存 data、应用配置和必要消息,Token 泄露后应撤销并重新生成。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料