异常处理:若镜像下载失败,建议配置 Docker 镜像加速器或 HTTP/HTTPS 代理来辅助下载。适用说明
适用终端:绿联云 PC 客户端(Windows/macOS)、Web 浏览器端
适用版本:UGOS Pro 固件 1.20.0.0127 及更高版本
本文档描述仅供参考,实际界面可能因系统或应用版本不同而略有差异,请以界面实际显示为准。
简介
DDNS-GO 是一款动态域名解析工具,可将当前网络的公网 IP 自动同步到域名解析服务商,当公网 IP 发生变化时,DDNS-GO 会自动更新域名解析记录。配置完成后,用户可通过固定域名访问设备或已开放端口的服务。
本文以 Docker 部署 DDNS-GO 为例,介绍如何将动态公网 IP 更新到域名解析服务商,从而通过固定域名访问设备或设备中的容器服务。
使用前准备
配置前,请先完成以下准备:
● 已在 Docker 应用中配置可用的镜像加速器
● 已准备可用域名
● 已获取域名服务商的 AccessKey ID 和 AccessKey 密钥
● 已确认当前网络具备公网访问条件
● 已在路由器中了解端口转发的配置入口
● 已在“文件管理”中创建用于保存 DDNS-GO 配置文件的文件夹
说明:
● 域名购买和 AccessKey 获取步骤,请参考“如何购买域名并获取 AccessKey?”
● 如果需要从外网访问设备或容器服务,还需要在路由器中配置端口转发
● DDNS-GO 为第三方工具,服务商字段、授权方式和页面显示请以 DDNS-GO 实际页面为准
拉取镜像
1. 打开“Docker”应用,进入“镜像”。
2. 在“镜像仓库”页面搜索jeessy/ddns-go,点击“下载”。
3. 版本选择默认的 latest,点击“确定”,等待镜像拉取完成。
创建配置文件存放目录
1. 打开“文件管理”,进入docker共享文件夹。
2. 在docker文件夹内创建ddnsgo文件夹。
该文件夹用于保存 DDNS-GO 的配置文件。后续创建容器时,需要将该文件夹挂载到容器目录。
创建并配置容器
1. 打开“Docker”应用,进入“镜像”>“本地镜像”。
2. 找到已下载的jeessy/ddns-go镜像。
3. 点击右侧“+”创建容器。
4. 设置容器名称,打开“自动重启”。
5. 在“存储空间”中添加 NAS 目录,选择前面创建的ddnsgo文件夹,对应的容器目录填写/root,权限选择“读写”。
6. 网络模式选择 bridge。
7. 设置端口映射。
容器端口:9876
NAS 端口:39191
说明:
● 如果 NAS 端口已被占用,可改为其他端口。
● 如果修改 NAS 端口,访问 DDNS-GO 页面时需要使用修改后的端口。
● 如需使用 IPv6 网络,可将网络模式改为 host,并确认设备网卡已启用 IPv6。
8. 确认配置无误后,点击“完成”。
容器创建完成后,可在“容器”页面查看和管理 DDNS-GO 容器。
访问容器 Web 页面
容器启动后,可通过以下方式访问 DDNS-GO 页面。
方法 1:快速访问
1. 打开“Docker”应用,进入“容器”页面。
2. 找到 DDNS-GO 容器,点击“快速访问”,选择已配置的 Web 访问端口。
方法 2:浏览器访问
在浏览器地址栏输入http://NAS-IP:NAS端口
示例:http://192.168.1.100:9876
其中NAS-IP是 NAS 的局域网 IP 地址,NAS端口是创建容器时配置的 Web 管理页面端口。
初始化 DDNS-GO 配置
1. 设置一个账号和密码,点击“登录并配置为管理员账号”。
2. DNS 服务商选择“cloudflare”,Token 填写已获取的 AccessKey ID。
3. 根据公网 IP 类型选择配置方式。
如果使用 IPv4 公网地址:
● 在 Domains 中填写已配置的域名。
● 确认域名服务商、AccessKey 和域名记录填写正确。
如果使用 IPv6:
● 获取 IP 方式建议选择通过网卡获取。
● 确认设备网卡已开启 IPv6。
● Domains 中填写需要更新解析的域名。
4. 点击页面中的“保存”。
5. 查看右侧日志,确认是否提示解析成功。
配置端口转发
如果需要通过域名从外网访问设备或容器服务,需要在路由器中配置端口转发。请在路由器管理页面中,将外部访问端口转发到设备的局域网 IP 和对应服务端口。
示例:
项目 | 示例 |
内部 IP 地址 | 192.168.31.34 |
外部端口 | 9876 |
内部端口 | 9876 |
协议 | TCP |
不同路由器的端口转发入口和配置方式不同,请以路由器实际页面或官方说明为准。
使用域名访问服务
配置完成后,可使用域名和端口访问目标服务。
访问格式:http://域名:外部端口。
示例:http://example.com:9876。
如果使用二级域名,请使用已配置的完整域名访问。
常见问题
Q1:镜像拉取失败怎么办?
请检查以下项目:
● 设备网络连接是否正常
● 镜像名称 jeessy/ddns-go 是否填写正确
● Docker 镜像加速器是否可用
● 是否需要配置 HTTP/HTTPS 代理辅助拉取镜像
Q2:DDNS-GO 日志未提示解析成功怎么办?
请检查以下项目:
● AccessKey ID 和 AccessKey 密钥是否填写正确
● AccessKey 是否具备修改域名解析记录的权限
● 域名是否已在服务商控制台中完成解析配置
● 当前网络是否具备公网 IPv4 或 IPv6 地址
● DDNS-GO 中选择的 IP 获取方式是否与实际公网 IP 类型一致
Q3:域名解析成功,但外网仍无法访问怎么办?
请检查以下项目:
● 路由器端口转发是否已正确配置
● 外部端口是否与访问地址中的端口一致
● 目标容器或服务是否正在运行
● 设备防火墙、路由器防火墙或运营商是否限制相关端口
● 当前网络是否存在多级路由或运营商 NAT
注意事项
● AccessKey ID、AccessKey 密钥和 API Token 属于敏感信息,请妥善保管,避免泄露
● 开放公网端口会增加被外部访问的风险,请仅开放实际需要使用的端口,并为相关服务设置强密码
● DDNS-GO 和相关镜像由第三方维护,功能变化、镜像更新和安全风险请以第三方项目说明为准
● 域名服务商的授权方式、解析规则和访问限制可能会调整,请以服务商实际说明为准