青龙面板很多人是冲着 PT 签到装的，装完跑一个签到脚本就扔在那里吃灰。其实它本质上就是一台带可视化界面的“定时任务服务器”：能跑脚本、能定 cron、能看日志、能发通知。签到只是它最不起眼的一种用法。这篇是之前那篇 PT 签到文的进阶篇，讲讲青龙在群晖 NAS 上除了签到，还能替你自动干哪些正经事，以及哪些坑别踩。
青龙到底是什么，先说清楚
青龙面板（Qinglong）是一个支持 Python、Node.js、Shell 等多种脚本的定时任务管理面板。你可以把它理解成“带界面的 crontab + 脚本仓库 + 日志查看器”：脚本往里一贴，执行时间用 cron 表达式一填，跑没跑、跑出什么结果，都能在面板里直接看到。
它适合干的活有一个共同点：重复、定时、不需要人盯着。签到符合，备份、清理、巡检、提醒也都符合。反过来，需要交互、需要实时响应的活（比如远程桌面、在线聊天）就不适合它，别硬塞。
如果你已经装过青龙，直接跳到下一节；还没装的，先用下面这段 Compose 在群晖 Container Manager 里起一个。
Docker 一键部署
在群晖上新建一个项目，docker-compose.yml 如下：
services:
qinglong:
image: whyour/qinglong:latest
container_name: qinglong
restart: unless-stopped
ports:
- "5700:5700"
volumes:
- ./data:/ql/data
environment:
- QlBaseUrl=/部署要点只有三条：
- 数据卷
./data一定要映射出来，否则容器一删，脚本、定时任务、环境变量全没了； - 端口 5700 别和已有服务冲突，冲突就改左侧端口，比如
5701:5700； - 首次打开
http://群晖IP:5700，按向导设好账号密码和通知方式（推荐 Bark 或邮件，巡检告警全靠它）。
部署完先别急着往里塞脚本，先把下面这套“进阶用法”想清楚：你到底想让它替你省哪几件事。
进阶用法一：多站点签到聚合，不止 PT
PT 签到是起点，不是终点。很多论坛、网盘、工具站都有每日签到或每日任务，逻辑大同小异：登录、请求签到接口、判断返回结果、失败发通知。
进阶的做法不是一个站点写一个脚本到处复制，而是一个脚本管一类站点：把账号、Cookie、签到地址放进青龙的环境变量，脚本只读变量不写死账号。新增一个站点，只加一组变量，不用改代码。
实测步骤：
- 在青龙「环境变量」里新建变量，如
SITE_COOKIE、SITE_SIGN_URL； - 在「定时任务」里新建任务，命令填
task 脚本名.py，cron 填0 8 * * *（每天 8 点跑）； - 手动点一次「运行」，看日志里是“签到成功”还是“已签到”，确认无误再交给定时。
提醒一句：签到脚本只用在你自己有账号、且站点规则允许自动签到的地方。有的站点明文禁止脚本签到，封号风险自担，别为了几个积分把主力账号搭进去。
进阶用法二：NAS 自动运维，清理与备份交给它
群晖用久了最常见的两件事：磁盘被 Docker 镜像、日志、缓存慢慢吃满；青龙自己的配置、脚本改了半天没备份。这两件都可以交给青龙自己干。
定时清理 Docker 悬空镜像和日志，每周跑一次 Shell 脚本：
#!/bin/bash
# 每周清理一次悬空镜像，保留最近 7 天日志
docker image prune -f
find /var/log -type f -name "*.log" -mtime +7 -delete 2>/dev/null
echo "清理完成：$(date)"注意：这条脚本要在能访问 Docker 的宿主机定时任务里跑，或者把 Docker 套接字挂载进青龙容器——新手更稳妥的做法是把清理脚本放在群晖「任务计划」里，青龙只负责发提醒、记日志。别在没看懂命令的情况下直接 prune -a，会把没在运行的镜像也清掉，下次启动容器要重新拉取。
定时备份青龙自身：把 /ql/data 打包一份，拷到群晖的备份目录或异地备份路径。备份方案本身可以参考本站的 3-2-1 备份思路：本地一份、快照一份、异地一份，青龙数据虽小，丢了却最麻烦——因为所有定时任务都在里面。
进阶用法三：服务存活巡检，挂了第一时间知道
Uptime Kuma 是专门的监控面板，青龙则适合做“轻量巡检 + 动作联动”。比如每 10 分钟 curl 一次家里的几个关键地址：博客首页、图床、NAS 的 Web Station 页面，状态码不是 200 就通过 Bark 推送告警。
import requests
URLS = [
"https://www.yeyhome.com/",
"http://群晖内网IP:5000/",
]
for url in URLS:
try:
r = requests.get(url, timeout=10)
print(url, r.status_code)
except Exception as e:
print(f"告警：{url} 访问失败 {e}")把告警逻辑接上通知渠道后，巡检就从“偶尔想起来看一眼”变成了“挂了手机立刻响”。它和 Uptime Kuma 不冲突：Kuma 看得细、看板好看，青龙胜在顺手——巡检发现问题后，可以直接在同一个面板里再跑一个重启、清理脚本，形成“发现—处理”的闭环。
进阶用法四：定时提醒与数据汇总
还有一类活，青龙做起来比手机闹钟靠谱：每天固定时间汇总一件事，推到你面前。
- 每天早上 8 点，把昨天各站点的签到结果汇总成一条推送；
- 每周一，把 NAS 磁盘占用、Docker 容器状态汇总成一条周报；
- 每月 1 号，提醒自己检查证书到期、域名续费、VPS 账单——这些事不难，难的是记得。
实现方式都一样：脚本跑完把结果拼成一句话，调用 Bark 或邮件通知接口发出去。关键是只推值得看的：巡检正常时别天天推“一切正常”，只在异常或汇总节点推，否则推送一多，人就自动忽略了，等于没装。
进阶用法五：脚本管理规范，别让面板变成垃圾场
青龙用半年，面板里脚本一多就乱。进阶玩家的分水岭不在脚本写得多花哨，而在管理得干不干净。我的规矩是四条：
- 命名规范：
站点_用途.py，如pt_sign.py、nas_cleanup.sh，一眼知道干什么； - 变量与代码分离：账号、Cookie、Webhook 地址一律放环境变量，脚本里不出现明文密钥，分享、迁移都不怕；
- 依赖单独记：Python 脚本用到的第三方库，在青龙「依赖管理」里装好并记在脚本头部注释里，换机器重装不抓瞎；
- 日志定期清：青龙日志默认越攒越大，定时任务里加一条每月清理旧日志的任务，别等磁盘告警才想起来。
避坑清单：这几条都是实测踩过的
- 时区先对齐：青龙容器时区默认可能是 UTC，cron 按 UTC 跑，想每天 8 点跑却 16 点才跑，先检查容器时区和群晖时区是否一致；
- 别跑来路不明的脚本：网上“复制粘贴即用”的青龙脚本，先看它读了哪些变量、往外发了什么请求，再决定跑不跑；要你填账号密码的脚本，先确认它发到哪里；
- 失败要通知：定时任务只设成功路径等于没设，脚本里把异常分支也接上通知，跑失败了你得知道；
- 先手动跑一次：任何新任务上线前，先手动运行一次、看日志、确认输出，再交给定时。直接上定时，出问题都不知道是哪天开始坏的；
- 别用青龙干重活：转码、压缩、大文件同步这类吃 CPU 和 IO 的活，交给群晖任务计划或专门工具，青龙只做轻量调度。
怎么卸载：干净收尾
哪天不想用了，卸载分两步：先停容器、删容器，再决定数据卷留不留。
docker compose down
# 数据也不要了，再加 -v：
# docker compose down -v只 down 不加 -v，数据卷还在，以后重新 up 还能恢复；确认彻底不用，再加 -v 连数据一起清掉。卸载前如果脚本里有自己写的通用工具，先导出一份存到群晖的文档目录，别跟着容器一起删了。
结语
青龙的价值不在它能跑多少脚本，而在它把“每天、每周、每月都要做一次的小事”从你的脑子里接过去。PT 签到只是入门，从签到聚合、NAS 运维、服务巡检到定时汇总，一台群晖 + 一个青龙，就能搭起一套不用人盯着的家庭自动化小中枢。先从一个巡检任务开始跑通，跑稳了再往上加，别一次塞十个脚本——自动化最怕的不是少，而是乱。
相关旧文：
评论 (0)