iKuuu机场每日签到
功能介绍
iKuuu 机场后台自动签到脚本，每天定时运行，自动领取免费流量。
核心功能
- 后台自动签到：无需打开网页，脚本在后台定时自动完成签到
- 自动登录：检测到未登录时，自动使用预设的账号密码登录
- 自定义域名：网站更换域名后，可通过菜单随时修改，无需更新脚本
- 智能重试：网络异常时自动重试（最多7次），超时自动退出
- 已签到检测：如果当天已签到，自动跳过，不重复请求
定时策略
每隔 5 小时自动运行一次（0:00、5:00、10:00、15:00、20:00），签到后自动停止，下次定时再次触发。
使用方法
1. 安装脚本
本脚本需要 ScriptCat（推荐）或 Tampermonkey 脚本管理器。
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/
开源地址
更新日志
v1.3.0 (2026-05-16)
- 精简代码结构，添加可维护注释
- 修复竞态条件（签到成功后不再重复请求）
- 适配新域名 ikuuu.win
- 增强错误日志输出
v1.2.0 (2026-05-16)
- 新增设置菜单（域名、账号密码）
- 新增自动登录功能
- 新增已签到检测
- 修复请求头导致的 405 错误
v1.1.4
- 原始版本（作者 Vikrant）
- 基础签到功能和重试机制
iKuuu机场每日签到 - 开发文档
项目简介
ScriptCat后台脚本，自动完成 iKuuu 机场每日签到，领取免费流量。
技术栈
- 用户脚本引擎：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}/auth/login
Content-Type: application/x-www-form-urlencoded
email=xxx&passwd=xxx
响应：{ret: 1, msg: "..."} 表示成功
签到
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） |
