青龙面板通知设置全攻略:Bark/Server酱/钉钉/企业微信怎么配
青龙面板把签到脚本跑起来了,然后呢?脚本跑完、成功还是失败、京东豆到账没有——你总不能天天打开面板看日志。
通知配置就是干这个的:脚本跑完自动推送到手机,成功失败一眼就知道。这篇把青龙支持的推送渠道全部过一遍,含具体配置方法,照着填就行。
青龙面板部署和签到可以看站内这两篇打底:告别手动签到!利用青龙面板实现 24 小时全自动工作流、青龙面板拉库保姆级教程。
一、先搞清楚:青龙通知配置在哪
青龙面板的通知配置在配置文件 config.sh 里(部署目录下的 data/config/config.sh,或容器内 /ql/config/config.sh)。
打开后你能看到一长串 export 变量名="" 的配置行,注释里写清楚了每个渠道怎么填。配置方法:把对应变量的引号里填上你的 Key → 保存 → 重启青龙容器(或执行 ql reload)→ 测试。
二、通知渠道横向对比
| 渠道 | 手机端体验 | 配置难度 | 推荐度 |
|---|---|---|---|
| Bark | iOS 原生推送,体验最好 | ★☆☆☆☆ | ⭐⭐⭐⭐⭐ |
| Server酱 | 微信推送 | ★★☆☆☆ | ⭐⭐⭐⭐ |
| 钉钉机器人 | 钉钉 App 推送 | ★★☆☆☆ | ⭐⭐⭐⭐ |
| 企业微信机器人 | 企业微信推送 | ★★☆☆☆ | ⭐⭐⭐ |
| Telegram Bot | TG 推送 | ★★★☆☆(需代理) | ⭐⭐⭐ |
| Push Plus | 微信推送 | ★★☆☆☆ | ⭐⭐⭐ |
| iGot 聚合 | 聚合多端 | ★★★☆☆ | ⭐⭐ |
个人最推荐 Bark(iOS)或 Server酱(安卓/微信用户),配置最简单,推送最稳定。
三、Bark 配置(iOS 首选)
Bark 是 iOS 上的开源推送工具,原理简单:给手机上的 Bark App 一个设备码,任何脚本都能往你的 iPhone 发推送。
步骤:
- iPhone 上安装 Bark(App Store 搜 Bark)
- 打开后首页会显示一个专属地址,形如
https://api.day.app/你的设备码 - 在青龙
config.sh里填:
export BARK_PUSH="你的设备码"export BARK_ICON="https://qn.whyour.cn/logo.png"export BARK_GROUP="QingLong"export BARK_SOUND=""- 保存,重启青龙容器
- 测试:执行任意签到脚本,手机应收到推送
可选参数:
BARK_SOUND:推送铃声,在 Bark 里查看可用值BARK_LEVEL:推送时效性,active为立即提醒(默认)BARK_URL:点击推送跳转的 URL
四、Server酱 配置(微信推送)
Server酱(方糖)能把消息推到你的微信。注意 ServerChan 老版(Turbo 版之前)已停用,现在用 Server酱³(SC3)。
步骤:
- 打开 https://sct.ftqq.com,用 GitHub 登录
- 扫码关注公众号绑定微信,获取 SendKey
- 在青龙
config.sh里填:
export PUSH_KEY="你的SendKey"- 保存重启,测试脚本即可收到微信推送
五、钉钉机器人配置
适合用钉钉办公、想要消息进钉钉群的人。
步骤:
- 钉钉群里 → 群设置 → 智能群助手 → 添加机器人 → 自定义机器人
- 添加时设置关键词(比如”青龙”),拿到 Webhook 地址
- Webhook 形如
https://oapi.dingtalk.com/robot/send?access_token=XXXX,把=后面的部分填进青龙:
export DD_BOT_TOKEN="XXXX" # access_token= 后面的内容export DD_BOT_SECRET="SECxxxx" # 加签模式的密钥(若开启了加签)- 保存重启,测试脚本推送
六、企业微信机器人配置
步骤:
- 企业微信群里 → 添加群机器人,拿到 Webhook 地址
- Webhook 形如
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXXX,把 key 填进:
export QYWX_KEY="XXXX"- 保存重启即可
七、Telegram Bot 配置
TG 推送适合重度 TG 用户,但国内需要代理(青龙面板的 TG 代理配置也一并说明)。
步骤:
- 在 TG 里 @BotFather,发送
/newbot,按提示创建机器人,拿到 Token(形如10xxx4:AAFcqxxxxgER5uw) - 给 @userinfobot 发消息,获取你的 纯数字 User ID
- 青龙
config.sh里填:
export TG_BOT_TOKEN="10xxx4:AAFcqxxxxgER5uw"export TG_USER_ID="123456789"- 国内环境还需要配置代理:
export TG_PROXY_HOST="127.0.0.1"export TG_PROXY_PORT="1080"# 如果代理需要认证再加下面两行export TG_PROXY_AUTH="user:password"- 保存重启,测试推送
八、Push Plus 配置(微信备选)
- 打开 https://www.pushplus.plus,微信扫码登录
- 获取 token(个人中心 → 一对一推送的 token)
- 青龙里填:
export PUSH_PLUS_TOKEN="你的token"export PUSH_PLUS_USER=""- 保存重启测试
九、配置后必须做的事
- 重启生效:改完
config.sh保存后,重启青龙容器或执行docker restart qinglong - 跑一次脚本测试:随便运行一个签到脚本,确认手机能收到推送
- 多个渠道可以同时开:比如 Bark + Server酱都填,消息会同时推多个端,一个失效还有备份
- 推送内容确认:青龙的通知会包含脚本名称、运行状态(成功/失败/异常)、耗时,一眼就知道结果
常见问题
Q1:填了配置但收不到推送?
- 检查是否重启了容器(改配置不重启不生效)
- 检查 Key 是否填错(尤其钉钉是
=号后面部分,别整段填) - 打开青龙面板 → 系统设置 → 看通知测试按钮,直接测试渠道是否通
Q2 收不到?
检查设备码是否完整;Bark 国内直连一般没问题,若不行换 Server酱。
Q3:多个渠道要关掉某个?
把对应变量清空(改成空字符串)再重启即可。
Q4:想自定义通知内容?
青龙的通知逻辑在 data/scripts/notify.py(或容器内 /ql/scripts/notify.py),有 Python 基础可以改模板,但新手不建议动,默认内容够用。
相关阅读
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!