项目介绍
Message Nest(信息巢)是自托管的消息推送整合平台。业务脚本只调用一个发送入口,由它把消息分发到邮件、钉钉、企业微信、飞书、Telegram、Gotify、ntfy 等渠道,减少在每个项目里重复编写通知代码。
它把渠道连接、消息模板和发送记录集中管理。相同的“任务完成”模板可以填入不同的任务名称、耗时和结果;后续改文案时,优先修改模板,不必逐一修改调用脚本。
核心功能
| 功能 | 说明 |
|---|---|
| 渠道集中管理 | 在一处维护邮件、聊天机器人和 Webhook 等发送渠道。 |
| 消息模板 | 把固定文案与动态变量分开,多个任务复用同一模板。 |
| 统一发送入口 | 业务脚本调用平台 API,再由平台向已配置渠道分发。 |
| 发送记录 | 追踪消息调用与渠道返回,定位失败环节。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | NAS 与运维 |
| 项目仓库 | engigu/Message-Push-Nest |
| 整理日期 | 2026-11-14 |
安装与使用步骤
部署前先选运行方式
仓库提供容器和 Release 等使用路线。个人少量通知可以先使用文档支持的轻量数据库方案;已有 MySQL 环境时,再选择对应数据库配置。数据库连接信息必须与所选部署方案一致,不能把不同版本的配置字段拼到一起。
首次启动后先完成管理员初始化,保存项目配置和数据目录。不要一开始同时接入所有渠道:先选一个自己能立即接收消息的渠道,验证完整链路后再添加第二个。
群晖单实例 Compose
下面使用官方容器支持的 SQLite 方案,数据库保存在 /app/conf,JWT 密钥由准备命令生成并保留已有值:
sudo sh <<'MESSAGE_NEST_PREPARE'
set -eu
mkdir -p /volume1/docker/message-nest/conf
cd /volume1/docker/message-nest
umask 077
touch .env
if ! grep -q '^MESSAGE_NEST_JWT=.' .env; then
generated_secret=$(openssl rand -hex 32)
printf 'MESSAGE_NEST_JWT=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
MESSAGE_NEST_PREPARE
cd /volume1/docker/message-nest
在项目目录保存 compose.yaml:
services:
message-nest:
image: ghcr.io/engigu/message-nest:latest
restart: unless-stopped
ports:
- "8018:8000"
environment:
DB_TYPE: sqlite
JWT_SECRET: "${MESSAGE_NEST_JWT}"
LOG_LEVEL: INFO
TZ: Asia/Shanghai
volumes:
- /volume1/docker/message-nest/conf:/app/conf
依次执行 sudo docker compose config --quiet、sudo docker compose up -d、sudo docker compose logs --tail=100 message-nest,再打开 http://群晖IP:8018。按当前版本的首次登录说明进入后台并设置自己的密码。应用内部保持 8000,端口冲突时只改 8018:8000 左侧。
以后改用 MySQL 或 PostgreSQL 时,先做完整数据备份,再按对应迁移方式处理;只修改 DB_TYPE 不会自动把原 SQLite 数据复制过去。
从一条测试通知开始
- 在渠道管理中创建一个测试渠道,填写它自己的服务器地址、收件人或 Webhook 凭据。邮件还要核对 SMTP 端口和 TLS 方式;机器人渠道则核对目标群或用户。
- 发送一条不含变量的短消息,确认目标设备实际收到,记录到达时间。
- 创建“任务完成”模板,先放任务名和状态两个变量;在预览或测试发送时,逐项检查变量是否被替换。
- 使用当前实例文档中的 API 地址和鉴权方式调用这个模板。先用手动请求成功,再放进定时任务,避免同时排查脚本和通知平台。
- 查看发送记录,把请求接收、队列处理和渠道实际送达分开检查。接口返回成功但手机没提示时,还要看渠道响应及客户端通知设置。
- 最后设置失败重试和调用频率,避免一个持续报错的任务短时间内推送数百条消息。
日常维护与排错
模板里原样出现占位符,通常需要检查变量名称和当前模板接口版本;只在某个渠道失败,优先核对它的密钥、额度与接收目标;全部渠道都失败,再检查应用日志、数据库和外网连接。
备份要包含数据库、应用配置及恢复凭据所需的密钥。迁移后先向测试目标发一条消息,再恢复业务调用,避免迁移当天集中重复发送旧通知。
更新与备份
保存渠道、模板、任务记录和数据库,外部渠道的密钥单独保护。