5分钟跑通 ntfy 部署：Docker、云服务器、本地源码三条路径实战指南

5分钟跑通 ntfy 部署Docker、云服务器、本地源码三条路径实战指南【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfyntfy 是一个轻量级消息推送服务向任意主题发一次 PUT/POST 请求订阅了该主题的手机和桌面端立刻收到通知全程无需注册账号。无论你在 NAS、云主机还是开发机上都能把 ntfy 跑起来——本文按先选路、再动手的顺序带你走完每一步都附可执行的验证命令。30秒看懂它一句话基于 HTTP 的发布/订阅pub-sub推送服务把发消息这件事压缩成一次 HTTP 请求。无依赖单个静态二进制不强制要求数据库需要留存历史消息时内置 SQLite 缓存即可多平台Linux / Windows / macOS / ARM 服务器均有现成镜像与安装包轻量一条docker run或一条ntfy serve就能启动关键文件官方文档 docs/install.md · 配置模板 server/server.yml动手前先选路三条路径都能跑通差别在为谁服务和你手上有什么。先对号入座只看对应小节你的情况推荐路径对应小节个人自用、有 NAS 或一台装了 Docker 的机器Docker 容器化主推路径企业/生产有公网域名要开机自启和自动更新云服务器 系统包管理路径 A要改代码、追最新特性、做定制本地源码编译路径 B快速自检三问① 需要公网访问吗不需要 → Docker 或源码够了。② 有域名和证书吗有 → 云服务器 HTTPS。③ 熟悉 Docker 吗不熟 → 先走云服务器 apt 安装命令最直白。主推路径Docker 容器化新手首选第一步极简启动# 拉取镜像并启动把容器 80 端口映射到宿主机 docker run -d -p 80:80 --name ntfy binwiederhier/ntfy serve成功标志浏览器打开http://localhost能看到 ntfy Web 界面即部署成功。第二步生产级持久化配置官方镜像不内置server.yml想改配置必须自己建一个并挂进去。把仓库里的模板放到宿主机再挂载缓存卷消息和附件才能在重启后保留# 创建宿主机上的配置目录和缓存目录 mkdir -p /etc/ntfy /var/cache/ntfy # 启动容器挂载配置与缓存并设置时区 docker run -d \ -p 80:80 \ -v /etc/ntfy:/etc/ntfy \ -v /var/cache/ntfy:/var/cache/ntfy \ -e TZAsia/Shanghai \ --name ntfy \ binwiederhier/ntfy serve在/etc/ntfy/server.yml可用 server/server.yml 作模板里至少打开这三行让消息落到磁盘# 消息缓存到 SQLite 文件配合 cache-duration 支持 since 查询 cache-file: /var/cache/ntfy/cache.db cache-duration: 72h # 附件缓存目录启用附件功能前需同时设置 base-url attachment-cache-dir: /var/cache/ntfy/attachments成功标志docker restart ntfy后Web 界面仍能翻到之前收到的消息说明缓存持久化生效。第三步状态验证# 确认容器在跑 docker ps | grep ntfy # 跟踪启动日志看到 Listening on... 即正常 docker logs -f ntfy # 发一条测试消息浏览器打开 /mytopic 应立刻看到 curl -d Hello from ntfy! http://localhost/mytopic成功标志curl发出后手机 App 或浏览器订阅页面秒级弹出该消息。其他路径速览路径 A云服务器安装系统包管理Debian/Ubuntu 直接加官方 apt 仓库# 添加官方签名密钥与仓库源 sudo mkdir -p /etc/apt/keyrings sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg echo deb [archamd64 signed-by/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main \ | sudo tee /etc/apt/sources.list.d/ntfy.list # 安装并设为开机自启 sudo apt update sudo apt install ntfy -y sudo systemctl enable --now ntfyFedora/RHEL 用 rpmsudo rpm -ivh releases 页对应架构的 .rpm sudo systemctl enable --now ntfy。验证systemctl status ntfy显示 active (running)浏览器访问http://服务器IP出 Web 界面。要注意包管理器装好后配置在/etc/ntfy/server.yml改完执行sudo systemctl restart ntfy才生效生产环境建议再挂一层 Nginx 反代做 HTTPS。路径 B本地源码编译开发者# 克隆仓库含 Web 前端与文档的完整构建较慢见 make help git clone https://gitcode.com/GitHub_Trending/nt/ntfy cd ntfy make build ./dist/ntfy_linux_server/ntfy serve --listen-http :8080验证http://localhost:8080能打开 Web 界面。注意make build会连同 Web 应用和文档一起构建耗时较长若只需服务端二进制可用make cli-linux-server跳过前端。故障排查清单80 端口被占容器起不来——先用sudo lsof -i :80找出占用进程改映射端口-p 8080:80或停掉冲突服务再docker ps | grep ntfy确认状态为 Up。HTTPS 配了但不生效——必须同时设置监听地址与证书三项缺一不可listen-https: :443、cert-file: 证书路径、key-file: 私钥路径见 server/server.yml改完执行sudo systemctl restart ntfy用curl -I https://你的域名返回 200 即通。手机收不到通知——通常是防火墙挡了 80/443或手机与服务器不在互通网络。先sudo lsof -i :80确认端口在监听再检查云控制台/iptables 入站规则与手机所处网络局域网/蜂窝。重启后历史消息没了——没配磁盘缓存消息只存内存。按第二步加上cache-file并挂好卷systemd 安装则建议用/var/cache/ntfy/cache.db并chown ntfy.ntfy该文件。怎么选 下一步部署方式适用场景优势复杂度Docker 容器家庭服务器 / 测试环境一条命令起、隔离好、升级方便⭐⭐系统包管理apt/rpm生产服务器 / 云主机开机自启、随系统更新、日志接入 journal⭐⭐⭐源码编译开发调试 / 定制需求可用最新特性、可改可测⭐⭐⭐⭐跑通之后的三件事访问控制ntfy 主题本身即密码公网部署务必用auth-file/auth-access收紧权限详见 docs/config.md生态集成Grafana、Home Assistant、Uptime Kuma 等都能直接对接清单在 docs/integrations.mdAPI 开发自定义客户端只需读懂发布与订阅两个方向分别见 docs/publish.md 与 docs/subscribe/api.md【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考