项目介绍
ntfy 通过 HTTP 发布和订阅消息,适合为脚本增加通知。主题名称不能替代鉴权,正式使用前应设置默认访问策略与用户权限。
发布者向主题发送 HTTP 请求,订阅端接收消息。用户权限决定谁能发布或读取,主题名字本身只是路由标识。
适合给脚本增加简单通知。可先使用一个主题,再按任务或重要性拆分,避免订阅过于零散。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| HTTP 发布 | 从脚本发送消息 |
| 主题订阅 | 按任务组织通知 |
| 用户授权 | 控制读写权限 |
| 消息附件 | 按配置传递文件 |
| 历史缓存 | 查看断线期间记录 |
界面展示

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

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | binwiederhier/ntfy |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 按官方容器文档准备缓存、附件和配置目录,先设置拒绝匿名访问的默认权限。
- 创建测试用户和主题授权,从命令行发布一条无敏感信息的消息。
- 用手机客户端订阅同一主题,检查后台接收、历史记录及附件,再接入正式任务。
启动后建立管理员
容器运行后执行交互式账号创建,按提示输入独立强密码:
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 许可 保留来源与许可;图片只做等比例缩小和压缩。