Skip to content

edgeone.md

Latest commit

 

History

History
160 lines (116 loc) · 7.33 KB

edgeone.md

File metadata and controls

160 lines (116 loc) · 7.33 KB

腾讯云 EdgeOne 配置指南

概述

腾讯云 EdgeOne（边缘安全速平台）是腾讯云提供的边缘计算和加速服务，支持动态管理加速域名的源站 IP 地址。本 DDNS 项目通过 EdgeOne API 进行加速域名的源站 IP 地址动态更新。

注意：此提供商用于管理 EdgeOne 的加速域名。如需管理非加速域名的普通 DNS 记录，请使用 EdgeOne DNS 提供商。

官网链接：

认证信息

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.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 记录管理：

{
    "$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 主要用于边缘加速场景，如需传统 DNS 解析服务，建议使用 腾讯云 DNS。如需管理 EdgeOne 托管的非加速域名 DNS 记录，请使用 EdgeOne DNS 提供商。