青龙使用教程：从依赖安装到脚本运行全流程

对于使用青龙面板进行 DailyCheckin 等自动化任务的用户来说，清晰的操作流程是避免出错的关键。本文将从依赖安装、配置文件设置、脚本运行到版本更新，一步步带你完成青龙面板的核心配置，尤其适合刚接触青龙面板的新手。

一、依赖安装

依赖是青龙面板运行脚本的 “前置条件”，需要分别安装 Linux 系统依赖和 Python 依赖，两者缺一不可。

1.1 安装 Linux 依赖

Linux 依赖主要解决脚本编译和系统调用相关的问题，具体步骤如下：

进入青龙面板，在左侧菜单栏找到并点击「依赖管理」。
在「依赖管理」页面顶部，切换到「Linux」选项卡，然后点击「新建依赖」按钮。
在弹出的输入框中，复制粘贴以下依赖名称：gcc g++ make libffi-dev openssl-dev，“自动拆分” 选择「是」，备注可留空。
点击「确定」，等待系统自动安装，安装完成后状态会显示 “已安装”。

1.2 安装 Python 依赖

Python 依赖是 DailyCheckin 脚本的核心依赖，步骤如下：

同样在「依赖管理」页面，切换到「Python3」选项卡，点击「新建依赖」。
在 “名称” 输入框中直接输入：dailycheckin，“自动拆分” 保持「是」。
点击「确定」，等待安装完成，此时「Python3」依赖列表中会新增一条 “dailycheckin” 的记录，状态为 “已安装”。

二、配置文件

配置文件（config.json）是控制脚本运行的 “核心开关”，需要设置推送通知、账号信息等关键参数，且必须保证格式正确。

2.1 新建 config.json 文件

在青龙面板左侧菜单栏，点击「脚本管理」。
点击页面中的「新建」按钮，在 “文件名” 中输入：config.json，“父目录” 选择「根」，点击「确定」。

2.1.1 新建 config.json 文件

示例文件：以下是一份默认的 config.json 配置文件，你可以直接复制到你的 config.json 文件中，然后修改其中的参数。

