English Version | 中文说明

这是一个用于自动续期 Katabump 服务器的自动化脚本。它利用 Playwright 和 CDP (Chrome DevTools Protocol) 技术来模拟用户操作,能够有效绕过 Cloudflare Turnstile 验证码,确保持续的服务器服务。

支持 Windows 本地运行 和 GitHub Actions 云端运行。

• 智能过盾: 通过 CDP 协议模拟真实鼠标轨迹和点击行为,结合屏幕坐标伪造,高成功率绕过 Cloudflare Turnstile。
• 自动重试: 内置严格的验证重试机制,如果验证失败会自动重启验证流程。
• 多用户支持: 支持配置多个账号批量续期。
• 云端/本地: 既可以在本地电脑跑,也可以利用 GitHub Actions 每天定时自动跑。

这是最省心的方式,配置一次即可每天自动执行。

1. Fork 本仓库 到你的 GitHub 账号。

2. 进入你的仓库,点击 Settings -> Secrets and variables -> Actions。

3. 点击 New repository secret,添加一个名为 USERS_JSON 的 Secret。

4. Value 的格式必须是 JSON 数组(请尽量压缩为一行):

   [{"username": "your_email@example.com", "password": "your_password"}, {"username": "another@example.com", "password": "pwd"}]

5. (可选) 配置代理: 如果 GitHub Actions 的 IP 被屏蔽,或者你想使用特定的 IP 访问,可以添加名为 HTTP_PROXY 的 Secret。

   • 格式:
     • 无认证: http://ip:port -带认证: http://username:password@ip:port
   • 说明: 脚本会自动检测代理有效性,如果支持认证会自动处理。默认不启用。

6. (可选) Telegram 消息推送: 如果你希望在续期成功、失败或跳过时收到 Telegram 通知(包含截图),请配置以下 Secret:

   • TG_BOT_TOKEN: 你的 Telegram Bot Token (从 @BotFather 获取)。
   • TG_CHAT_ID: 你的 Chat ID (用户 ID 或群组 ID)。

   如果未配置,脚本将跳过发送通知。

• 运行日志: 在 Actions 中的 Run Renew Script 步骤查看。
• 截图留存: 每次运行(无论成功与否),通过 Upload Screenshots 步骤自动上传截图。
  • 你可以在 Workflow 运行详情页的 Artifacts 区域下载 screenshots 压缩包。
  • 每个账号对应一张截图(username.png),方便确认状态。

5. 保存后,进入 Actions 页面,启用 Workflow。它会在每天北京时间 08:00 (UTC 00:00) 自动运行。
6. 你也可以手动点击 "Run workflow" 立即测试。

如果你想在本地观察运行过程或进行调试,请按以下步骤操作。

确保你已经安装了 Node.js (建议版本 v18+)。

在项目根目录打开终端 (PowerShell 或 CMD),运行:

npm install

项目中有一个 login.json.template 模板文件。

1. 将其重命名为 login.json。

2. 用记事本或编辑器打开,填入你的账号密码:

   [
    {
    "username": "myemail@gmail.com",
    "password": "mypassword123"
    }
   ]

   注意: login.json 已被加入 .gitignore,不会被上传到 GitHub,请放心使用。

打开 renew.js 文件,找到第 11-12 行:

const CHROME_PATH = "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe";
const USER_DATA_DIR = path.join(__dirname, 'ChromeData_Katabump');
const HEADLESS = true;

• CHROME_PATH: 这是你本地 Chrome 浏览器的安装路径。如果你的安装位置不同,请务必修改!
• USER_DATA_DIR:
  • 这是一个用于存放 Script 运行时产生的浏览器数据(缓存、Cookie、登录状态等)的文件夹。
  • 作用: 它能让你的登录状态保持更久,不需要每次运行都重新输入密码。
  • 能不能删?: 可以删。如果你想要重置所有状态(彻底清除缓存),只需删除这个文件夹即可。脚本下次运行时会自动重新创建它。
• HEADLESS:
  • false: 脚本运行时会弹出一个 Chrome 窗口,你可以看到它在做什么。
  • true: (默认)脚本在后台无头运行,界面不可见(适合只想静默完成任务时开启)。

如果你需要使用代理运行脚本,请设置环境变量 HTTP_PROXY:

Powershell:

$env:HTTP_PROXY="http://user:pass@127.0.0.1:7890"
node renew.js

CMD:

set HTTP_PROXY=http://user:pass@127.0.0.1:7890
node renew.js

如果不设置代理,直接运行:

node renew.js

脚本会自动启动 Chrome (如果需要),逐个处理账号,并在根目录下的 photo/ 文件夹中保存每个账号运行结束时的截图(账号名.png)。窗口(默认无头模式为 false,你可以看到操作过程),并依次为列表中的用户续期。

• renew.js: Windows 本地运行的主程序。
• action_renew.js: 专门用于 GitHub Actions 环境的脚本(适配 Linux/Headless)。
• .github/workflows/renew.yml: GitHub Actions 的定时任务配置文件。
• login.json: (需手动创建) 存放本地运行的账号信息。