🚀 基于 GitHub Actions 的多站点自动续期解决方案
🚀 项目地址：github.com/mqiancheng/freecloud
🚨 隐私风险提示：本项目服务调用本人部署的API，会收集用户密码等敏感信息！
🔒 如果您介意隐私安全问题，请勿使用本项目！
💡 建议：如有技术能力，请自行部署API服务以确保数据安全。
📚 想了解技术实现？查看技术文档和系统架构：tech-sharing 分支
- ✅ 多站点支持 - 支持 freecloud.ltd 和 nat.freecloud.ltd 两个站点
- ✅ 自动续期 - 每天早上8点后随机15分钟内自动执行续期任务
- ✅ 多账号支持 - 支持批量处理多个账号
- ✅ Telegram 通知 - 实时推送续期结果到 Telegram
- ✅ 详细日志 - 完整的执行日志和错误信息
- ✅ 手动触发 - 支持手动执行续期任务
- ✅ 统一配置 - 所有站点使用相同的配置格式
加⭐收藏本项目，然后将此仓库 Fork 到你的 GitHub 账号。
在 GitHub 仓库中配置以下环境变量：
方式1：直接跳转 👉 点击进入Secrets配置页面 → 点击 "New repository secret" 按钮
方式2：手动导航：Settings → Secrets and variables → Actions → New repository secret
| 变量名 | 类型 | 说明 | 示例 |
|---|---|---|---|
FREECLOUD_ACCOUNTS |
Secret | FreeCloud 账号列表 (JSON格式) | 见下方示例 |
FREECLOUD_API_KEY |
Secret | 访问密钥 | 见下方获取方法 |
方式一：自助获取（推荐）
- 访问 fc.whoer.pp.ua
- 输入您的 GitHub 用户名
- 系统会自动验证您的 Star 状态并生成相应权限的 API Key
权限说明：
- 🆓 未Star用户：1个账号，每日1次
- ⭐ Star用户：5个账号，每日1次（给本项目加Star即可获得）
- 💎 付费用户：无限制账号和次数
| 变量名 | 类型 | 说明 |
|---|---|---|
TELEGRAM_BOT_TOKEN |
Secret | Telegram Bot Token |
TELEGRAM_CHAT_ID |
Secret | Telegram Chat ID |
| 字段 | 说明 | 获取方法 |
|---|---|---|
type |
固定填写 "freecloud" |
- |
username |
用户名 | 注册时的邮箱/用户名 |
password |
密码 | 注册时的密码 |
port |
端口号 | 见下方获取方法 |
freecloud.ltd如何获取 port 值：
- 登录 https://freecloud.ltd/server/lxc
- 查看服务器地区前面显示的编号，格式为
#1234 - 其中
1234即为该账号的 port 值
| 字段 | 说明 | 获取方法 |
|---|---|---|
type |
固定填写 "nat.freecloud" |
- |
username |
邮箱地址（注意：这里填邮箱，不是用户名） | 注册时的邮箱 |
password |
编码后的密码 | 见下方获取方法 |
port |
用户UID | 见下方获取方法 |
nat.freecloud.ltd 如何获取编码后的密码：（注意步骤顺序）
- 登录 https://nat.freecloud.ltd/login填写账号密码
- 打开浏览器开发者工具（F12），切换到 Network 标签页，再点击页面中的登陆。
- 在 Network 标签页中找到登录请求，名称为/login?action=email
- 复制 负载 请求的参数中找到
password值，类似 "ABDFSW21FA33vsq==" - 进入 https://www.json.cm/urlencode/，将
编码后的密码粘贴到解码框中，点击Url编码即可得到编码后的
password真实值
nat.freecloud.ltd 如何获取 port 值：
- 登录 https://nat.freecloud.ltd/clientarea
- 用户名旁的ID即为该账号的 port 值
-
字段含义说明：
- 对于
freecloud类型：username是用户名，port是端口号 - 对于
nat.freecloud类型：username是邮箱地址，port是用户ID
- 对于
-
密码处理：
freecloud类型使用原始密码nat.freecloud类型必须使用编码后的密码
-
配置验证：
- 确保 JSON 格式正确，注意逗号和引号
- 每个账号都必须包含
type字段 - 不同类型的账号可以混合配置
[
{
"type": "freecloud",
"username": "myuser1",
"password": "mypassword1",
"port": "1000"
},
{
"type": "freecloud",
"username": "myuser2",
"password": "mypassword2",
"port": "1222"
},
{
"type": "nat.freecloud",
"username": "myemail@gmail.com",
"password": "ABDFSW21FA33vsq==",
"port": "131"
},
{
"type": "nat.freecloud",
"username": "another@email.com",
"password": "encoded_password_here",
"port": "456"
}
]注意： 确保您在 main 分支上启用工作流！
- 确保在 main 分支
- 进入仓库的 Actions 标签页
- 如果是第一次使用，点击 "I understand my workflows, go ahead and enable them"
- 找到 "FreeCloud 自动续期" 工作流
- 点击 "Enable workflow"
工作流会每天早上8点（北京时间）后随机15分钟内自动执行一次。（为了保证你的定时续期任务能成功执行，强烈建议大家随机修改这个定时时间，比如将 "0 2 * * *"，将2修改为0-16都可以）
💡 修改定时时间：👉 点击编辑工作流文件 修改第12行的cron表达式
- 确保您在 main 分支 上
- 进入 Actions 标签页
- 选择 "FreeCloud 自动续期" 工作流
- 点击 "Run workflow"
- 可选择是否 "跳过延迟执行"（默认勾选，立即执行）
- 点击 "Run workflow" 开始执行
说明：
- ✅ 跳过延迟执行（默认）：立即开始续期，无延迟
- ❌ 不跳过延迟执行：也会有0-15分钟的随机延迟
🚀 开始执行 FreeCloud 自动续期
📋 读取到 2 个账号
📊 处理结果: 总计2个账号, 登录成功2个, 续期成功2个, 失败0个
✅ Telegram 消息已发送
🎉 所有账号处理完成
🌤 多站点续期状态报告
📊 本次处理: 3个账号
✅ 登录成功: 3个 💰 续期成功: 3个 ❌ 失败: 0个
📋 详细结果:
✅ 账号1 `user1` (freecloud) 登录成功
💰 账号1 `user1` (freecloud) 续期成功: 续期成功
✅ 账号2 `user@gmail.com` (nat.freecloud) 登录成功
💰 账号2 `user@gmail.com` (nat.freecloud) 续期成功: 今天你已经签到过了！
✅ 账号3 `user2` (freecloud) 登录成功
💰 账号3 `user2` (freecloud) 续期成功: 续期成功
⏰ 执行时间: 2025/6/15 08:00:00
-
环境变量配置错误
- 检查
FREECLOUD_ACCOUNTS是否为有效 JSON 格式 - 确认
FREECLOUD_API_KEY是否正确
- 检查
-
Worker 调用失败
- 检查网络连接
- 验证 API Key 是否有效（建议重新从 fc.whoer.pp.ua 获取）
- 查看 Actions 日志获取详细错误信息
-
账号处理失败
- freecloud.ltd: 检查用户名、密码和端口号是否正确
- nat.freecloud.ltd: 检查邮箱地址、编码密码和UID是否正确
- 查看详细错误信息和日志
-
站点特定问题
- freecloud.ltd: 确认端口号在服务器列表中存在
- nat.freecloud.ltd: 确认邮箱格式正确，密码已正确编码
- 检查站点类型
type字段是否正确填写
- ✅ 所有敏感信息都存储在 GitHub Secrets 中
- ✅ 代码经过混淆处理，增强安全性
- ✅ 支持私有仓库部署
⚠️ 请勿在公开场所泄露 API Key 和账号信息
如果遇到问题，请：
- 查看 Actions 执行日志
- 检查环境变量配置
- 确认账号信息正确性
- 提供详细的错误信息
注意： 请妥善保管你的 API Key 和账号信息，不要在公开场所泄露。