FAQ

常见问题

D-NET

1. 忘记 Web 界面密码怎么办？

# 二进制方式
./dnet -resetPassword 新密码

# Docker 方式
docker exec dnet ./dnet -resetPassword 新密码 && docker restart dnet

2. Web 界面无法访问怎么办？

• 确认服务是否正常运行：sudo ./dnet -s status
• 确认访问地址和端口是否正确，默认为 http://localhost:9877
• 检查防火墙是否放行了对应端口
• 查看日志排查报错原因

3. 如何查看运行日志？

# 二进制服务方式（系统日志）
# macOS
log show --predicate 'process == "dnet"' --last 1h

# Linux (systemd)
journalctl -u dnet -f

# Docker
docker logs -f dnet

4. 配置文件在哪里？

配置文件默认保存在程序运行目录下的 config.yaml，Docker 部署时位于挂载目录（如 /opt/dnet/config.yaml）。可通过 -c 参数自定义路径。

5. 同步间隔设置多少合适？

参考最佳实践 - 同步间隔和缓存参数。一般家庭宽带建议 120～300 秒，IP 变化不频繁时可设置 600 秒。

---

DCDN

1. 如何获取云厂商的 AccessKey？

• 阿里云：访问 RAM 访问控制 创建 AccessKey
• 百度智能云：访问 安全认证 创建 AccessKey
• 腾讯云：访问 API 密钥管理 创建 SecretId 和 SecretKey
• Cloudflare：登录后进入 My Profile → API Tokens → Create Token，选择 Edit zone DNS 模板

2. 端口配置有什么限制？

• 阿里云 ESA：不支持自定义端口
• 阿里云 CDN/DCDN：不支持自定义 HTTPS 端口
• 腾讯云 CDN 协议跟随：不允许自定义端口号

3. 支持多少个源站？

• 阿里云 ESA：最多 1 个源站
• 阿里云 CDN：最多 20 个源站
• 阿里云 DCDN：最多 20 个源站
• 百度智能云 CDN/DRCDN：最多 10 个源站
• 腾讯云 EdgeOne：最多 1 个源站
• 腾讯云 CDN：最多 5 个源站

4. CNAME 获取失败怎么办？

• 检查域名是否已在云厂商控制台完成归属权验证，参考域名归属验证
• 检查 AccessKey 是否正确且具有 CDN 管理权限
• 查看 D-NET 日志获取详细错误信息
• 等待几分钟后刷新页面重试

5. 配置完成后使用加速域名无法访问？

• 确认 DNS 已将加速域名解析为 CDN 分配的 CNAME 值
• 确认源站 IP 本身可以直接访问（绕过 CDN 测试）
• 检查回源端口和协议是否与服务实际监听的一致
• 检查服务器或路由器防火墙是否放行了对应端口
• 部分 CDN 审核需要一定时间，新建域名等待 5～10 分钟后重试

6. 源站 IP 已更新但 CDN 仍然回源到旧 IP？

• CDN 节点有缓存，源站 IP 更新后通常需要几分钟生效
• 检查 D-NET 日志确认更新是否成功
• 在云厂商控制台手动刷新源站配置验证

---

DDNS

1. 如何获取云厂商的 AccessKey？

• 阿里云：访问 RAM 访问控制 创建 AccessKey
• 腾讯云：访问 API 密钥管理 创建 SecretId 和 SecretKey
• 华为云：访问 我的凭证 创建 AccessKey
• 百度智能云：访问 安全认证 创建 AccessKey
• Cloudflare：登录后进入 My Profile → API Tokens → Create Token，选择 Edit zone DNS 模板，填入 AccessKey 字段，AccessSecret 留空

2. DNS 记录更新了但域名解析没有变化？

• DNS 解析受 TTL 缓存影响，需等待上一次 TTL 到期后才生效
• 可以用 nslookup 或 dig 查询具体 DNS 服务器验证记录是否已更新
• 检查 D-NET 日志确认是否真的触发了更新

3. 获取不到 IPv6 地址？

• 确认系统网卡已分配公网 IPv6（使用 ip -6 addr 或 ifconfig 查看）
• Docker 部署时必须使用 Host 网络模式（仅 Linux），端口映射模式无法读取宿主机网卡
• 如果网卡有多个 IPv6 地址，使用正则表达式筛选目标地址，参考 DDNS 使用指南 - IP 来源类型

4. 获取不到公网 IPv4 地址？

• 家庭宽带通常路由器拨号，服务器网卡上是内网 IP，需使用 URL 获取方式（如 https://4.ipw.cn）
• 检查 URL 可达性：curl https://4.ipw.cn

5. CNAME 记录配置后其他记录消失了？

• 这是预期行为。CNAME 与 A/AAAA/TXT 记录在同一子域名下互斥，添加 CNAME 时 D-NET 会自动删除冲突记录，反之亦然。详见 DDNS 使用指南。

6. 记录更新频率太高，想减少 API 调用？

• D-NET 内置 IP 变化检测，只有 IP 发生变化才会调用 DNS API
• 可适当增大同步间隔 -f（如 300 秒）
• 增大 -ddnsCacheTimes 减少强制同步频率