NAS 与运维

ntfy:自托管通知与主题权限

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

ntfy 通过 HTTP 发布和订阅消息,适合为脚本增加通知。主题名称不能替代鉴权,正式使用前应设置默认访问策略与用户权限。 发布者向主题发送 HTTP 请求,订阅端接收消息。用户权限决定谁能发布或读取,主题名字本身只是路由标识。 适合给脚本增加简单通知。可先使用一个主题,再按任务或重要性拆分,避免订阅过于零散。

项目介绍

ntfy 通过 HTTP 发布和订阅消息,适合为脚本增加通知。主题名称不能替代鉴权,正式使用前应设置默认访问策略与用户权限。

发布者向主题发送 HTTP 请求,订阅端接收消息。用户权限决定谁能发布或读取,主题名字本身只是路由标识。

适合给脚本增加简单通知。可先使用一个主题,再按任务或重要性拆分,避免订阅过于零散。

核心功能

功能 作用与使用方式
HTTP 发布 从脚本发送消息
主题订阅 按任务组织通知
用户授权 控制读写权限
消息附件 按配置传递文件
历史缓存 查看断线期间记录

界面展示

ntfy 官方项目配图

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

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

项目信息

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

安装或使用条件

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

安装与使用步骤

  1. 按官方容器文档准备缓存、附件和配置目录,先设置拒绝匿名访问的默认权限。
  2. 创建测试用户和主题授权,从命令行发布一条无敏感信息的消息。
  3. 用手机客户端订阅同一主题,检查后台接收、历史记录及附件,再接入正式任务。

启动后建立管理员

容器运行后执行交互式账号创建,按提示输入独立强密码:

docker compose exec ntfy ntfy user add --role=admin admin

登录 Web 页面或客户端后订阅测试主题。脚本账号应单独创建并只获得所需主题权限,不在所有任务中共用管理员。未创建账号时默认拒绝访问属于预期状态。

首次使用与操作检查

创建受限测试主题,分别用合法和未授权身份发布,确认权限。手机订阅后测试后台接收。

接口成功但无提示时查系统通知与电池限制。附件缓存定期检查占用,服务端备份包含授权配置。

Docker Compose

依据官方安装与认证文档整理,默认拒绝匿名访问。下方命令会创建 data 目录并生成 NTFY_BASE_URL;通过代理使用时再按官方文档设置真实 HTTPS 域名和代理参数。

群晖目录准备

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

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/ntfy /volume1/docker/ntfy/data
cd /volume1/docker/ntfy
umask 077
touch .env
NAS_ADDR=$(ip -4 route get 1.1.1.1 | sed -n "s/.* src \([^ ]*\).*/\1/p" | head -n 1)
test -n "$NAS_ADDR" || { echo "未能识别 NAS 地址,请检查默认路由"; exit 1; }
if ! grep -q "^NTFY_BASE_URL=." .env; then
  printf 'NTFY_BASE_URL=http://%s:8093\n' "$NAS_ADDR" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/ntfy

首次准备会根据 NAS 默认路由生成局域网访问地址。使用其他网卡或 HTTPS 域名时,修改项目 .env 中对应 URL 后重建服务。

services:
  ntfy:
    image: binwiederhier/ntfy:latest
    restart: unless-stopped
    command: serve
    ports:
      - "8093:80"
    environment:
      TZ: Asia/Shanghai
      NTFY_BASE_URL: "${NTFY_BASE_URL}"
      NTFY_CACHE_FILE: /var/lib/ntfy/cache.db
      NTFY_AUTH_FILE: /var/lib/ntfy/auth.db
      NTFY_AUTH_DEFAULT_ACCESS: deny-all
      NTFY_ATTACHMENT_CACHE_DIR: /var/lib/ntfy/attachments
      NTFY_ENABLE_LOGIN: "true"
    volumes:
      - /volume1/docker/ntfy/data:/var/lib/ntfy

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

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

配置与常见问题

  • 反向代理、WebSocket 和移动端推送配置可能影响送达,需逐项按官方文档检查。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

保留权限数据库、服务配置与必要历史数据,访问令牌加密保存。

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

参考资料

配图来自 binwiederhier/ntfy 官方仓库,按 Apache-2.0 许可 保留来源与许可;图片只做等比例缩小和压缩。