SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

如何自托管 ntfy 服务器实现推送通知

通过 Docker Compose 在 VPS 上部署 ntfy,配置 TLS 加密与 ACL 访问控制。本指南详细说明如何通过 systemd OnFailure 单元与 cron 任务发送私有推送通知,并解决反向代理下的真实 IP 识别与身份验证问题。

自托管 ntfy 服务器的作用

自托管 ntfy 服务器将 HTTP POST 请求转换为手机上的推送通知。您可以使用 curl 发布消息,消息会送达至 Android 应用、iOS 应用、浏览器标签页或任何能够保持 HTTP 连接的终端。无需安装客户端库,也无需运行消息代理。

ntfy 通过主题 (topic) 来寻址消息。主题是 URL 路径中的一个名称,例如 https://ntfy.example.com/alerts,只要有人向其发布消息,该主题即刻创建。在默认安装中,任何知晓该名称的人都可以读取或写入该主题,因此项目文档将主题名称比作密码。这种模式适用于公共的 ntfy.sh 服务。但对于承载备份失败通知等敏感信息的服务器,这种模式并不安全,因此本指南将在发送第一条消息前启用身份验证。

开始前的准备工作

您需要一台运行 Ubuntu 24.04 或 Debian 13 的 VPS,并安装 Docker Engine 和 Compose 插件;此外还需要一个域名,以及很少的 RAM。创建一个 DNS(域名系统)A 记录,将 ntfy.example.com 指向服务器的公网 IP 地址,然后确认该域名已解析,再进行其他操作。

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

dig 必须输出服务器的 IP 地址。申请证书时,主机名必须通过 A 或 AAAA 记录在公网解析到该服务器。端口 80 必须保持开放,因为 Let's Encrypt 使用的 ACME(自动证书管理环境)协议需要通过该端口完成 HTTP 挑战。ntfy 容器本身不会暴露公网端口。

编写 ntfy 配置文件

Docker 镜像不包含配置文件,因此需要创建一个。后续本指南中的每条命令都会读取该文件。首先,获取容器运行时使用的用户 ID 和组 ID。

id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.yml
base-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: false

其中有 4 行起决定性作用。base-url 必须是准确的公网 HTTPS 地址,因为 ntfy 会使用它生成附件链接和自托管 iOS 推送通知。listen-http: ":2586" 将服务绑定到容器内的所有接口。这种配置看似宽松,实际上是正确的:容器拥有独立的网络命名空间,因此如果在那里绑定到 127.0.0.1,主机将无法访问该端口,Docker 发布的端口也无法建立连接。auth-default-access: "deny-all" 定义了完整的安全策略:除非明确授予权限,否则拒绝所有人的读取和写入操作。behind-proxy: true 告诉 ntfy 从 X-Forwarded-For 请求头获取客户端地址,使速率限制统计真实访问者,而不是将反向代理视为一个非常繁忙的客户端。

enable-login: true 允许用户通过 Web 应用或 API 登录。enable-signup 保持为 false,因为在私有服务器上启用自助注册,相当于增加不必要步骤后仍然开放入口。

sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml

使用 Docker Compose 运行 ntfy

将以下内容写入 /opt/ntfy/compose.yaml,并将 1000:1000 替换为上面显示的两个数字 id -u 和 id -g。

services:
  ntfy:
    image: binwiederhier/ntfy:v2.36.0
    container_name: ntfy
    command: serve
    user: "1000:1000"
    environment:
      - TZ=UTC
    volumes:
      - /etc/ntfy:/etc/ntfy
      - /var/cache/ntfy:/var/cache/ntfy
      - /var/lib/ntfy:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:2586"
    restart: unless-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

运行正常的服务器会响应 {"healthy":true,"role":"active"}。该 Compose 文件中有两处设置是有意这样配置的。镜像固定为 v2.36.0,这是截至 November 1, 2026 的当前稳定版本,而不是 latest。因为使用 latest 时,下一次 docker compose pull 会下载当前镜像,之后的 docker compose up -d 会使用该镜像重新创建容器;仅执行拉取不会改变正在运行的服务器版本。固定版本仍需定期更新。仅 October 2026 就发布了 ten 个版本:October 7 发布 v2.29.0,October 12 发布 v2.30.0,October 16 发布 v2.31.0 和 v2.31.1,October 18 发布 v2.32.0,October 23 发布 v2.33.0 和 v2.33.1,October 24 发布 v2.34.0,October 30 发布 v2.35.0,October 31 发布 v2.36.0。v2.31.0 修复了客户端在消息进入消息缓存前重新连接时消息丢失的问题,但其带有 since=<message ID> 的重新连接会从数据库读取主题中的每条消息,ntfy.sh 因此回滚了该版本。v2.31.1 通过新增索引修复了这个负载问题,v2.34.0 修复了已撤销或删除的用户仍保留部分订阅的问题。v2.35.0 修复了并发请求将有效凭据识别为匿名凭据的问题,以及 SQLite 上 Matrix 推送网关的授权绕过问题,因此应将旧的固定版本更新为 v2.36.0。端口发布为 127.0.0.1:2586:2586,因此容器只能通过主机的 loopback 地址访问。改为写入 2586:2586 后,Docker 会将自己的防火墙规则置于你的规则之前。这意味着即使 ufw status 表示端口已关闭,该端口仍会从互联网响应。添加下一个容器时,这两种配置原则同样适用:自托管 RustDesk 中继也会按相同方式固定镜像标签,但它无法隐藏在 loopback 后,因为其信令端口和中继端口必须从互联网响应。

