122 lines
3.9 KiB
Markdown
122 lines
3.9 KiB
Markdown
# iKuuu 青龙面板签到脚本
|
||
|
||
## 脚本说明
|
||
|
||
此脚本用于青龙面板自动签到iKuuu网站，支持多账号配置、域名自动更新和通知功能。
|
||
|
||
### 功能特性
|
||
|
||
- 自动检测并更新iKuuu官方域名
|
||
- 支持多账号批量签到
|
||
- 签到结果通过青龙面板通知系统推送
|
||
- 域名不可用时自动切换备用域名
|
||
- 完整的异常处理和日志记录
|
||
|
||
## 安装步骤
|
||
|
||
1. 将脚本保存为`ik_signin.py`到青龙面板的`scripts`目录
|
||
2. 添加环境变量`IKUUU_ACCOUNTS`，格式为：
|
||
```
|
||
邮箱1:密码1
|
||
邮箱2:密码2
|
||
```
|
||
3. 在青龙面板添加定时任务：
|
||
```
|
||
task ik_signin 0 0 1 * * ?
|
||
```
|
||
|
||
## 环境变量配置
|
||
|
||
| 变量名 | 说明 | 示例 |
|
||
| ---- | ---- | ---- |
|
||
| IKUUU_ACCOUNTS | iKuuu账号密码，每行一个账号，格式为`邮箱:密码` | `test@example.com:password123` |
|
||
|
||
## 使用说明
|
||
|
||
1. 脚本会自动检测当前域名是否可用
|
||
2. 若检测到域名变更，会自动更新脚本中的域名信息
|
||
3. 依次对配置的所有账号进行签到操作
|
||
4. 签到结果会通过青龙面板的通知系统发送
|
||
|
||
### 运行依赖
|
||
|
||
当前版本使用真实浏览器页面登录并点击Geetest验证按钮。Python依赖只需要安装：
|
||
|
||
```
|
||
DrissionPage
|
||
```
|
||
|
||
脚本不需要`chromium-chromedriver`，也不需要`xvfb`。DrissionPage使用浏览器调试协议，不走ChromeDriver；脚本已启用headless模式。
|
||
|
||
青龙容器内需要有可用的Chrome或Chromium。如果脚本没有自动找到浏览器，可以额外设置：
|
||
|
||
| 变量名 | 说明 | 示例 |
|
||
| ---- | ---- | ---- |
|
||
| IKUUU_BROWSER_PATH | Chrome/Chromium可执行文件路径 | `/usr/bin/chromium` |
|
||
|
||
浏览器不是Python依赖，不能在青龙Python依赖页面安装。需要进入青龙容器安装或确认已有路径：
|
||
|
||
```
|
||
which chromium chromium-browser google-chrome google-chrome-stable chrome
|
||
```
|
||
|
||
Debian/Ubuntu容器可尝试：
|
||
|
||
```
|
||
apt-get update && apt-get install -y chromium
|
||
```
|
||
|
||
Alpine容器可尝试：
|
||
|
||
```
|
||
apk add --no-cache chromium
|
||
```
|
||
|
||
安装后如果脚本仍未自动识别，在青龙环境变量中增加：
|
||
|
||
```
|
||
IKUUU_BROWSER_PATH=/usr/bin/chromium
|
||
```
|
||
|
||
## 更新日志
|
||
|
||
### 2026-06-04
|
||
- 参照浏览器自动化逻辑，恢复`IKUUU_ACCOUNTS`账号密码登录
|
||
- 移除Cookie登录路径，改为使用DrissionPage打开页面、点击Geetest并调用页面签到函数
|
||
- 移除`xvfb`和`chromium-chromedriver`依赖要求，支持通过`IKUUU_BROWSER_PATH`指定浏览器路径
|
||
|
||
### 2025-07-29
|
||
- 修复「剩余流量」查询
|
||
|
||
### 2025-07-25
|
||
- 智能域名发现机制。使用多种正则表达式模式从网页内容中提取域名，当域名不可用时，会从旧域名页面自动抓取新的可用域名，优先使用ikuuu相关域名，其次使用其他发现的域名
|
||
- 增强的域名检测逻辑。能识别多种域名变更通知格式，从JavaScript跳转、登录链接等多个位置提取域名，过滤掉无效的域名格式
|
||
- 完善的容错机制。当前域名 → 发现的新域名 → 备用域名列表，每个域名都会进行可达性测试，增加了超时、连接错误等异常处理
|
||
- 改进的用户体验。每个步骤都有清晰的状态提示和图标，显示账户处理进度，提供详细的执行结果汇总
|
||
- 新增功能。在通知中包含当前使用的域名，账户间延迟增加到2秒，避免请求过快，各种异常情况都有对应的错误信息
|
||
|
||
---
|
||
|
||
### 2025-01-14
|
||
- 接口请求统一增加UA标识
|
||
|
||
---
|
||
|
||
### 2025-06-01
|
||
- 增加剩余流量显示
|
||
|
||
---
|
||
|
||
### 2025-05-31
|
||
|
||
- 初始版本发布
|
||
- 实现基本签到功能
|
||
- 添加域名自动检测和更新机制
|
||
- 支持多账号配置和结果通知
|
||
|
||
## 注意事项
|
||
|
||
- 请确保青龙面板已配置通知功能，否则无法接收签到结果通知
|
||
- 脚本运行需要网络连接畅通，否则可能导致签到失败
|
||
- 若官方域名发生变更，脚本会自动更新，但可能需要手动触发一次以完成更新
|