告别手动签到！利用青龙面板实现 24 小时全自动工作流（附避坑指南）

为什么你需要青龙面板？#

在数字化生活中，我们常被各种琐碎的重复任务包围：每日签到领取京豆、各种云盘的容量扩容任务、甚至是个人的天气提醒脚本。手动操作费时费心，普通的定时任务又缺乏直观的管理界面和依赖管理环境。青龙面板（Whyour/Qinglong） 的出现，彻底解决了自动化脚本“运行难、管理乱、环境碎”的痛点。它是一个支持 Python3、JavaScript、Shell、TypeScript 的定时任务管理平台，让你在一个 Web 界面内就能掌控所有的自动化工作流。

核心功能拆解#

全图形化任务管理：告别枯燥的 crontab 命令行。通过 Web UI 即可实现脚本的增删改查、手动运行以及实时日志查看。
强大的环境依赖管理：内置完善的依赖安装功能。无论是 Node.js 的 npm 包，还是 Python 的 pip 库，均可在面板内一键安装，无需反复进入容器后台。
多语言与多仓库支持：原生支持 JS、Python、Shell 等多种脚本语言，并支持直接关联 GitHub/Gitee 仓库进行自动同步更新。
环境变量隔离：通过环境变量管理（Environment Variables）功能，将脚本逻辑与个人账号信息（Cookie/Token）分离，保障脚本的可移植性与安全性。

保姆级部署教程#

推荐使用 Docker 进行部署，这是目前最稳定、迁移成本最低的方式。

方式一：Docker Compose 部署（强烈推荐）#

这种方式便于后期维护和配置修改。

创建目录：

1
mkdir qinglong && cd qinglong

创建 docker-compose.yml 文件：

1
version: '3'
2
services:
3
  qinglong:
4
    image: whyour/qinglong:latest
5
    container_name: qinglong
6
    restart: always
7
    volumes:
8
      - ./config:/ql/data/config
9
      - ./log:/ql/data/log
10
      - ./db:/ql/data/db
11
      - ./scripts:/ql/data/scripts
12
      - ./repo:/ql/data/repo
13
      - ./raw:/ql/data/raw
14
      - ./deps:/ql/data/deps
15
    ports:
16
      - "5700:5700"
17
    environment:
18
      - QL_WSE_PORT=5701

启动容器：

1
docker-compose up -d

方式二：Docker Run 一键部署#

适用于想快速上手的用户。

1
docker run -dit \
2
  -v $PWD/ql/data:/ql/data \
3
  -p 5700:5700 \
4
  --name qinglong \
5
  --hostname qinglong \
6
  --restart unless-stopped \
7
  whyour/qinglong:latest

官方项目地址：https://github.com/whyour/qinglong

保姆级使用场景#

1. 全自动“薅羊毛”中心#

这是青龙面板最火的使用场景。通过拉取现成的脚本仓库（如 JD 签到、B 站任务等），你只需要在环境变量里填入自己的 Cookie。青龙会根据设定的 Cron 表达式（如 0 0 9 * * * 表示每天上午 9 点）自动执行任务，你只需要在手机上收红包或积分到账通知。

2. 个人工作流自动化#

如果你是一名开发者，可以用它定期抓取特定网站的数据、监控 API 状态，或者定期备份服务器数据库。配合 通知渠道（Server酱、Telegram Bot、Pushplus），一旦脚本运行异常或达成特定条件，手机立刻就能收到推送。

避坑指南/小贴士#

端口暴露风险：青龙面板默认使用 5700 端口。强烈建议不要将该端口直接暴露在公网。如果必须公网访问，请务必设置复杂的初始化密码，并配合 Nginx 反向代理增加访问限制。
依赖安装失败：由于网络环境问题，面板内安装依赖可能较慢。建议在安装依赖时切换国内镜像源（如清华源或阿里源）。
资源占用：虽然青龙本身很轻量，但如果同时运行数十个复杂脚本，可能会导致 CPU 瞬间飙升。建议合理错开任务的执行时间，避免堆叠在整点运行。

常见问题 FAQ#

Q1：忘记初始化登录用户名和密码怎么办？#

这是新手最容易遇到的问题。如果你在首次部署后忘记了设置的密码，或者因为意外导致无法登录，可以通过以下命令重置：

进入容器内部：docker exec -it qinglong bash
查看/重置配置：进入 /ql/data/config 目录，查看 auth.json 文件。
命令行重置：在容器内输入 ql admin 命令，根据提示重置账户信息。

Q2：脚本运行报错 “Module Not Found” 或 “缺少依赖”？#

这说明脚本需要的运行环境不完整。

Node.js 脚本：通常缺少 canvas、jsdom 或 crypto-js。请前往面板左侧的依赖管理 -> Nodejs，点击添加依赖，输入包名安装。
Python 脚本：通常缺少 requests、canvas 或 ping3。在依赖管理 -> Python3 中添加即可。
排查建议：优先查看脚本开头（README）要求的依赖库，一次性在面板中补全。

Q3：拉取 GitHub 脚本仓库总是失败/超时？#

由于网络环境限制，直接拉取 GitHub 仓库往往会连接超时。

解决方案：利用代理加速。在“订阅管理”添加链接时，在 GitHub 地址前加上代理前缀。
示例：将 https://github.com/xxxx/repo.git 修改为 https://ghproxy.com/https://github.com/xxxx/repo.git（注：ghproxy 为常用公共镜像，也可搜索其他可用代理）。

Q4：脚本运行时间与实际时间不符（时区问题）？#

如果发现定时任务的触发时间不对，通常是容器时区设置问题。

解决办法：在 Docker 部署脚本或 docker-compose.yml 的环境变量 environment 中增加一项： - TZ=Asia/Shanghai
这会强制容器同步为北京时间。

Q5：如何配置手机端消息通知？#

青龙面板本身不直接发短信，它是通过 API 调用第三方平台。

推荐方案：使用 Pushplus（推送加） 或 Telegram Bot。
设置方法：在面板的配置文件 config.sh 中找到 通知环境变量 区域。填入对应的 Token（如 PUSH_PLUS_TOKEN）。配置完成后，所有脚本的运行结果都会自动推送到你的微信。

音乐