5分钟让定时任务自动更新：青龙订阅配置完整指南-开发者社区

5分钟让定时任务自动更新：青龙订阅配置完整指南

【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong

周五晚上改完一个巡检脚本，公司其余 6 台青龙里的定时任务还是旧版本——逐台登录复制粘贴的场景，正是自动化订阅要消除的：只需把仓库地址填进配置，平台会按期拉取最新脚本并自动登记为任务。这篇青龙面板使用教程，带你在 5 分钟内跑通第一个订阅。

一句话看懂：自动化订阅到底做了什么

青龙的订阅就像软件里的"自动更新"机制：你把一个远程地址指给它，它按期自己去取回最新脚本、覆盖旧版本，并把新脚本登记进定时任务列表。你只需维护一个"中心仓库"，每台青龙实例负责"永远跟到最新版"，不用再登录服务器手工搬文件。

配置项覆盖三类来源（公开仓库、私有仓库、单文件）、两种同步节奏（crontab 表达式或每隔 N 分/时/天），还支持同步前后的自定义命令。订阅管理前端模块位于 src/pages/subscription/，想核对字段含义可以对照源码。

5分钟跑通第一个订阅：青龙订阅配置五步走

进入订阅管理：在青龙面板侧边栏打开"订阅管理"，点击"创建订阅"。
填写名称与 URL：选择来源类型（公开仓库 / 私有仓库 / 单文件），粘贴仓库地址或脚本文件直链；私有仓库需补充私钥或用户名/Token 作为拉取凭据。
设定分支与过滤规则：指定跟随的分支（留空则用默认分支）；在白名单、黑名单中填写要同步哪些脚本的关键词，多个关键词用竖线分隔，支持正则表达式。
设定同步频率与依赖：选择 crontab 或 interval 设定同步周期（例如每隔 30 分钟一次）；在"依赖文件"栏写入 requirements.txt 等文件，让依赖随仓库一起拉取；确认"自动添加任务 / 自动删除任务"开关符合预期。
触发首次同步并验证：点击一次"执行"，打开订阅日志确认脚本已写入 scripts 目录、任务已登记，之后交给自动同步即可。

落地场景：多台服务器统一更新与新人零配置接入

场景一：多台服务器统一更新监控脚本。团队 12 个节点各跑一台青龙，部署同一批监控脚本。过去每次改脚本要登录 12 台机器逐个替换，一次 3 分钟的修改要花 40 分钟落地。改为统一订阅同一个仓库、每小时同步一次后：改动推上去，各节点一小时内自动取到新版，单次脚本修订的落地时间从约 40 分钟降到 1 分钟内的推送动作，节点间版本不一致的问题也随之消失。

场景二：新人零配置接入团队任务库。以前新同事入职要逐一交接 20 多个脚本文件，再手工配置 cron，半天才能跑起来。改为订阅后，新人只需在自己青龙面板填一次团队任务库地址加白名单，首次同步后脚本、依赖、定时任务自动就位，接入时间从半天压缩到 10 分钟，也避免了漏交文件。

进阶玩法：过滤规则怎么写

白名单正则收窄范围：白名单填写^(backup|monitor|report)\.(js|py|sh|ts)$。效果：只同步这三类脚本，大仓库里其余几百个文件一概不拉，订阅公共仓库也能只取所需。
依赖文件随同预装：在"依赖文件"栏写requirements.txt|package.json。效果：脚本更新的同时依赖清单一并拉取，任务不会因缺包报错。
多订阅源分层管理：建多个订阅，一个指向核心框架仓库、一个指向业务脚本仓库，各自白名单只取自己的目录。效果：脚本模块化、独立变更，业务侧迭代不牵连框架侧。