自建推送通知服务：Docker 部署 ntfy 替代 Pushover

ntfy vs 其他推送方案#

为什么 ntfy 值得部署#

1. 极轻量 — 10MB Docker 镜像，跑在 256MB 内存的机器上毫无压力
2. 协议简单 — 核心就是个 HTTP POST 请求，任何语言/脚本都能发
3. 双端 App — Android 和 iOS 都有官方 App，Web 端也行
4. 消息持久化 — 默认保留 7 天消息，离线设备上线后能收到
5. 附件支持 — 可以发图片、文件（比如监控截图）
6. 生态好 — Uptime Kuma、Grafana Alerting、Prometheus Alertmanager 都原生支持

环境要求#

• Docker Engine ≥ 20.10
• 任意 Linux 服务器，256MB 内存足够
• 一个域名（推荐，用于 HTTPS）

快速部署#

创建 docker-compose.yml：

1
version: '3.8'
2

3
services:
4
  ntfy:
5
    image: binwiederhier/ntfy:latest
6
    container_name: ntfy
7
    ports:
8
      - "8080:80"
9
    volumes:
10
      - ./ntfy_data:/etc/ntfy
11
      - ./ntfy_cache:/var/cache/ntfy
12
    restart: unless-stopped

启动：

1
mkdir -p ntfy_data ntfy_cache
2
docker compose up -d

打开 http://你的IP:8080 就能看到 ntfy 的 Web 界面。

配置 HTTPS（推荐）#

用 Caddy 一键反代：

1
ntfy.yourdomain.com {
2
    reverse_proxy 127.0.0.1:8080
3
}

用 Nginx Proxy Manager：

1. 添加 Proxy Host
2. Domain Names: ntfy.yourdomain.com
3. Forward to 127.0.0.1:8080
4. 开启 SSL → Let’s Encrypt

高级配置#

创建 ntfy_data/server.yml：

1
# 基础配置
2
base-url: "https://ntfy.yourdomain.com"
3

4
# 身份验证（可选，建议开启）
5
auth-file: "/etc/ntfy/auth.db"
6
auth-default-access: "deny-all"
7

8
# 消息保留时间（默认 3 天）
9
cache-duration: "72h"
10

11
# 附件大小限制（默认 15MB）
12
attachment-size: "25M"
13

14
# 开启邮件通知（可选）
15
smtp-sender-addr: "smtp.gmail.com:587"
16
smtp-sender-user: "your@gmail.com"
17
smtp-sender-pass: "app-password"
18
smtp-sender-from: "ntfy@yourdomain.com"

设置管理员账号：

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

1. 安装手机 App#

• Android: Google Play / F-Droid 搜索 “ntfy”
• iOS: App Store 搜索 “ntfy”

打开 App → 设置 → 添加服务器 → 输入 https://ntfy.yourdomain.com → 订阅 topic

2. 从命令行发通知#

1
# 最简单的方式
2
curl -d "服务器磁盘空间不足！" https://ntfy.yourdomain.com/alert
3

4
# 带标题和优先级
5
curl -H "Title: 磁盘告警" \
6
     -H "Priority: urgent" \
7
     -H "Tags: warning,disk" \
8
     -d "根分区使用率 95%，请立即处理" \
9
     https://ntfy.yourdomain.com/alert
10

11
# 发送图片（监控截图）
12
curl -H "Title: 服务器状态" \
13
     -F "file=@screenshot.png" \
14
     https://ntfy.yourdomain.com/server-status

3. 从脚本发通知#

Shell 脚本：

1
#!/bin/bash
2
send_alert() {
3
    curl -H "Title: $1" \
4
         -H "Priority: high" \
5
         -d "$2" \
6
         https://ntfy.yourdomain.com/alert
7
}
8

9
# 检查磁盘
10
disk_usage=$(df / | awk 'NR==2 {print $5}' | tr -d '%')
11
if [ "$disk_usage" -gt 90 ]; then
12
    send_alert "磁盘告警" "根分区使用率 ${disk_usage}%"
13
fi

Python 脚本：

1
import requests
2

3
def send_notification(topic, title, message, priority=3):
4
    requests.post(
5
        f"https://ntfy.yourdomain.com/{topic}",
6
        headers={
7
            "Title": title,
8
            "Priority": str(priority),
9
            "Tags": "computer"
10
        },
11
        data=message.encode()
12
    )
13

14
send_notification("alert", "服务重启", "Caddy 容器已自动重启", priority=4)

4. 集成监控工具#

Uptime Kuma 集成：

1. 进入 Uptime Kuma → 设置 → 通知
2. 选择 “ntfy”
3. 填入服务器 URL 和 topic
4. 测试 → 手机立刻收到！

Grafana Alerting 集成：

1
# 在 Grafana 中配置 Contact Point
2
type: webhook
3
url: https://ntfy.yourdomain.com/grafana-alert
4
http method: POST

Prometheus Alertmanager 集成：

1
receivers:
2
  - name: 'ntfy'
3
    webhook_configs:
4
      - url: 'https://ntfy.yourdomain.com/prometheus-alert'

Q1: ntfy 的消息会丢失吗？#

消息默认在服务端保留 3 天（可配置）。如果你的手机离线，上线后会收到所有未读消息。超过保留期的消息会被自动清理。

Q2: 可以自定义通知铃声吗？#

可以。ntfy App 支持为不同 topic 设置不同的铃声、震动模式、LED 颜色。比如把 “critical” topic 设为高优先级震动，把 “info” topic 设为静音通知。

Q3: 安全性如何？#

ntfy 支持可选的身份验证（用户名密码或 Token）。建议：

• 开启 auth-default-access: "deny-all" 限制匿名访问
• 用 Caddy/NPM 配置 HTTPS
• 每个服务使用独立的 topic 名称

Q4: 免费的 ntfy.sh 和自部署有什么区别？#

ntfy 官方提供了免费的 ntfy.sh 公共服务器，无需部署就能用。但注意：

• 公共服务器上的消息对所有知道 topic 名的人可见
• 没有身份验证保护
• 受限于官方配额

自部署是自己的地盘，更安全、更可控。

Q5: 跟 Gotify 比怎么选？#

如果你只用 Android，两个都行。如果你有 iOS 设备，ntfy 是唯一选择。