核心功能#

• 自动检测 IP 变化：定时检测本机的公网 IPv4 / IPv6 地址
• 自动更新 DNS 记录：当 IP 发生变化时，自动调用 DNS 服务商 API 更新解析记录
• 多服务商支持：阿里云、腾讯云、Cloudflare、华为云等 20+ DNS 服务商
• Webhook 通知：IP 变化时可触发 Webhook 回调（如发送通知到企业微信、钉钉等）
• Web 管理界面：提供可视化的配置和状态查看页面

适用场景#

家庭宽带或企业网络的公网 IP 通常是动态分配的，每次拨号或重启路由器后 IP 会变化。如果需要通过域名稳定访问内网服务（如 NAS、远程桌面、自建网站等），就需要 DDNS 来保持域名与 IP 的同步。

特性#

• 支持 Mac、Windows、Linux 系统，支持 ARM、x86、RISC-V 架构
• 支持接口/网卡/命令获取 IP
• 支持以服务的方式运行
• 默认间隔 5 分钟同步一次
• 支持同时配置多个 DNS 服务商
• 支持多个域名同时解析
• 支持多级域名
• 网页中配置，简单方便，默认勾选”禁止从公网访问”
• 网页中可快速查看最近 50 条日志
• 支持 Webhook 通知
• 支持 TTL
• 支持部分 DNS 服务商传递自定义参数，实现地域解析/多 IP 等功能

开源地址#

• GitHub：jeessy2/ddns-go

前置条件#

• 已安装 Docker
• 拥有一台具有公网 IP 的设备（或路由器已做端口映射）

推荐：使用 host 模式部署#

挂载主机目录，使用 Docker host 模式。可把 /opt/ddns-go 替换为主机任意目录，配置文件为隐藏文件：

1
docker run -d \
2
  --name ddns-go \
3
  --restart=always \
4
  --net=host \
5
  -v /opt/ddns-go:/root \
6
  jeessy/ddns-go

1
http://<服务器IP>:9876

可选：使用 ghcr.io 镜像#

如无法访问 Docker Hub，可使用 GitHub Container Registry 镜像：

1
docker run -d \
2
  --name ddns-go \
3
  --restart=always \
4
  --net=host \
5
  -v /opt/ddns-go:/root \
6
  ghcr.io/jeessy2/ddns-go

可选：自定义监听地址和同步间隔#

通过 -l 指定监听地址，-f 指定同步间隔（单位：秒）：

1
docker run -d \
2
  --name ddns-go \
3
  --restart=always \
4
  --net=host \
5
  -v /opt/ddns-go:/root \
6
  jeessy/ddns-go -l :9877 -f 600

以上命令将监听端口改为 9877，同步间隔改为 600 秒（10 分钟）。

可选：不使用 host 模式#

在不使用 host 模式时，需要手动映射端口。注意：此模式下无法通过网卡获取 IPv6 地址：

1
docker run -d \
2
  --name ddns-go \
3
  --restart=always \
4
  -p 9876:9876 \
5
  -v /opt/ddns-go:/root \
6
  jeessy/ddns-go

可选：重置密码#

若忘记管理页面密码，可通过以下命令重置：

1
docker exec ddns-go ./ddns-go -resetPassword 123456
2
docker restart ddns-go

前提条件#

• 你的设备能正常获取 IPv6 地址，并能通过 IPv6 正常访问外网
• 虚拟机中使用有可能正常获取 IPv6，但不能正常访问 IPv6

各平台推荐方式#

Linux 中使用 Docker 的 --net=host 模式（推荐）#

在 Linux 服务器上，DDNS-GO 需要通过 --net=host 模式直接访问宿主机的网卡，才能正确获取 IPv6 全局地址。

原因：Docker 的桥接网络（bridge）默认不支持 IPv6 的 SLAAC 地址获取，容器内部无法拿到宿主机的真实 IPv6 地址。使用 --net=host 后，容器与宿主机共享网络栈，DDNS-GO 可以直接读取宿主机网卡上的 IPv6 地址。

部署命令：

1
docker run -d \
2
  --name ddns-go \
3
  --restart=always \
4
  --net=host \
