mirror of https://github.com/NewFuture/DDNS.git synced 2026-10-20 00:16:45 +00:00

Files

T

8afc0920dd docs: update schema references from v4.0.json to v4.1.json (#651 )

* Initial plan

* docs: update schema references from v4.0.json to v4.1.json

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* fix: revert schema/v4.0.json to keep v4.0 definition unchanged

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* docs: update schema file links to v4.1.json in provider README

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>
Co-authored-by: New Future <NewFuture@users.noreply.github.com>

2026-01-14 15:46:15 +00:00

5.2 KiB

Raw Permalink Blame History

HE.net (Hurricane Electric) 配置指南

概述

Hurricane Electric (HE.net) 是知名的网络服务商，提供免费的 DNS 托管服务，支持动态 DNS 记录更新。本 DDNS 项目通过 HE.net 的动态 DNS 密码进行认证。

⚠️ 注意：HE.net Provider 目前处于待验证状态，缺少充分的真实环境测试。请通过 GitHub Issues 反馈。

重要限制：HE.net 不支持自动创建记录，必须先在 HE.net 控制面板中手动创建 DNS 记录。

官网链接：

官方网站：https://he.net/
服务商控制台：https://dns.he.net/

认证信息

动态 DNS 密码认证

HE.net 使用专门的动态 DNS 密码进行认证，不使用账户登录密码。

需要提前创建DNS记录和开启DNS

在 HE.net DNS 管理面板中选择要管理的域名
创建DNS记录：手动创建 A (ipv4)或 AAAA (ipv6)记录
启用DDNS：为记录启用动态 DNS 功能
获取密码：点击旁边的 Generate a DDNS key 或 Enable entry for DDNS

{
    "dns": "he",
    "token": "your_ddns_key" // HE.net 动态 DNS 密码,不需要ID
}

完整配置示例

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
    "dns": "he",                        // 当前服务商
    "token": "your_ddns_key",      // HE.net 动态 DNS 密码
    "index4": ["public", 0],       // IPv4地址来源, 与A记录值对应
    "ipv4": "ddns.newfuture.cc"    // IPv4 域名, 与A记录对应
}

参数说明

参数	说明	类型	取值范围/选项	默认值	参数类型
dns	服务商标识	字符串	`he`	无	服务商参数
token	认证密钥	字符串	HE.net DDNS 密码	无	服务商参数
index4	IPv4 来源	数组	参考配置	`default`	公用配置
index6	IPv6 来源	数组	参考配置	`default`	公用配置
ipv4	IPv4 域名	数组	域名列表	无	公用配置
ipv6	IPv6 域名	数组	域名列表	无	公用配置
proxy	代理设置	数组	参考配置	无	公用网络
ssl	SSL 验证方式	布尔/字符串	`"auto"`、`true`、`false`	`auto`	公用网络
cache	缓存设置	布尔/字符串	`true`、`false`、`filepath`	`true`	公用配置
log	日志配置	对象	参考配置	无	公用配置

参数类型说明：

公用配置：所有支持的DNS服务商均适用的标准DNS配置参数

公用网络：所有支持的DNS服务商均适用的网络设置参数

服务商参数：当前服务商支持,值与当前服务商相关

注意：HE.net 不支持 id 参数，仅使用 token (DDNS Key)进行认证; ttl固定为300s。

使用限制

❌ 不支持自动创建记录：必须先在 HE.net 控制面板中手动创建 DNS 记录
⚠️ 仅支持更新：只能更新现有记录的 IP 地址，不能创建新记录
🔑 专用密码：每个记录都有独立的 DDNS 密码

故障排除

调试模式

启用调试日志查看详细信息：

ddns -c config.json --debug

常见问题

认证失败：检查动态 DNS 密码是否正确，确认记录已启用 DDNS 功能
域名未找到：确保记录已在 HE.net 控制面板中手动创建，域名拼写无误
记录更新失败：检查记录是否已启用动态 DNS，确认密码对应正确的记录
请求频率限制：HE.net 建议更新间隔不少于 5 分钟，避免频繁更新

HE.net 响应代码

响应代码	说明	解决方案
`good <ip>`	更新成功	操作成功
`nochg <ip>`	IP地址无变化	操作成功
`nohost`	主机名不存在	检查记录和DDNS设置
`badauth`	认证失败	检查动态DNS密码
`badagent`	客户端被禁用	联系HE.net支持
`abuse`	更新过于频繁	增加更新间隔

支持与资源

⚠️ 待验证状态：HE.net Provider 缺少充分的真实环境测试，建议在生产环境使用前进行充分测试。如遇问题请通过 GitHub Issues 反馈。

5.2 KiB Raw Permalink Blame History Unescape Escape