添加域名(20230618)

向DNS服务添加解析，将域名解析到指定的节点，若未指定则解析到源站，等待后续配置

向ETCD中指定节点配置添加初始化配置（默认防火墙配置、默认缓存配置等）

域名及其配置存入数据库，用于查询

选择四层还是七层转发

支持泛域名、域名检查、域名备案

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

string

必需

默认值:

application/json

Body 参数application/json

domain

string

加速域名

必需

>= 1 字符<= 998 字符

config_list

array [object {14}]

七层配置列表

必需

protocol

string

代理协议

可选

boolean

http2开关

必需

是否开启http2

tls

string

tls版本

可选

V10 V11 V12 V13，如果使用下面两条配置，则该配置不应该启用

maxVersion

string

tls支持的最大版本

可选

VersionTLS10 ，VersionTLS11 ，VersionTLS12 ，VersionTLS13

minVersion

string

tls支持的最小版本

可选

VersionTLS10 ，VersionTLS11 ，VersionTLS12 ，VersionTLS13

port

integer

代理端口

可选

uri_forward

string

uri转发

可选

redirect

boolean

301跳转

可选

1/0

overload_type

integer

并发超限类型

必需

1:400阻断；2:301跳转；3:自定义

overload_status_code

integer

并发超限阻断状态码

必需

overload_redirect_url

string

并发超限跳转

必需

填写的跳转地址需要带协议，如 https://www.jd.com

load_balancing

integer

负载均衡

必需

(0, "Equaly"), (1, "Weight"), (2, "IPHash"), (3, "URLHash")

server

string

必需

source_addresses

array [object {11}]

源地址

可选

primary_domain

string

主域名

必需

生成二级域名的主域名

domain_config

object

域名相关配置

必需

cache_total_size_limit

integer

必需

缓存文件整体容量限制(单位KB)

cache_file_size_limit

integer

必需

缓存单文件容量限制(单位KB)

nodes

array [object {3}]

节点列表

必需

node_uuid

string

节点uuid

必需

priority

integer

优先级

必需

解析至最大的一个节点

node_type

string

主备标记

必需

primary/backup 二选一

four_layers_config

array [object {13}]

四层转发配置

必需

protocol

string

协议

可选

tcp/udp

tcp_version

integer

TCP版本

可选

仅TCP协议下填写，写1即可（弃用，为保证兼容，建议仍然填写1）

port

integer

端口号

可选

max_connection

string

最大并行连接数

必需

设置（更新）特定 uuid 的最大连接数 0则不限制

new_connection

string

新建连接数量限制

必需

设置（更新）特定 uuid 的新建连接数 0则不限制

load_balancing

string

负载均衡

必需

(0, "Equaly"), (1, "Weight")

source_address

array [object {3}]

源地址

可选

proxy_protocol

integer

转发真实IP

必需

是否转发真实IP，0-不转发 1-使用明文转发 2-使用密文转发

rate_limit

integer

必需

仅对udp生效，UDP发包频率限制，单位（次/秒），若不填写则不限制发包频率，若填0，也不限制发包频率

interval

integer

健康检查时间间隔

必需

默认10秒，仅对tcp生效

timeout

integer

健康检查超时判断时间

必需

默认5秒，仅对tcp生效

recover_times

integer

健康检查恢复判定次数

必需

仅对tcp生效

health_check_active

boolean

健康检查开关

必需

仅对tcp生效

示例

{
  "domain": "string",
  "config_list": [
    {
      "protocol": "string",
      "h2": true,
      "tls": "string",
      "maxVersion": "string",
      "minVersion": "string",
      "port": 0,
      "uri_forward": "string",
      "redirect": true,
      "overload_type": 0,
      "overload_status_code": 0,
      "overload_redirect_url": "string",
      "load_balancing": 0,
      "server": "string",
      "source_addresses": [
        {
          "address": "string",
          "protocol": "string",
          "concurrent": 0,
          "weight": 0,
          "port": 0,
          "sni": "string",
          "health_check_active": true,
          "timeout": 0,
          "interval": 0,
          "sourceHTTP2": true,
          "httpKeepAlives": true
        }
      ]
    }
  ],
  "primary_domain": "string",
  "domain_config": {
    "cache_total_size_limit": 0,
    "cache_file_size_limit": 0
  },
  "nodes": [
    {
      "node_uuid": "string",
      "priority": 0,
      "node_type": "string"
    }
  ],
  "four_layers_config": [
    {
      "protocol": "string",
      "tcp_version": 0,
      "port": 0,
      "max_connection": "string",
      "new_connection": "string",
      "load_balancing": "string",
      "source_address": [
        {
          "address": "string",
          "port": 0,
          "weight": 0
        }
      ],
      "proxy_protocol": 0,
      "rate_limit": 0,
      "interval": 0,
      "timeout": 0,
      "recover_times": 0,
      "health_check_active": true
    }
  ]
}

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object (节点信息（全量）)

必需

integer

必需

primary_ip

string

主IP（20230429新增）

必需

主IP

node_ip

array [object {3}]

必需

node_name

string

名称

必需

node_uuid

string

节点uuid

必需

alive

boolean

节点存活性（20230429新增）

必需

True-存活 False-不存活

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "id": 0,
    "primary_ip": "string",
    "node_ip": [
      {
        "node_ip": "string",
        "isp": "string",
        "connectivity": true
      }
    ],
    "node_name": "string",
    "node_uuid": "string",
    "alive": true
  }
}

添加域名(20230618)

请求参数

示例代码

返回响应