DDNS-win版-自有域名动态解析客户端使用说明

乐维同学

Windows 桌面版 · 定时检测公网 IP 变化，自动更新阿里云 / 腾讯云（DNSPod）解析记录

一、软件简介

家里或公司的宽带每次拨号都会拿到一个新的动态公网 IP，域名解析若不跟着变，远程访问就会中断。DDNS 客户端常驻系统托盘，按设定间隔检测本机公网 IPv4 / IPv6，一旦变化就自动调用云厂商 API 更新 A / AAAA 解析记录，让域名始终指向最新 IP。

它不依赖任何第三方服务平台：密钥只保存在本机，客户端使用官方签名算法（阿里云 ACS3-HMAC-SHA256、腾讯云 TC3-HMAC-SHA256）直连云厂商 API，无中间服务器、不上传任何数据。

二、功能特性

• 直连阿里云 / 腾讯云：在客户端内配置密钥即可，无需服务端中转
• 多域名 × 多子域 × 多记录类型：批量管理 A（IPv4）/ AAAA（IPv6）记录
• 幂等更新：值相同自动跳过、不同自动更新、记录不存在自动新建，重复执行不会产生脏数据
• 双栈检测：多探测源自动切换，IPv4 / IPv6 强制隔离网络栈互不串扰
• 托盘常驻：关闭窗口最小化到托盘，支持「立即检测并上报」
• 开机自启：静默启动到托盘，全自动无人值守
• 配置热更新：保存后立即生效，无需重启
• 日志可追溯：界面实时显示 + 自动落盘保存
  

三、界面总览

主界面分三个选项卡：首页（运行状态与日志）、设置（基本设置与域名配置）、使用说明（内置帮助）。

图 1：首页 —— 运行状态、手动操作与运行日志

• 运行状态：实时显示当前公网 IPv4 / IPv6、局域网 IP、最近检测与应用时间、最近结果与错误。
• 启动 / 状态：点击「启动自动更新」开始按间隔轮询；徽章显示运行状态。
• 手动检测：「立即检测 IP」仅刷新检测值；「立即检测并更新解析」检测并立即应用一次。
• 运行日志：失败条目红色高亮；日志自动保存于 %AppData%\ddns-client\logs\client.log，可一键打开。
  

四、快速上手（四步）第 1 步：获取云厂商 API 密钥

域名托管在哪家，就使用哪家的密钥：

• 阿里云：登录 RAM 访问控制台（ram.console.aliyun.com）→ 创建子用户 → 勾选 AliyunDNSFullAccess（或自定义仅含云解析 DNS 读写权限的策略）→ 创建 AccessKey。
• 腾讯云：登录访问管理控制台（cam.console.cloud.tencent.com）→ 子用户 → 授权 QcloudDNSPodReadOnlyWrite → 创建 API 密钥，得到 SecretId / SecretKey。
  

[size=0.93]安全提示：切勿使用主账号密钥。请使用仅授予 DNS 权限的子账号密钥，泄露影响可控；密钥仅保存在本机配置文件中。
第 2 步：添加域名配置

进入「设置」选项卡，先完成基本设置（检测间隔建议 300 秒、按需勾选 IPv4 / IPv6），再点击「+ 添加域名」：

图 2：设置页 —— 基本设置与已添加的域名解析配置（密钥默认打码显示）

图 3：域名配置表单 —— 各字段填写说明见表 1

表 1：域名配置字段说明

字段	填写说明
名称	自定义备注（可留空），仅用于列表展示
服务商	阿里云（云解析 DNS） 或 腾讯云（DNSPod），按域名托管位置选择；选中后可点「获取密钥」直达控制台
密钥	阿里云填 AccessKeyId / AccessKeySecret；腾讯云填 SecretId / SecretKey（输入框打码显示，保存时自动去除首尾空白）
主域名	托管的根域名，如 example.com
子域名	逗号分隔可填多个，@ 表示根域本身，如 www,home,@
记录类型	A = IPv4，AAAA = IPv6，按需勾选；运营商未分配 IPv6 时只勾 A 即可
TTL（秒）	解析缓存时间，DDNS 场景建议 600，越小生效越快
线路	建议留空使用默认线路；阿里云填 default、腾讯云填 默认 均可（新版已自动兼容两种写法）

第 3 步：保存并测试凭据

点击「保存配置」（保存后立即生效），然后点击域名卡片上的「测试凭据」，验证密钥与权限是否有效。提示成功即可进入下一步；失败请对照文末常见问题排查。

第 4 步：启动自动更新

回到「首页」，点击「启动自动更新」。此后客户端按设定间隔检测公网 IP，变化时自动更新解析；也可随时点「立即检测并更新解析」手动触发。

[size=0.93]更新采用幂等策略：记录值与当前 IP 相同 → 跳过（unchanged）；不同 → 更新（updated）；记录不存在 → 自动新建（created）。首次为新子域名创建记录也能一次成功。
五、托盘与开机自启

