腾讯云 EdgeOne 配置指南
概述
腾讯云 EdgeOne（边缘安全速平台）是腾讯云提供的边缘计算和加速服务，支持动态管理加速域名的源站 IP 地址。本 DDNS 项目通过 EdgeOne API 进行加速域名的源站 IP 地址动态更新。
注意：此提供商用于管理 EdgeOne 的加速域名。如需管理非加速域名的普通 DNS 记录，请使用 EdgeOne DNS 提供商。
官网链接：
- 官方网站：https://cloud.tencent.com/product/teo
- EdgeOne 国际版：https://edgeone.ai
- 服务商控制台：https://console.cloud.tencent.com/edgeone
认证信息
SecretId/SecretKey 认证
使用腾讯云 SecretId 和 SecretKey 进行认证，与腾讯云 DNS 使用相同的认证方式。
与腾讯云 DNS 相同，EdgeOne 使用 SecretId 和 SecretKey 进行认证。但是权限要求不同，需要确保账号具有 EdgeOne 的操作权限。
获取认证信息
jsonc
{
"dns": "edgeone",
"id": "SecretId", // 腾讯云 SecretId
"token": "SecretKey" // 腾讯云 SecretKey
}权限要求
确保使用的腾讯云账号具有以下权限：
- QcloudTEOFullAccess：EdgeOne 完全访问权限（推荐）
- QcloudTEOReadOnlyAccess + 自定义写权限：精细化权限控制
可以在 访问管理 中查看和配置权限。
完整配置示例
加速域名配置（默认）
jsonc
{
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
"dns": "edgeone", // 当前服务商
"id": "your_secret_id", // 腾讯云 SecretId
"token": "your_secret_key", // 腾讯云 SecretKey
"index4": ["url:http://api.ipify.cn", "public"], // IPv4地址来源
"index6": "public", // IPv6地址来源
"ipv4": ["ddns.newfuture.cc"], // IPv4 域名
"ipv6": ["ipv6.ddns.newfuture.cc"], // IPv6 域名
"endpoint": "https://teo.tencentcloudapi.com" // API端点
}通过 extra 参数切换域名类型
EdgeOne 提供商支持通过 extra.teoDomainType 参数灵活切换加速域名和普通 DNS 记录管理：
jsonc
{
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json",
"dns": "edgeone",
"id": "your_secret_id",
"token": "your_secret_key",
"ipv4": ["ddns.newfuture.cc"],
"extra": {
"teoDomainType": "dns" // 切换为 DNS 记录模式（非加速域名）
}
}teoDomainType 参数说明
| 值 | 说明 | 对应 API |
|---|---|---|
acceleration | 加速域名（默认） | DescribeAccelerationDomains, CreateAccelerationDomain, ModifyAccelerationDomain |
dns | DNS 记录（非加速域名） | DescribeDnsRecords, CreateDnsRecord, ModifyDnsRecords |
注意：
teoDomainType参数不区分大小写（dns、DNS、Dns均有效）- 推荐使用专用的 EdgeOne DNS 提供商，代码更简洁清晰
参数说明
| 参数 | 说明 | 类型 | 取值范围/选项 | 默认值 | 参数类型 |
|---|---|---|---|---|---|
| dns | 服务商标识 | 字符串 | edgeone, edgeone_acc, teo_acc | 无 | 服务商参数 |
| id | 认证 ID | 字符串 | 腾讯云 SecretId | 无 | 服务商参数 |
| token | 认证密钥 | 字符串 | 腾讯云 SecretKey | 无 | 服务商参数 |
| teoDomainType | 域名类型 | 字符串 | acceleration, dns | acceleration | 服务商参数 |
| index4 | IPv4 来源 | 数组 | 参考配置 | default | 公用配置 |
| index6 | IPv6 来源 | 数组 | 参考配置 | default | 公用配置 |
| ipv4 | IPv4 域名 | 数组 | 域名列表 | 无 | 公用配置 |
| ipv6 | IPv6 域名 | 数组 | 域名列表 | 无 | 公用配置 |
| extra | 额外参数 | 对象 | {"teoDomainType": "dns"} 等 | 无 | 服务商参数 |
| endpoint | API 端点 | URL | 参考下方 | https://teo.tencentcloudapi.com | 服务商参数 |
| proxy | 代理设置 | 数组 | 参考配置 | 无 | 公用网络 |
| ssl | SSL 验证方式 | 布尔/字符串 | "auto"、true、false | auto | 公用网络 |
| cache | 缓存设置 | 布尔/字符串 | true、false、filepath | true | 公用配置 |
| log | 日志配置 | 对象 | 参考配置 | 无 | 公用配置 |
参数类型说明：
- 公用配置：所有支持的DNS服务商均适用的标准DNS配置参数
- 公用网络：所有支持的DNS服务商均适用的网络设置参数
- 服务商参数：当前服务商支持,值与当前服务商相关
EdgeOne 的 TTL 实际的缓存策略由 EdgeOne 平台管理。
endpoint
腾讯云 EdgeOne 支持国内和国际版API端点，可根据区域和账号类型选择：
国内版
- 默认（推荐）：
https://teo.tencentcloudapi.com
国际版
- 国际版：
https://teo.intl.tencentcloudapi.com
注意：请根据您的腾讯云账号类型选择对应的端点。国内账号使用国内版端点，国际账号使用国际版端点。如果不确定，建议使用默认的国内版端点。
故障排除
调试模式
启用调试日志查看详细信息：
sh
ddns -c config.json --debug常见问题
- 认证失败：检查 SecretId 和 SecretKey 是否正确，确认账号权限
- 站点未找到：确保域名已添加到 EdgeOne 站点，域名状态正常
- 加速域名不存在：确认域名已在 EdgeOne 中配置为加速域名
- 权限不足：确保账号具有 EdgeOne 的管理权限
支持与资源
注意：EdgeOne 主要用于边缘加速场景，如需传统 DNS 解析服务，建议使用 腾讯云 DNS。如需管理 EdgeOne 托管的非加速域名 DNS 记录，请使用 EdgeOne DNS 提供商。