如果 curl 输出 Connection refused,请查看容器日志。/var/lib/ntfy/user.db 上的权限错误表示 user: 行与这些目录的所有者不匹配,因此进程无法创建自己的数据库并退出。VPS 的 Docker Compose 基础指南详细介绍了卷所有权和重启策略。

使用 Caddy 放置 TLS

Caddy 会自动申请并续期证书,这是启用 TLS(传输层安全)的最简便方式。

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

将 /etc/caddy/Caddyfile 的内容替换为三行。

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

通过 HTTPS 访问同一个 {"healthy":true,"role":"active"},即可验证整个链路正常。Caddy 返回 502,通常表示 ntfy 未在监听:使用 sudo ss -lntp | grep 2586 检查。如果 ntfy 正在监听,但 502 仍然存在,Caddy 会记录它遇到的上游错误,例如连接被重置。证书错误通常表示 DNS 记录不正确,或证书验证无法通过端口 80 或 443 访问服务器;检查 sudo journalctl -u caddy -n 50 了解验证错误。以后添加其他服务时,只需在同一个 Caddyfile 中再添加一个主机名块。例如,Halcyon:用于 Jellyfin 媒体库的 90 年代视频商店前端 就可以通过同一台服务器上的第二个子域名提供服务。

如果已经在运行 nginx,请复制 ntfy 文档中的代理设置:proxy_http_version 1.1、proxy_buffering off、proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for,并将读取和发送超时设置为至少三分钟。订阅者在监听期间会保持一个 HTTP 连接打开。nginx 默认的 proxy_read_timeout 为 60 秒,但它只计算两次读取之间的时间;ntfy 默认每 45 秒发送一次 keepalive 消息(keepalive-interval),正是为了防止中间设备因连接处于非活动状态而将其关闭。因此,即使使用默认 nginx 配置,空闲订阅者也能保持连接;较长的超时时间只是提供余量,并不是保持连接的必要条件。如果调高 keepalive-interval,请将其保持在代理读取超时以内。

创建用户并限制主题访问

现在已启用身份验证,但还没有任何用户获得访问权限。这正是预期结果。为自己创建一个管理员账户,再为脚本创建一个机器账户。这些命令会从容器内部读取 /etc/ntfy/server.yml,因此配置文件必须作为卷挂载。

sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user list

每条 user add 命令都会提示输入密码。管理员会忽略访问控制列表,可以读取和写入所有主题,因此应只将该账户用于您自己和手机应用。robot 是一个普通用户,在授予权限前完全没有访问权限。

sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy access

ACL(访问控制列表)条目由用户、主题和权限组成。主题可以是字面名称,也可以是模式,其中 * 可匹配任意内容。因此,alerts_* 可以覆盖 alerts_backup 和 alerts_db,无需为每台主机分别执行命令。权限 write 表示只能发布,因此即使 cron 任务中的令牌被窃取,攻击者也无法订阅并读取该任务发送的内容。特殊用户名 everyone 用于设置未通过身份验证的访问者可以执行的操作。将 deny-all 设为默认值后,通常只会用它有意开放公共主题,例如 ntfy access everyone status read;如果希望明确禁止匿名访问某个主题,也可以使用 deny。

脚本应携带令牌,而不是您的密码。

sudo docker compose exec ntfy ntfy token add robot

该命令会输出一个以 tk_ 开头的令牌。令牌完全继承所属用户的访问权限,因此此令牌只能发布到 alerts 主题,不能执行其他操作。ntfy token list 用于显示现有内容,ntfy token remove 可以撤销其中一个令牌,而不会修改用户密码。

发送第一条消息并验证锁定功能

首先确认门已关闭。

curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts

