iKuuu机场每日签到

功能介绍

iKuuu 机场后台自动签到脚本，每天定时运行，自动领取免费流量。

核心功能

后台自动签到：无需打开网页，脚本在后台定时自动完成签到
自动登录：检测到未登录时，自动使用预设的账号密码登录
自定义域名：网站更换域名后，可通过菜单随时修改，无需更新脚本
智能重试：网络异常时自动重试（最多7次），超时自动退出
已签到检测：如果当天已签到，自动跳过，不重复请求

定时策略

每隔 5 小时自动运行一次（0:00、5:00、10:00、15:00、20:00），签到后自动停止，下次定时再次触发。

使用方法

1. 安装脚本

本脚本需要 ScriptCat（推荐）或 Tampermonkey 脚本管理器。

ScriptCat 下载：https://scriptcat.org/

2. 首次配置

安装脚本后，点击脚本管理器图标，找到本脚本的菜单：

设置账号密码：输入你的 iKuuu 邮箱和密码（用于自动登录）
设置域名：如果网站域名有变，可手动修改（默认 ikuuu.win）

3. 等待自动运行

配置完成后，脚本会在下一个定时点自动运行。也可以手动运行一次测试。

4. 查看结果

签到成功：ScriptCat 日志中显示获得的流量
已签到过：显示"今日已签到"
签到失败：显示错误信息，可手动重新运行

菜单说明

菜单	功能
设置域名	修改网站域名（网站迁移时使用）
设置账号密码	设置登录邮箱和密码
清除设置	恢复所有设置为默认值
查看当前设置	查看当前域名和账号配置

常见问题

Q: 签到失败怎么办？
A: 检查以下几点：

账号密码是否正确（通过菜单重新设置）
域名是否正确（网站可能更换了域名）
网络是否正常（需要能访问 ikuuu.win）

Q: 可以改成其他时间间隔吗？
A: 可以。修改脚本头部的 @crontab 值：

0 8 * * * — 每天早上8点执行一次
0 */3 * * * — 每隔3小时执行一次
30 9 * * 1-5 — 工作日早上9:30执行

Q: 支持哪些机场？
A: 本脚本基于 SSPanel 面板开发，理论上支持所有使用 SSPanel 的机场。修改 DEFAULT_DOMAIN 和相关配置即可适配。

致谢

本脚本基于 Vikrant 的原始版本（v1.1.4）重构开发。

感谢 Vikrant 编写了最初的 iKuuu 签到脚本，为本项目奠定了基础。原脚本实现了核心的签到功能和重试机制，本版本在此基础上新增了：

自定义域名功能
账号密码自动登录
油猴菜单配置界面
已签到检测
竞态条件修复
代码结构优化和注释

原作者: Vikrant
原始脚本地址: https://bbs.tampermonkey.net.cn/

开源地址

GitHub: https://github.com/liyan20001124-byte/jichang
问题反馈: https://github.com/liyan20001124-byte/jichang/issues

更新日志

v1.3.0 (2026-05-16)

精简代码结构，添加可维护注释
修复竞态条件（签到成功后不再重复请求）
适配新域名 ikuuu.win
增强错误日志输出

v1.2.0 (2026-05-16)

新增设置菜单（域名、账号密码）
新增自动登录功能
新增已签到检测
修复请求头导致的 405 错误

v1.1.4

原始版本（作者 Vikrant）
基础签到功能和重试机制

iKuuu机场每日签到 - 开发文档

项目简介

ScriptCat后台脚本，自动完成 iKuuu 机场每日签到，领取免费流量。

GitHub: https://github.com/liyan20001124-byte/jichang
许可证: MIT
当前版本: 1.3.0

技术栈

用户脚本引擎：ScriptCat（推荐）或 Tampermonkey
运行环境：浏览器 Service Worker（后台运行，无需打开目标网页）
目标网站：SSPanel 面板（iKuuu 机场）