5
  -v /opt/ddns-go:/root \
6
  jeessy/ddns-go

部署完成后，在配置页面的 IPv6 区域，获取 IP 方式选择”通过网卡获取”，即可自动读取宿主机的 IPv6 地址。

当前ddns-go使用Windows桌面版Docker部署的，不支持--net=host无法拿到网卡：

群晖 NAS 配置#

1. 套件中心下载 Docker 并打开
2. 注册表中搜索 ddns-go 并下载
3. 映像 -> 选择 jeessy/ddns-go -> 启动 -> 高级设置 -> 网络中勾选 使用与 Docker Host 相同的网络
4. 高级设置中勾选 启动自动重新启动
5. 在浏览器中打开 http://群晖IP:9876，修改配置

IPv6 地址匹配#

设备通常有多个 IPv6 地址（如链路本地地址 fe80::、临时隐私地址等），可通过以下方式精确匹配：

• @1：指定第一个 IPv6 地址
• @2：指定第二个 IPv6 地址
• 正则表达式：匹配特定格式的 IPv6 地址
• 留空：不启用匹配，使用默认地址

DNS 服务商#

用于指定域名所在的 DNS 服务商，DDNS-GO 通过调用服务商提供的 API 来更新 DNS 解析记录。

支持的服务商包括：

选择服务商后，需要填写对应的 AccessKey 信息：

HTTP 请求网卡#

此选项用于多网卡环境下，指定通过哪个网卡发起获取 IP 的 HTTP 请求。大多数情况下保持默认即可。

IPv4 配置#

用于启用和配置 IPv4 地址的动态解析。

IPv6 配置#

用于启用和配置 IPv6 地址的动态解析。

其他设置#

用于配置 DDNS-GO 管理页面的访问安全。

安全建议：建议设置强密码，并启用”禁止公网访问”以提高安全性。若需远程管理，可通过 VPN 或反向代理访问。

Webhook 配置#

IP 地址发生变化时，DDNS-GO 可以通过 Webhook 发送通知或触发自定义操作。

1
Authorization: Bearer API_KEY

1
{
2
    "msgtype": "markdown",
3
    "markdown": {
4
        "title": "你的公网IP变了",
5
        "text": "#### 你的公网IP变了 \n - IPv4地址：#{ipv4Addr} \n - 域名更新结果：#{ipv4Result} \n"
6
    }
7
}

1
{
2
    "msg_type": "post",
3
    "content": {
4
        "post": {
5
            "zh_cn": {
6
                "title": "你的公网IP变了",
7
                "content": [
8
                    [
9
                        {
10
                            "tag": "text",
11
                            "text": "IPv4地址：#{ipv4Addr}"
12
                        }
13
                    ],
14
                    [
15
                        {
16
                            "tag": "text",
17
                            "text": "域名更新结果：#{ipv4Result}"
18
                        }
19
                    ]
20
                ]
21
            }
22
        }
23
    }
24
}

1
{
2
    "msg": {
3
        "from_user_id": "",
4
        "to_user_id": "$your_user_id@im.wechat",
5
        "client_id": "ddns-#{timestamp}",
6
        "message_type": 2,
7
        "message_state": 2,
8
        "item_list": [
9
            {
10
                "type": 1,
11
                "text_item": {
12
                    "text": "📡 IPv4: #{ipv4Result}\n   新地址: #{ipv4Addr}\n   已绑定域名: #{ipv4Domains}\n\n📡 IPv6: #{ipv6Result}\n   新地址: #{ipv6Addr}\n   已绑定域名: #{ipv6Domains}"
13
                }
14
            }
15
        ]
16
    },
17
    "base_info": {
18
        "channel_version": "2.1.7"
19
    }
20
}

1
Content-Type: application/json
2
AuthorizationType: ilink_bot_token
3
Authorization: Bearer $your_bot_token
4
iLink-App-Id: bot
5
iLink-App-ClientVersion: 131335

Callback 配置#

通过自定义回调可支持更多第三方 DNS 服务商。配置的域名有几行，就会回调几次。

支持的变量：

• 若 RequestBody 为空则为 GET 请求，否则为 POST 请求
• 完整配置参考：Callback 配置参考