该命令会输出 403,其中 403 是正确答案:auth-default-access: "deny-all" 会拒绝匿名发布。现在发送一条真实消息。

curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
  -H "Title: Nightly backup finished" \
  -H "Priority: default" \
  -H "Tags: white_check_mark" \
  -d "42 GB copied in 11 minutes" \
  https://ntfy.example.com/alerts

服务器会以 JSON 格式返回已存储的消息,这表明消息已被接收而非丢弃。Title 是加粗的第一行。Priority 的取值范围为 1 到 5,也可以使用 min 到 urgent 的名称,它决定了手机是否会发出提示音。当名称与已知的 emoji 短代码匹配时,Tags 会在通知中显示为 emoji,否则将显示为纯文本。

若要从终端监控某个主题,请使用流式传输:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl 会提示输入密码。每条消息以单行形式到达,期间出现的空行是保活心跳包。在浏览器中打开 https://ntfy.example.com 并使用同一账户登录,即可使用该流的 Web 应用版本。

设置速率限制,避免单个脚本使服务器过载

默认情况下,每个访问者都有一个包含 60 个请求的令牌桶,每 5 秒补充 1 个请求。对于私有服务器来说,这个额度较高,而陷入重试循环的脚本会耗尽全部额度。将限制添加到 server.yml。

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

超过限制的访问者会收到 HTTP 429,消息不会送达。限制按访问者地址统计,因此 behind-proxy: true 非常重要:没有它,ntfy 只能看到 Caddy 的地址,所有客户端都会被视为同一个访问者,某个产生大量请求的脚本会耗尽你的手机和其他服务器共享的额度。从 v2.36.0 开始,每日计数会保存在用户数据库中,重启后仍然保留;每个访问者的额度按各自的 24 小时周期重置,而不是在 UTC 午夜统一重置。

来自 Cron 任务失败的告警

请勿将令牌(token)放入命令行。ps aux 会向系统上的所有用户显示每个运行进程的完整命令行,因此通过 -H 传递的令牌在 curl 运行期间可被任何本地账户读取。使用 curl 配置文件可避免此问题。

sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrc

现在封装该任务。将其保存为 /usr/local/bin/backup-with-alert.sh 并执行 chmod 750。

#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
  printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
    -H "Title: backup.sh failed with exit $code" \
    -H "Priority: high" \
    -H "Tags: warning" \
    --data-binary @- \
    https://ntfy.example.com/alerts
fi
exit "$code"
17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1

$? 会在命令执行后的下一行被捕获,因为后续运行的命令会覆盖它。输出内容需经过 tail -c 1000 处理,因为 ntfy 强制限制了最大消息长度,且通知并非日志查看器。最后的 exit "$code" 会保留原始状态码,确保监控此任务的其他程序仍能识别到失败。将脚本指向 /bin/false 进行一次运行测试。

从未执行的失败分支比没有告警更糟糕,因为这会让人误以为静默即代表成功。Cron 为任务提供的环境几乎为空,且 PATH 比登录 Shell 短得多,因此手动运行时正常的脚本可能在到达 curl 行之前就已终止。关于 Cron 任务为何无法运行的指南 涵盖了这些环境陷阱。请务必在所有地方使用绝对路径,并在首次定时运行后查看日志文件,不要仅凭假设。

systemd 单元失败时发出警报

Cron 适用于计划任务。长时间运行的服务需要 OnFailure=,systemd 会在单元进入 failed 状态时运行它。创建一个模板单元,并将其用于服务器上的每个服务。将以下内容保存为 /etc/systemd/system/ntfy-unit-failed@.service。

[Unit]
Description=Send an ntfy alert because %i failed

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %i

然后 /usr/local/bin/ntfy-unit-failed,权限设为 750:

#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
  -H "Title: $unit failed on $(hostname -s)" \
  -H "Priority: urgent" \
  -H "Tags: rotating_light" \
  --data-binary @- \
  https://ntfy.example.com/alerts

通过 drop-in 将其附加到服务,这样软件包升级就不会覆盖您的修改。

sudo systemctl edit myapp.service
[Unit]
OnFailure=ntfy-unit-failed@%n.service

%n 会展开为完整的单元名称,因此实例化后的单元会变成 ntfy-unit-failed@myapp.service.service;模板中的 %i 会将 myapp.service 作为第一个参数传递给脚本。这样,一个模板就能服务于所有单元。使用一个故意失败的单元验证配置是否生效,并将其保存为 /etc/systemd/system/ntfy-selftest.service。

