DDNS/docs/providers/edgeone.md

腾讯云 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 的操作权限。

获取认证信息

1. 登录 腾讯云控制台
2. 访问 API密钥管理
3. 点击"新建密钥"按钮
4. 复制生成的 SecretId 和 SecretKey，请妥善保存
5. 确保账号具有 EdgeOne 的操作权限

{
    "dns": "edgeone",
    "id": "SecretId",     // 腾讯云 SecretId
    "token": "SecretKey"  // 腾讯云 SecretKey
}

权限要求

确保使用的腾讯云账号具有以下权限：

• QcloudTEOFullAccess：EdgeOne 完全访问权限（推荐）
• QcloudTEOReadOnlyAccess + 自定义写权限：精细化权限控制

可以在 访问管理 中查看和配置权限。

完整配置示例

加速域名配置（默认）

{
    "$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.org", "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 记录管理：

{
    "$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

注意：请根据您的腾讯云账号类型选择对应的端点。国内账号使用国内版端点，国际账号使用国际版端点。如果不确定，建议使用默认的国内版端点。

故障排除

调试模式

启用调试日志查看详细信息：

ddns -c config.json --debug

常见问题

• 认证失败：检查 SecretId 和 SecretKey 是否正确，确认账号权限
• 站点未找到：确保域名已添加到 EdgeOne 站点，域名状态正常
• 加速域名不存在：确认域名已在 EdgeOne 中配置为加速域名
• 权限不足：确保账号具有 EdgeOne 的管理权限

支持与资源

• 腾讯云 EdgeOne 产品文档
• EdgeOne API 文档
• EdgeOne 控制台
• 腾讯云技术支持

注意：EdgeOne 主要用于边缘加速场景，如需传统 DNS 解析服务，建议使用 腾讯云 DNS。如需管理 EdgeOne 托管的非加速域名 DNS 记录，请使用 EdgeOne DNS 提供商。