{
  "BARK_URL": "",
  "COOLPUSHEMAIL": true,
  "COOLPUSHQQ": true,
  "COOLPUSHSKEY": "",
  "COOLPUSHWX": true,
  "DINGTALK_ACCESS_TOKEN": "",
  "DINGTALK_SECRET": "",
  "FSKEY": "",
  "PUSHPLUS_TOKEN": "",
  "PUSHPLUS_TOPIC": "",
  "QMSG_KEY": "",
  "QMSG_TYPE": "",
  "QYWX_AGENTID": "",
  "QYWX_CORPID": "",
  "QYWX_CORPSECRET": "",
  "QYWX_KEY": "",
  "QYWX_MEDIA_ID": "",
  "QYWX_TOUSER": "",
  "SCKEY": "",
  "SENDKEY": "",
  "TG_API_HOST": "",
  "TG_BOT_TOKEN": "",
  "TG_PROXY": "",
  "TG_USER_ID": "",
  "MERGE_PUSH": "",
  "ACFUN": [
    {
      "password": "Sitoi",
      "phone": "18888xxxxxx"
    },
    {
      "password": "多账号 密码填写，请参考上面",
      "phone": "多账号 手机号填写，请参考上面"
    }
  ],
  "ALIYUN": [
    {
      "refresh_token": "599dcf65xxxxxx"
    },
    {
      "refresh_token": "多账号 refresh_token"
    }
  ],
  "AOLAXING": [
    {
      "cookie": "BT_AUTO_tt_common=; Hm_lpvt_7fc3681c21a26a2022ae0ca72e2d6fa5=xxxxxx; BT_LOGIN_tt_common=:187xxxxxx; Hm_lvt_7fc3681c21a26a2022ae0ca72e2d6fa5=xxxxxx;"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "BAIDU": [
    {
      "data_url": "https://fastly.jsdelivr.net/gh/Sitoi/Sitoi.github.io/baidu_urls.txt",
      "submit_url": "http://data.zz.baidu.com/urls?site=https://sitoi.cn&token=xxxxxx",
      "times": 10
    },
    {
      "data_url": "多账号 data_url 链接地址，以实际获取为准",
      "submit_url": "多账号 submit_url 链接地址，以实际获取为准",
      "times": 10
    }
  ],
  "BAIDUWP": [
    {
      "cookie": "BAIDUID=xxx:FG=1; BAIDUID_BFESS=xxx:FG=1; xxx"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "BILIBILI": [
    {
      "coin_num": 0,
      "coin_type": 1,
      "cookie": "_uuid=xxxxxx; rpdid=xxxxxx; LIVE_BUVID=xxxxxx; PVID=xxxxxx; blackside_state=xxxxxx; CURRENT_FNVAL=xxxxxx; buvid3=xxxxxx; fingerprint3=xxxxxx; fingerprint=xxxxxx; buivd_fp=xxxxxx; buvid_fp_plain=xxxxxx; DedeUserID=xxxxxx; DedeUserID__ckMd5=xxxxxx; SESSDATA=xxxxxx; bili_jct=xxxxxx; bsource=xxxxxx; finger=xxxxxx; fingerprint_s=xxxxxx;",
      "silver2coin": true
    },
    {
      "coin_num": 0,
      "coin_type": 1,
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）",
      "silver2coin": true
    }
  ],
  "ENSHAN": [
    {
      "cookie": "fpv=xxxxxx; yd_captcha_token=xxxxxx; _dx_captcha_cid=xxxxxx; _dx_uzZo5y=xxxxxx; _dx_FMrPY6=xxxxxx; _dx_app_captchadiscuzpluginbydingxiang2017=xxxxxx; TWcq_2132_pc_size_c=0; TWcq_2132_saltkey=xxxxxx; TWcq_2132_lastvisit=xxxxxx; TWcq_2132_sendmail=1; _dx_captcha_vid=xxxxxx; TWcq_2132_sid=Wyv5Ps; TWcq_2132_ulastactivity=xxxxxx; TWcq_2132_auth=xxxxxx; TWcq_2132_lastcheckfeed=xxxxxx; TWcq_2132_lip=xxxxxx; TWcq_2132_connect_is_bind=1; TWcq_2132_nofavfid=1; TWcq_2132_lastact=xxxxxx"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "IMAOTAI": [
    {
      "city": "上海市",
      "lat": "3.025626",
      "lng": "3.025626",
      "mobile": "18888xxxxxx",
      "province": "上海市",
      "token": "eyJxxxxxx",
      "userid": "1xxxxxx4"
    },
    {
      "city": "多账号 城市",
      "lat": "多账号 纬度",
      "lng": "多账号 经度",
      "mobile": "多账号 手机号",
      "province": "多账号 省份",
      "token": "多账号 token",
      "userid": "多账号 用户 id"
    }
  ],
  "IQIYI": [
    {
      "cookie": "__dfp=xxxxxx; QP0013=xxxxxx; QP0022=xxxxxx; QYABEX=xxxxxx; P00001=xxxxxx; P00002=xxxxxx; P00003=xxxxxx; P00007=xxxxxx; QC163=xxxxxx; QC175=xxxxxx; QC179=xxxxxx; QC170=xxxxxx; P00010=xxxxxx; P00PRU=xxxxxx; P01010=xxxxxx; QC173=xxxxxx; QC180=xxxxxx; P00004=xxxxxx; QP0030=xxxxxx; QC006=xxxxxx; QC007=xxxxxx; QC008=xxxxxx; QC010=xxxxxx; nu=xxxxxx; __uuid=xxxxxx; QC005=xxxxxx;"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "KGQQ": [
    {
      "cookie": "muid=xxxxxx; uid=xxxxxx; userlevel=xxxxxx; openid=xxxxxx; openkey=xxxxxx; opentype=xxxxxx; qrsig=xxxxxx; pgv_pvid=xxxxxx;"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "MIMOTION": [
    {
      "max_step": "20000",
      "min_step": "10000",
      "password": "Sitoi",
      "phone": "18888xxxxxx"
    },
    {
      "max_step": "多账号 最大步数填写，请参考上面",
      "min_step": "多账号 最小步数填写，请参考上面",
      "password": "多账号 密码填写，请参考上面",
      "phone": "多账号 手机号填写，请参考上面"
    }
  ],
  "SMZDM": [
    {
      "cookie": "__ckguid=xxxxxx"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "TIEBA": [
    {
      "cookie": "BIDUPSID=xxxxxx; PSTM=xxxxxx; BAIDUID=xxxxxx; BAIDUID_BFESS=xxxxxx; delPer=xxxxxx; PSINO=xxxxxx; H_PS_PSSID=xxxxxx; BA_HECTOR=xxxxxx; BDORZ=xxxxxx; TIEBA_USERTYPE=xxxxxx; st_key_id=xxxxxx; BDUSS=xxxxxx; BDUSS_BFESS=xxxxxx; STOKEN=xxxxxx; TIEBAUID=xxxxxx; ab_sr=xxxxxx; st_data=xxxxxx; st_sign=xxxxxx;"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ],
  "V2EX": [
    {
      "cookie": "_ga=xxxxxx; __cfduid=xxxxxx; PB3_SESSION=xxxxxx; A2=xxxxxx; V2EXSETTINGS=xxxxxx; V2EX_REFERRER=xxxxxx; V2EX_LANG=xxxxxx; _gid=xxxxxx; V2EX_TAB=xxxxxx;",
      "proxy": "使用代理的信息，无密码例子: http://127.0.0.1:1080 有密码例子: http://username:password@127.0.0.1:1080"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）",
      "proxy": "使用代理的信息，无密码例子: http://127.0.0.1:1080 有密码例子: http://username:password@127.0.0.1:1080"
    }
  ],
  "YOUDAO": [
    {
      "cookie": "JSESSIONID=xxxxxx; __yadk_uid=xxxxxx; OUTFOX_SEARCH_USER_ID_NCOO=xxxxxx; YNOTE_SESS=xxxxxx; YNOTE_PERS=xxxxxx; YNOTE_LOGIN=xxxxxx; YNOTE_CSTK=xxxxxx; _ga=xxxxxx; _gid=xxxxxx; _gat=xxxxxx; PUBLIC_SHARE_18a9dde3de846b6a69e24431764270c4=xxxxxx;"
    },
    {
      "cookie": "多账号 cookie 填写，请参考上面，cookie 以实际获取为准（遇到特殊字符如双引号\" 请加反斜杠转义）"
    }
  ]
}

2.2 编辑配置文件内容

在「脚本管理」列表中找到刚创建的config.json，点击右侧的「编辑」按钮。
参考以下核心配置项进行修改（需根据自身需求调整，关键参数说明如下）：
- 推送通知配置：如 BARK_URL（Bark 推送地址）、PUSHPLUS_TOKEN（PushPlus 令牌）、SCKEY（Server 酱密钥）等，填写后脚本运行结果会自动推送。
- 账号信息配置：如 ACFUN（AcFun 账号）需填写 “phone”（手机号）和 “password”（密码），多账号可按格式添加多个对象；ALIYUN（阿里云）需填写 “refresh_token”。
- 其他配置：如 BAIDU（百度推送）需设置 “data_url”（链接列表地址）和 “submit_url”（百度推送接口）。
配置完成后，务必前往 https://www.json.cn/ 网站，将配置内容复制进去检查格式是否正确，避免因语法错误导致脚本运行失败。
确认格式无误后，点击青龙面板中的「保存」按钮，退出编辑。

三、脚本运行

配置完成后，可通过 “运行全部脚本”“指定包含脚本”“指定排除脚本” 三种方式运行，满足不同场景需求。

3.1 运行全部脚本

适合需要执行 DailyCheckin 所有支持的脚本（如签到、数据统计等），步骤如下：

进入青龙面板「定时任务」页面，点击「新建定时」。
填写任务信息：
- 名称：可自定义，如 “dailycheckin – 全部运行”。
- 命令：task dailycheckin。
- 定时规则：按需求设置，例如 “0 9 * * *” 表示每天 9 点运行一次。
点击「确定」，任务创建后可手动点击「运行」按钮测试效果。

3.2 运行指定包含的脚本

适合只需要执行部分脚本（如仅运行 B 站和小米运动脚本），步骤如下：

新建定时任务，名称自定义（如 “dailycheckin – 指定运行”）。
命令填写：task dailycheckin --include MIMOTION BILIBILI（其中 “MIMOTION”“BILIBILI” 为脚本名称，多个脚本用空格分隔）。
定时规则按需设置（如 “45 8 * * *” 表示每天 8 点 45 分运行），点击「确定」即可。

3.3 运行指定排除的脚本

适合需要排除部分脚本（如不运行小米运动脚本），步骤如下：

新建定时任务，名称自定义（如 “dailycheckin – 排除运行”）。
命令填写：task dailycheckin --exclude MIMOTION（排除单个脚本）或task dailycheckin --exclude MIMOTION BILIBILI（排除多个脚本，空格分隔）。
定时规则按需设置，点击「确定」完成创建。

四、版本更新

DailyCheckin 脚本会定期更新功能和修复问题，建议设置定时任务自动更新，也可手动更新。

4.1 新建自动更新任务

进入青龙面板「定时任务」页面，点击「新建定时」。
填写任务信息：
- 名称：自定义，如 “更新 DailyCheckin”。
- 命令：国内机器推荐使用镜像命令：task pip3 install dailycheckin --upgrade -i https://pypi.mirrors.ustc.edu.cn/simple/；国外机器可直接用：task pip3 install dailycheckin --upgrade。
- 定时规则：建议设置为 “0 0 * * *”（每天 0 点自动更新）。
点击「确定」，任务会按定时规则自动执行更新。

4.2 手动更新（可选）

若需立即更新，可在「定时任务」列表中找到 “更新 DailyCheckin” 任务，点击右侧的「运行」按钮，等待任务执行完成即可。

五、常见问题提示

依赖安装失败：检查网络是否正常，若国内机器可尝试切换镜像源；
脚本运行报错：优先检查 config.json 格式是否正确（通过json.cn验证），再确认账号信息是否填写无误；
推送通知没收到：检查推送令牌（如 PUSHPLUS_TOKEN）是否填写正确，且推送平台是否正常运行。

青龙面板常用命令汇总表

命令用途	具体命令	适用场景
安装 Python 依赖	`pip3 install 依赖名称`（如`pip3 install dailycheckin`）	手动安装单个 Python 依赖，适用于「依赖管理」页面安装失败时补充操作
升级 Python 依赖	`pip3 install 依赖名称 --upgrade`（如`pip3 install dailycheckin --upgrade`）	手动升级指定依赖，可替代自动更新任务，用于紧急更新场景
国内镜像安装 / 升级依赖	pip3 install 依赖名称 -i https://pypi.mirrors.ustc.edu.cn/simple/	解决国内机器安装依赖超时问题，如`pip3 install dailycheckin -i 镜像地址`
运行全部 DailyCheckin 脚本	task dailycheckin	在「定时任务」中创建基础任务，执行所有支持的签到、数据推送脚本
运行指定脚本（包含）	`task dailycheckin --include 脚本1 脚本2`（如`task dailycheckin --include BILIBILI ACFUN`）	仅执行需要的脚本，减少不必要的运行步骤，如只运行 B 站和 AcFun 签到
运行指定脚本（排除）	`task dailycheckin --exclude 脚本1 脚本2`（如`task dailycheckin --exclude MIMOTION`）	排除不需要的脚本，如不执行小米运动相关脚本
查看脚本运行日志	`cat /ql/log/task_dailycheckin.log`（需在面板「终端」中执行）	脚本运行失败时，查看详细错误信息，定位问题原因（如账号错误、配置格式问题）
强制重新拉取脚本	`ql repo https://github.com/sitoi/dailycheckin.git “dailycheckin” “” “sendNotify	notify