[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service

[Service]
Type=oneshot
ExecStart=/bin/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

启动命令会以非零状态退出,并输出 Job for ntfy-selftest.service failed because the control process exited with error code;大约 1 秒后,手机应收到提醒。完成后删除测试单元。

有一个问题需要特别注意。OnFailure= 只会在单元进入 failed 状态时运行,而 RestartMode=direct 会在自动重启期间跳过该状态,因此也会跳过失败处理程序。使用默认的 RestartMode=normal 时,自动重启会经过 failed 状态。StartLimitBurst 和 StartLimitIntervalSec 控制连续启动多少次后拒绝继续启动;请设置它们,使崩溃循环最终停止。对于上面的 Cron 模式,Timer 是更合适的替代方案,因为 Timer 的服务单元同样支持 OnFailure= drop-in;VPS 上 systemd 服务和 Timer 指南介绍了如何将其转换为 Timer。

在同一主题中接入运行时间监控

Uptime Kuma,自托管状态监控工具支持 ntfy 通知类型。打开 Settings,然后依次进入 Notifications 和 Setup Notification,选择 Ntfy,将服务器 URL 设置为 https://ntfy.example.com,将主题设置为 alerts,选择优先级,并粘贴 robot 访问令牌。保存前先发送测试通知,因为错误的主题名称会在不包含该主题的 write 授权下返回错误。

这种配置有一个明确的限制:运行在同一 VPS 上的监控器无法告诉您 VPS 已宕机,ntfy 也无法发送 ntfy 已停止运行的通知。请将监控器运行在另一台机器上,并为监控 ntfy 本身的监控器配置第二个通知渠道,例如电子邮件。Uptime Kuma 的 Push 监控类型可以覆盖另一个盲区:cron 作业成功运行后调用推送 URL,Kuma 会在不再收到这些调用时发出告警。失败分支只有在作业实际运行时才会触发,因此无法说明作业从未启动。

自托管 ntfy 能在 Android 和 iPhone 上运行吗?

在 Android 上可以,完全不受限制。从 Google Play 或 F-Droid 安装应用,打开 Settings,将默认服务器设置为 https://ntfy.example.com,在用户管理界面中添加您的账户,然后订阅 alerts。即时传递会运行一个前台服务,因此即使手机处于休眠模式,消息也能到达。随之出现的常驻通知是 Android 对前台服务的要求,不是程序故障。F-Droid 版本完全不包含 Firebase 代码,因此所有订阅都使用即时传递。ntfy 还可以充当 UnifiedPush 分发器,作为 Google 推送服务的开放替代方案,因此其他支持 UnifiedPush 的应用也可以通过您的服务器传递通知。

在官方 iOS 应用中可以使用,但有一个无法移除的依赖。iOS 会暂停处于后台的应用。Apple 允许的后台模式包括播放音频、接收位置更新和处理计划任务,但不允许应用持续等待服务器发送消息。因此,要及时唤醒应用,必须通过 APNs(Apple 推送通知服务)发送通知。只有拥有该应用授权凭据的推送提供商才能向它发送通知,因此您的服务器无法直接联系官方应用。ntfy 通过中继解决这一问题:您的服务器向 ntfy.sh 发送包含消息 ID 的 poll_request,ntfy.sh 再通过 Firebase 和 APNs 唤醒应用,随后应用从您的服务器获取消息正文。

upstream-base-url: "https://ntfy.sh"

请明确这会带来什么影响。消息内容保留在您的服务器上,但消息已到达这一事实及其 ID 会经过您不管理的基础设施。如果不启用此设置,自托管服务器发送到 iPhone 的通知仍然最终会到达,但 ntfy 文档警告延迟可能达到数小时,因为没有任何机制及时唤醒应用。若要在不使用 ntfy.sh 中继的情况下使用原生 iOS 应用,您需要使用自己的 Apple 开发者账户和 APNs 密钥自行构建并发布应用。这意味着需要支付年度费用,并且每次更新都要重新构建。另一种方式是在 iOS 16.4 或更高版本上使用 ntfy 的 PWA:将其添加到主屏幕,并在您的服务器上配置 Web Push。这样可以避免使用 ntfy.sh 中继,但仍会使用浏览器的推送基础设施。如果您的使用场景无法接受该中继,请将告警功能保留在 Android 或桌面 Web 应用上。

备份、升级和固定镜像版本

以下两个路径无法重新生成:/etc/ntfy/server.yml 和 /var/lib/ntfy/user.db。后者包含所有用户、密码哈希、ACL 条目和令牌,因此应按私钥处理。

sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz

将该文件复制到服务器之外。cache.db 保存最近的消息;结合上面的 cache-duration,会保存 12 小时的消息,以及所有计划稍后投递的消息。计划消息会一直保留到投递后 12 小时。除非你会提前安排消息,否则丢失该文件不会造成值得保护的损失。升级时,需要编辑 Compose 文件中的标签、拉取镜像,然后重新创建容器。

sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health

先阅读发行说明。SQLite 数据库会在启动时迁移,因此模式变更后回滚到旧标签并不安全。例如,v2.31.1 将消息缓存迁移到模式版本 17,其升级说明指出,降级到 v2.31.0 或更早版本时,需要手动将该版本改回 16。升级到 v2.36.0 会将所有现有的每日计数重置一次。新版本运行一天后,再删除刚刚创建的备份。说明中还会标记行为变化。从 v2.31.0 开始,客户端使用 since=<message ID> 重新连接时,也会收到同一秒发布的消息,因此可能看到重复消息。ntfy 应用和 Web 应用会按消息 ID 丢弃重复消息,但你自己编写的、用于重放主题的脚本也必须执行相同处理。服务器上的每个服务都有一份无法重新生成的路径清单,PhotoPrism 与 Immich 的比较针对同类 VPS 上的照片库整理了这份清单及相应的备份命令。

Gotify 和 Apprise

Gotify 是更轻量的选项:它提供一个二进制文件、一个 Web 界面和一个 Android 应用,并按应用组织消息。对于只需要向 Android 设备发送通知的私有服务器,这种方式很合适。Apprise 是一个 Python 库和命令行工具,也提供独立的 Apprise API 服务器,并可将一条消息同时发送到 100 多种服务,包括 ntfy。对于必须同时通知多个位置的脚本,这种方式更合适。ntfy 同时提供服务器、HTTP API 以及支持两个移动平台的应用,因此从租用服务器发送告警时,通常会选择它。

FAQ

为什么向我的 ntfy 服务器发布消息会返回 403?

在 server.yml 中启用 auth-default-access: "deny-all" 后,匿名发布会被拒绝,这是预期行为。请通过 -u user:pass 或 -H "Authorization: Bearer tk_..." 发送凭据。如果已经发送了令牌但仍收到 403,请检查该用户是否有允许写入主题的 ACL 条目:没有匹配条目时,read-only 或 deny 都会拒绝发布。在 v2.34.0 中,来自同一 IP 的并发请求还可能导致有效凭据被当作匿名请求处理;v2.35.0 修复了此错误,因此在将间歇性 403 认定为 ACL 问题前,请先升级。运行 ntfy access 可输出完整列表。请注意,write 授权不允许订阅,因此能够正常发布消息的账户在尝试读取同一主题时仍会被拒绝。

在使用自托管 ntfy 服务器时,iPhone 能收到通知吗?

使用官方 iOS 应用时,通知会通过中继发送。要唤醒处于挂起状态的 iPhone 应用,必须通过 APNs(Apple 推送通知服务)发送提示;而向官方应用发送通知需要其发布者的推送凭据。因此,ntfy 会将包含消息 ID 的 poll_request 转发到 ntfy.sh,再由其将通知中继到设备。请在 server.yml 中设置 upstream-base-url: "https://ntfy.sh",然后重启容器。消息正文仍会从您的服务器获取。未设置该项时,iOS 通知仍可最终送达,但 ntfy 文档警告延迟可能达到数小时。在 iOS 16.4 或更高版本上,如果服务器已配置 Web Push,PWA 还提供了另一种方式。

为什么我的 cron 任务发送的 ntfy 警报始终没有到达?

先单独运行 curl 命令行,以确认令牌和主题正确。如果手动运行成功,但从 cron 运行失败,问题发生在警报发送之前:cron 使用精简环境和较短的 PATH 运行任务,因此调用未使用绝对路径的命令的脚本可能在执行 curl 命令前就退出。请使用绝对路径,将任务输出重定向到日志文件,并在下一次运行后读取该文件。收到 429 响应而不是送达通知,表示请求被某项限制拒绝。通常是脚本重试过快;但如果访问者已用完每日配额,例如用尽了上文设置的消息限制,即使只发送一次请求,也会以同样方式被拒绝。

我应该将 ntfy 暴露到公网吗?

手机应用需要通过移动网络访问服务器,因此,配置带有 auth-default-access: "deny-all" 和按主题设置的 ACL 的公网 HTTPS 端点是常见方案;只要没有主题允许 everyone 读取,该方案就是安全的。当所有订阅者都是您控制的机器时,仅允许通过 VPN 访问的实例是合理选择。但这不适合手机,因为应用只有在隧道连接建立时才能接收通知;隧道断开期间,警报会排队,直到手机重新连接。

这篇文章对您有帮助吗?