文件结构

机场签到/
├── iKuuu机场每日签到.txt    # 主脚本（安装到脚本管理器）
├── 开发文档.md              # 本文件
└── 首页 — iKuuu VPN.html    # 网页存档（调试用）

脚本头部元数据说明

// @crontab      0 */5 * * *        // 定时表达式：每隔5小时执行一次
// @match        https://docs.scriptcat.org/dev/background.html#promise  // 触发页（后台脚本占位）
// @connect      ikuuu.win          // 允许跨域请求的域名
// @storageName  iKuuuCheckin_Shared // 持久化存储名（多脚本共享）

注意：如果网站更换域名，需要：

修改 DEFAULT_DOMAIN 常量
添加新的 @connect 声明
更新 @icon URL

代码结构

脚本分为四个区域：

1. 常量配置（顶部）

const DEFAULT_DOMAIN = "ikuuu.win"; // 默认域名
const MAX_RETRIES = 7;              // 最大重试次数
const MAX_TICKS = 32;               // 超时检测上限
const REQUEST_DELAY = [1000, 5000]; // 随机延迟范围

修改这些值可以调整脚本行为，无需理解内部逻辑。

2. 用户设置

通过 GM_getValue / GM_setValue 持久化存储，数据保存在脚本管理器中：

键名	类型	说明
`domain`	string	网站域名
`email`	string	登录邮箱
`password`	string	登录密码

3. 菜单注册

四个菜单通过 GM_registerMenuCommand 注册，在脚本管理器的菜单中可见：

设置域名
设置账号密码
清除设置
查看当前设置

4. 主逻辑（Promise）

脚本返回一个 Promise，ScriptCat 通过 resolve/reject 判断执行结果。

执行流程：
┌─────────────────┐
│  GET /user      │  检查登录状态
└────────┬────────┘
         │
    ┌────┴────┐
    │ 已登录? │
    └────┬────┘
    Yes  │  No → doLogin() → 自动登录 → doCheckin()
         │
    doCheckin()  POST /user/checkin
         │
    ┌────┴────┐
    │ 成功?   │
    └────┬────┘
    Yes  │  No → 重试（最多7次）
         │
    resolve(msg)  → 脚本结束

关键 API 接口

检查登录状态

GET https://{domain}/user

已登录：重定向到 /user（200）
未登录：重定向到 /auth/login

签到

POST https://{domain}/user/checkin
Accept: application/json, text/javascript, */*; q=0.01
X-Requested-With: XMLHttpRequest
（无请求体）

响应：

{ret: 1, msg: "获得了 xxx MB 流量"} — 签到成功
{ret: 0, msg: "今日已签到"} — 已签到过

重要：签到接口不需要 Content-Type 和请求体，多了会返回 405。

常见问题排查

签到失败（405 错误）

原因：请求头包含 Content-Type 导致服务器拒绝。
解决：确保签到请求不设置 Content-Type，不发送 data。

签到失败（网络错误）

可能原因：

域名变更 → 通过菜单更新域名
未登录 → 检查账号密码设置
代理/VPN 问题 → 检查网络连接

如何调试

在 ScriptCat 中手动运行脚本
查看日志输出（GM_log）
使用浏览器 F12 → 网络标签抓包对比

如何适配其他 SSPanel 机场

此脚本基于 SSPanel 面板，大部分 SSPanel 机场的接口相同。适配步骤：

修改 DEFAULT_DOMAIN 为目标机场域名
添加对应的 @connect 声明
修改 @icon 图标 URL
修改 @name 和 @namespace
检查登录接口的字段名是否为 email 和 passwd（部分面板可能不同）

版本历史

版本	日期	变更
1.3.0	2026-05-16	精简代码、添加注释、修复竞态条件、适配 ikuuu.win
1.2.0	2026-05-16	添加设置菜单、自动登录、动态域名
1.1.4	-	初始版本（原作者 Vikrant）