• 最小化到托盘：关闭窗口不会退出程序，仅隐藏到右下角托盘（可在设置中改为退出时确认）。
• 托盘菜单：显示 / 隐藏主窗口、立即检测并上报、退出。
• 开机自启：勾选「开机自动启动」（写入当前用户注册表 Run 键，无需管理员权限）。
• 全自动无人值守：同时勾选「开机自动启动」+「启动后自动开始解析」，开机后静默运行于托盘，自动完成检测与解析更新。
  

六、配置文件（高级）

配置保存于 %AppData%\ddns-client\config.json；设置环境变量 DDNS_CLIENT_CONFIG_FILE 可指定其他路径（便于多实例 / 便携使用）。一般无需手改，界面保存即写入。

字段	说明	默认
interval_sec	检测间隔（秒），最小 30	300
ipv4_enabled / ipv6_enabled	是否检测并上报 IPv4 / IPv6	true / false
auto_start	启动后自动开始解析	false
minimize_to_tray	关闭窗口最小化到托盘	true
domains	域名配置数组，字段与界面一一对应（provider / domain / subdomains / types / ttl / line 及密钥）	[]

七、常见问题（FAQ）

问题 / 报错	原因与解决
提示 SignatureDoesNotMatch / AuthFailure.SignatureFailure	密钥不正确，或复制时带入空格 / 换行。请重新生成密钥并重新粘贴（程序会自动去除首尾空白）。
提示 InvalidAccessKeyId.NotFound / AuthFailure.SecretIdNotFound	密钥 ID 填错，或密钥已被禁用 / 删除。请到控制台核对。
腾讯云提示 [InvalidParameter.RecordLineInvalid] 记录线路不正确	旧版本把阿里云写法 default 直接发给了腾讯云。请升级到新版（已自动兼容），或把线路改为中文「默认」。
腾讯云提示 [ResourceNotFound.NoDataOfRecord] 记录列表为空	旧版本把「子域下无记录」当作错误，导致无法首次新建。请升级到新版，首次会自动创建记录。
提示 [InvalidAction] RecordCreate is invalid	旧版本 action 名拼写错误。请升级到新版（已改为 CreateRecord / ModifyRecord）。
检测不到 IPv6	本机或运营商未分配公网 IPv6（路由器需开启 IPv6）。用不了就取消勾选「检测 IPv6」。
解析记录没有更新	到「首页」查看运行日志（失败行红色高亮）；日志文件在 %AppData%\ddns-client\logs\client.log，点「打开文件」直达。
Windows Server 启动无反应	首次运行会自动引导安装 WebView2 运行时；若仍失败，查看 %TEMP%\ddns-client.log。
修改配置后多久生效	保存即生效；自动更新运行中时，下一轮检测按新配置执行。
换电脑 / 重装系统如何迁移	复制 %AppData%\ddns-client\config.json 到新机相同路径即可（内含密钥，注意保管）。

八、运行环境与获取方式

• 系统要求：Windows 10 / 11 及 Windows Server 2016+（64 位）；WebView2 运行时缺失时程序会自动引导安装。
• 安装方式：绿色单文件，下载后直接运行，无需安装；建议放到独立目录（如 D:\Tools\DDNS\）再配置开机自启。
• 体积：单文件约 4.3 MB（UPX 压缩）。
• 开源构建：Go 1.25 + Wails3 + 原生前端，自行编译执行 cd client && wails3 build，产物位于 bin/client.exe。
  

九、版本更新记录

日期	版本	更新内容
2026-10-24	1.0.3	修复腾讯云新建 / 修改记录的 action 名（CreateRecord / ModifyRecord）；修复腾讯云「记录列表为空」导致首次无法新建 AAAA 记录；解析线路兼容 default / 「默认」两种写法；发行版 UPX 压缩至 4.3 MB。
2026-10-15	1.0.2	托盘交互优化，关闭窗口最小化可配置。
2026-10-10	1.0.0	首个公开版：阿里云 / 腾讯云直连、多域名配置、IPv6 支持、开机自启。

下载地址：本地下载

乐维同学

家庭宽带无法使用的常用 Web 端口主要是这几个：‌80、8080、443、53‌，部分地区还会封 25、110、445、3389 等端口。‌‌
无公网IP的就别折腾了。
无公网IP的就别折腾了。
无公网IP的就别折腾了。
🚫 被封端口的用途
‌80‌：HTTP 标准端口，建站最常用，基本必封。
‌443‌：HTTPS 加密端口，同样必封。
‌8080‌：HTTP 替代端口，常被 Tomcat 等用，也基本封死。
‌53‌：DNS 服务端口，封掉防止私搭 DNS。
‌25‌：SMTP 邮件发送端口，防垃圾邮件，常封。
‌110‌：POP3 邮件接收端口，部分地区封。
‌445‌：SMB 文件共享端口，防勒索病毒和共享漏洞，常封。
‌3389‌：远程桌面端口，防暴力破解，部分封。
✅ 能用的替代方案
‌高位端口随便用‌：10000–65535 基本开放，如 23456、8082 等，直接映射即可