Cloud189Checkin 天翼网盘自动签到常见疑难杂症排查清单：设备锁、二次设备校验、SyntaxError 一次讲透

Cloud189Checkin 天翼网盘自动签到常见疑难杂症排查清单：设备锁、二次设备校验、SyntaxError 一次讲透

【免费下载链接】Cloud189Checkin天翼网盘自动签到项目地址: https://gitcode.com/gh_mirrors/clo/Cloud189Checkin

Cloud189Checkin 是一个广受欢迎的天翼网盘自动签到开源工具，支持个人账号每日自动签到、随机容量奖励，以及 Server酱、Bark、Telegram 等多渠道推送通知。很多新手第一次部署时，都会被"设备 ID 不存在、需要二次设备校验"、SyntaxError报错卡住。本文把这三类最高频的疑难杂症整理成一份排查清单，按图索骥，10 分钟帮你把签到脚本跑通 ✅

症状速查表：先看你是哪种报错

👉 对号入座，直接跳到对应章节即可。

问题一：设备锁、二次设备校验，如何一步步关闭

原因：Cloud189Checkin 通过账号密码在服务器上登录天翼网盘。而天翼网盘的安全机制"设备锁"会把服务器当成一台新设备，登录时就要求二次设备校验——服务器可没有手机帮你验证，签到自然失败。

解决方法（核心就一步：关闭设备锁）：

1. 在手机上登录天翼网盘官方 App 或官网
2. 进入「安全设置 / 账号安全」相关页面
3. 关闭「设备锁」相关选项，必要时清理旧的设备登录记录
4. 重新运行签到任务，验证通过 ✅

⚠️ 项目方在 README.md 的"重要说明"中特意强调了这一点，遇到"设备 ID 不存在、需要二次设备校验"时请先处理设备锁，再排查其他问题。

问题二：SyntaxError 快速解决，密码特殊字符的两种写法

原因：批量账号通过环境变量TY_ACCOUNTS传入，它本质是一段 JSON。accounts.js 里用JSON.parse解析它——如果你的密码里含有#、$等特殊字符，配置加载时会被提前"吃掉"，JSON 结构被破坏，启动时就抛出SyntaxError。

两种解决办法，任选其一：

写法一：给 TY_ACCOUNTS 整体加上单引号💡

把配置值用单引号包起来，例如：

'[{"userName":"1234567890","password":"123334#$#$"}]'

这样#、$就会被当成普通字符保留下来。

写法二（多账号更推荐）：按序号拆分配置

不用写 JSON，直接依次添加TY_USERNAME_1、TY_PASSWORD_1、TY_USERNAME_2、TY_PASSWORD_2……账号数量不限，accounts.js 会自动从 1 开始循环读取，天然规避特殊字符问题：

问题三：无日志、无推送？按顺序检查这三个地方

1. 是否创建了名为user的环境（GitHub Action 用户必看）

新版工作流要求账号变量放进 environment 里，先创建一个叫user的环境，再把TY_ACCOUNTS或TY_USERNAME_x / TY_PASSWORD_x、推送密钥都加进去。

2. 工作流权限是否为 Read and write

进入 Settings → Actions → Workflow permissions，改成Read and write permissions，否则任务可能静默失败。

3. 是否真正启用了工作流

点 Actions → 点击 "I understand my workflows, go ahead and enable them" → 点 start 或手动运行一次。任务默认每天早上 10:35自动执行，配置完成后可以到 Actions 页查看运行结果：

推送没收到？推送通道是"配置了才生效"的：Server酱配SENDKEY、Bark 配BARK_KEY、PushPlus 配PUSH_PLUS_TOKEN等，完整通道列表见 src/push/index.js。

问题四：请求失败 / 请求超时怎么判断

运行日志里如果出现请求失败: 状态码, 响应内容，说明是接口返回了错误，按状态码和响应体定位；如果是ECONNRESET/ETIMEDOUT，则被识别为"请求超时"，属于网络抖动，重跑一次通常就好了。相关处理逻辑在 src/app.js，多账号任务还会打印每个账号的耗时，方便你排查慢在哪一步。

本地部署常见坑：一份完整自检清单

• ☑ Node.js 版本 ≥ 18（要求见 package.json）
• ☑ 本地运行前先修改 .env 里的账号变量，再执行npm install、npm start
• ☑ Windows 下也可以直接在系统"环境变量"里设置TY_USERNAME_x/TY_PASSWORD_x
• ☑千万别把填了真实账号密码的.env提交到仓库——仓库是公开的，提交上去等于公开你的密码
• ☑ 玄武 / 青龙面板部署有独立图文教程，参考 doc/xuanwu/README.md
• ☑ 签到奖励为随机容量，每天所得不完全一样属正常现象

📌 总结：设备锁问题去官方客户端关闭设备锁；SyntaxError 问题给 TY_ACCOUNTS 加单引号或改用序号变量；无日志问题依次检查user 环境 → 工作流权限 → 手动启用任务。按这份清单过一遍，绝大多数疑难杂症都能一次讲透、一次解决。

【免费下载链接】Cloud189Checkin天翼网盘自动签到项目地址: https://gitcode.com/gh_mirrors/clo/Cloud189Checkin