概述

一直在寻找可以跨平台听正版音乐的 APP，尝试了很多第三方开源音乐客户端，绝大多数都需要自己去收集音源，实在是不方便，而且音源还有可能失效，最后还是选择酷狗概念版。

为什么选择酷狗概念版

  • 音乐相对较全
  • 可以通过听歌、看广告领取 VIP
  • 手机版可以直接下载旧版，清新无广，支持 Android / IOS（推荐下载 2.4.5 版本）
  • 桌面版也有第三方开源客户端，支持 Windows / macOS（点我下载）

说了这么多，想必你也能一眼看到缺点，就是想听歌的时候，还得手动领取一下 VIP，这一步还是挺影响体验的。

基于此，我设计了一个小工具，可以部署在 Cloudflare Workers 上，实现多账号自动签到服务。

  • 图形化控制台（所见即所得）
  • 支持手机验证码登录、扫码登录（快速添加托管账号），只需一次登录添加账号，后续自动续期
  • 无需服务器（免费部署，无需在本地进行配置，哪怕一台手机也能完成所有操作进行部署）
  • 操作简单（粘贴一份 JS 代码、绑定一个 KV 即可）

功能特性

功能 说明
🖥 图形化控制台 暗色调单页界面，零 CDN 依赖，手机浏览器同样可用
👥 多账号托管 账号保存在 Cloudflare KV，可分别设置签到时间、单独启用 / 停用
📷 扫码登录 页面内展示酷狗官方二维码，手机 App 扫码即完成登录（推荐）
📱 手机验证码登录 页面内直接发送验证码并登录，自动加入托管
🍪 Cookie 导入 已有酷狗 token + userid 可直接导入，导入时自动校验
🏷 新老账号识别 按接口返回自动判定「老账号（有广告领取活动）/ 新账号」，首页附说明
⏰ 定时自动签到 Cron 每 5 分钟检查一次，到点自动领取，错过可补签
🎁 完整领取流程 听歌领取 + 广告领取（默认 8 次）+ VIP 到期时间回写
🔄 token 自动续期 每周日自动刷新酷狗 token，也可手动续期
🔐 双重安全 ADMIN_TOKEN 接口鉴权 + SECRET_KEY 加密 KV 中的账号 token
📜 运行日志 保留最近 100 条记录与分步明细，失败原因一目了然
🚫 自定义 404 未知路径返回同风格错误页，另附 robots.txt 禁止收录
💰 额度友好 针对 KV 免费额度优化写操作，5 个账号约 55 次写/天（上限 1000/天）

界面预览

登录页

登录页

扫码登录

image-20260925195840088

手机验证码登录

image-20260925195929186

运行日志

image-20260925195945482

全局设置

image-20260925200031081

部署

创建 Worker

  1. 打开 Cloudflare 控制台 并登录
  2. 左侧选择 「计算」→ 「Workers 和 Pages」
  3. 点击 「创建应用程序」 → 「从 Hello World！开始」 创建 Worker
  4. 随便起个名字（例如 kg-qiandao），点击 「部署」

修改代码

  1. 部署完成后点击 「编辑代码」
  2. 复制 worker.js 全部内容，覆盖原有的示例代码
  3. 点击右上角 「部署」

创建 KV 命名空间

  1. 左侧选择 「存储和数据库」 → 「Workers KV」
  2. 点击 「创建命名空间」，名称填 your_KV_name（名字随意）

把 KV 绑定到 Worker

  1. 回到 「Workers 和 Pages」，进入刚才创建的 Worker
  2. 打开 「设置」 → 「绑定」
  3. 点击 「添加绑定」 → 「KV 命名空间」
  4. 「变量名称」 必须填写 KG_KV（区分大小写，写错会提示未绑定）
  5. 「KV 命名空间」 选择上一步你创建的命名空间 your_KV_name
  6. 保存后需要重新部署一次才会生效，按提示操作即可。

设置登录密码

  1. 回到 Worker 详情页选择 「设置」 → 「运行时变量和密钥」
  2. 点击 「添加变量」，值勾选 「密钥」
  3. 「密钥」 名称填 ADMIN_TOKEN，「值」 填一个你自己的复杂口令（这就是控制台登录密码）
  4. 保存并重新部署
  5. 再添加一个名为 SECRET_KEY 的密钥，用于加密 KV 中保存的酷狗账号 token（可选）

添加定时触发器（自动签到必需）

  1. 在 Worker 的 「设置」 → 「触发事件」 → 「Cron 触发器」
  2. 点击 「添加 Cron 触发器」，表达式填写：*/5 * * * *

愉快的使用

  1. 打开 Worker 的访问地址（形如 https://kg-qiandao.<你的子域>.workers.dev）
  2. 输入第 5 步设置的 ADMIN_TOKEN 进入控制台
  3. 点击 「添加账号」，推荐用 「扫码登录」
  4. 调整每个账号的签到时间（北京时间），到点后会自动执行，想立即验证可点该账号的 「执行」

使用说明

账号列表

  • 【账号名后的标签】：老账号 / 新账号 / 类型未知，由接口返回自动判定。
    • 老账号拥有「看广告领 VIP」活动，除听歌外每天还能通过广告额外领取（默认最多 8 次）
    • 新账号没有该活动（广告接口返回 20028），每天只能靠听歌领取，这是账号本身的差异，不是故障
  • 【签到时间】：改动后「确认」按钮会变成 绿色，点击才保存（不会自动提交）
  • 【账号操作】：
    • 执行：立即跑一次，页面会等待并显示结果
    • 日志：展开分步明细
    • 续期：手动刷新酷狗账号 token
    • 删除：删除账号
  • 【待续跑 / 待重试】：广告次数没领完或听歌未领到时出现，定时任务会自动继续，无需人工干预

定时任务怎么工作

  • 每 5 分钟检查一次：账号到达签到时间且 当天未执行过 时自动执行
    */5  *  *  *  *
     │   │  │  │  └─ 星期几
     │   │  │  └──── 月份
     │   │  └─────── 日期
     │   └────────── 小时
     └────────────── 分钟：每 5 分钟触发一次
  • 单次执行有时间上限，8 次广告领取会分摊到多次执行中自动续跑
    （8 次 × 30 秒间隔 ≈ 3.5 分钟，一次跑完会被平台中断）
  • 同一天最多自动重试 3 次，可在设置里开启 「错过签到时间后自动补签」
  • 每周日刷新酷狗 token 只执行一次（用 lastRefreshDate 去重），不会每个 Cron 周期重复刷新

全局设置

设置项 默认 说明
新账号默认签到时间 01:15 北京时间，24 小时制
每日广告领取次数 8 酷狗「看广告领 VIP」上限，0 表示只做听歌领取
广告领取间隔 30 秒 每次广告领取之间的等待时间
每周日自动刷新 token 开 与常见做法一致
错过时间自动补签 关 开启后当天错过的账号会在后续 Cron 补跑
执行前设备注册获取 dfid 关 更接近真实客户端，但可能引入额外失败点

免责声明

  1. 本项目仅供学习与技术研究使用，请勿用于商业用途或任何非法用途。
  2. 使用过程中可能产生版权数据，本项目不拥有其所有权，请于 24 小时内清除。
  3. 使用本项目所产生的任何直接或间接损失由使用者自行承担。
  4. 请遵守当地法律法规以及酷狗音乐的用户协议；音乐平台不易，请支持正版。
  5. 若官方认为本项目不妥，可联系删除。