DNSHE 免费域名自动续期工具

基于 Cloudflare Workers 搭建的零成本 DNSHE 免费二级域名自动续期工具，告别域名手动续期烦恼，支持网页手动触发+定时自动执行，密钥安全存储无泄露风险。

目录

1. 项目介绍
2. 免费域名注册指导
3. 部署到Cloudflare Workers完整教程
4. 使用说明
5. 常见问题FAQ

1. 项目介绍

本项目专为 DNSHE 平台免费二级域名打造，解决免费域名易过期、手动续期繁琐的问题，依托 Cloudflare Workers 实现无服务器、零成本、7×24小时稳定运行，核心优势如下：

• ✅ 零成本部署：Cloudflare Workers 免费额度完全满足日常使用，无需购买服务器
• ✅ 安全无风险：API密钥通过Cloudflare环境变量存储，绝不硬编码、不上传代码仓库，杜绝密钥泄露
• ✅ 双重续期模式：支持网页可视化手动续期+每6个月定时自动续期，双重保障域名不失效
• ✅ 实时日志反馈：续期过程实时输出日志，成功/失败状态清晰可见，便于排查问题
• ✅ 无需值守：配置完成后自动后台运行，无需人工干预，彻底解放双手

适用场景：适用于个人在DNSHE平台注册的所有免费二级域名，防止域名因忘记续期被回收。

2. 免费域名注册指导（DNSHE平台）

2.1 账号注册

1. 打开 DNSHE官方网站，点击首页「注册」按钮
2. 填写邮箱、密码、验证码，完成账号注册并登录
3. 登录后完成邮箱验证，提升账号权限

2.2 免费二级域名申请

1. 登录账号后，进入左侧菜单栏域名中心 → 免费二级域名
2. 页面展示多种免费域名后缀，选择心仪的后缀（如：xxx.dnshe.com）
3. 输入自定义前缀，检查域名是否可注册，点击「立即注册」
4. 按照提示完成域名申请流程，无需付费，即可获得免费二级域名
5. 部分二级域名需要邀请码: HUC06F7B16

2.3 获取API密钥（核心步骤）

1. 登录DNSHE账号，点击右上角头像 → API密钥管理
2. 点击「生成API密钥」，完成安全验证
3. 复制生成的 API Key 和 API Secret，妥善保管，后续部署需用到

⚠️ 注意：API密钥具有账号操作权限，切勿泄露给他人，仅用于本工具配置

3. 部署到Cloudflare Workers完整教程

3.1 前提准备

• 注册 Cloudflare账号（免费注册，无需绑定信用卡）
• 备好DNSHE平台的 API Key 和 API Secret

3.2 新建Worker项目

1. 登录Cloudflare Dashboard，进入左侧Workers & Pages
2. 点击右上角创建应用程序 → 创建Worker
3. 自定义Worker名称（如：dnshe-renew），点击部署
4. 进入Worker编辑页面，删除默认示例代码，复制本项目完整代码粘贴进去
5. 点击右上角保存并部署，完成Worker基础创建

3.3 配置环境变量（必做）

1. 进入已创建的Worker页面，点击顶部设置 → 变量
2. 在「环境变量」区域，点击添加变量，依次添加以下两个变量：
   • 变量名：API_KEY，变量值：粘贴DNSHE的API Key
   • 变量名：API_SECRET，变量值：粘贴DNSHE的API Secret
3. 勾选加密选项（防止密钥在后台明文显示），点击保存
4. 保存后返回Worker主页，点击部署使变量生效

3.4 配置定时自动续期

1. 进入Worker设置 → 触发器
2. 找到「Cron 触发器」，点击添加 Cron 触发器
3. 输入定时规则：0 0 1 */6 *（每6个月1号00:00 UTC，即北京时间8:00执行）
4. 点击添加，完成定时任务配置，工具将每半年自动续期一次域名

3.5 本地开发配置（可选）

如需本地修改调试，创建wrangler.toml文件，配置如下：

name = "dnshe"
main = "worker.js"
compatibility_date = "2026-04-01"

# 本地环境变量（仅本地调试用，切勿上传仓库）
[vars]
API_KEY = "你的DNSHE API Key"
API_SECRET = "你的DNSHE API Secret"

# 定时任务配置
[triggers]
crons = [ "0 0 1 */6 *" ]

4. 使用说明

4.1 手动续期操作

1. 部署完成后，复制Cloudflare Workers分配的域名（如：dnshe-renew.xxx.workers.dev）
2. 在浏览器打开该域名，进入工具主页
3. 点击开始续期按钮，工具自动获取所有活跃域名并执行续期
4. 页面实时显示续期日志，可查看每个域名的续期成功/失败状态

4.2 自动续期说明

配置Cron触发器后，工具会每6个月1号自动执行续期，无需手动操作，执行日志可在Cloudflare Workers的日志页面查看。

5. 常见问题FAQ

Q1：部署后点击续期提示API密钥错误？

A：检查Cloudflare环境变量名称是否为API_KEY和API_SECRET（区分大小写），确认密钥粘贴无误，重新部署后重试。

Q2：定时任务没有自动执行？

A：检查Cron规则是否正确输入0 0 1 */6 *，确认触发器已启用，可在Cloudflare Workers日志页面查看执行记录。

Q3：续期失败提示“无活跃子域名”？

A：确认DNSHE账号下有已注册且状态为「活跃」的免费二级域名，检查域名是否已过期或被封禁。

Q4：Cloudflare Workers免费额度够用吗？

A：完全够用，Cloudflare Workers免费版每日请求次数10万次，本工具单次续期请求极少，无额度压力。

Q5：可以修改自动续期的时间吗？

A：可以，修改Cron触发器的定时规则即可，例如改为每月1号执行：0 0 1 * *，根据自身需求调整。

Q6：本工具安全吗？会泄露域名账号吗？

A：绝对安全，API密钥存储在Cloudflare官方环境变量中，代码中无任何密钥硬编码，不会上传至任何第三方服务器。

开源协议

本项目基于 MIT License 开源协议，完全开源免费，可自由修改、分发、使用。

免责声明

本工具仅用于个人合法持有的DNSHE免费域名续期，请勿用于恶意批量注册、续期域名等违规行为，由此产生的法律责任由使用者自行承担。