快速上手

流程复制链接

1. 完成初始化向导：创建唯一的账户与默认集群。
2. 接入节点：在控制台生成安装命令，在节点主机上执行；节点注册后经 mTLS 连接节点通道。
3. 新建网站：填写域名、源站与缓存设置，集群发布新的配置版本。
4. 配置 DNS：在权威 DNS 中把网站域名指向网站 域名 页签列出的边缘地址或 CNAME 目标，等待记录生效。
5. 启用 HTTPS：在网站的 HTTPS 页签点击「启用 HTTPS」，证书签发后自动启用，见 HTTPS 与证书。
6. 验证：网站 概览 页签的 上线检查 全部通过，用 curl 检查回源与缓存。

节点安装、DNS 生效与证书签发各需等待，耗时取决于网络与服务商。

前提复制链接

1. 完成初始化向导复制链接

1. 从控制台日志读取 setup token。Docker Compose 部署：

   复制

   docker compose logs console | grep setupToken

   日志行为 JSON，setupToken 字段为 token（ews_ 开头），url 字段为初始化页地址。未初始化的控制台每次启动打印同一个 token。其他部署方式的日志位置见 Docker Compose 与 宝塔面板 / aaPanel。

2. 浏览器打开 EDGEWEIR_PUBLIC_URL。未初始化的控制台跳转到 /setup（创建账户）。

3. 填写表单，点击 完成。

   字段	说明
   初始化令牌	第 1 步读取的 setup token
   姓名	1–100 字符
   邮箱	登录邮箱
   密码	12–128 字符

4. 验证：控制台自动登录，打开 集群与节点 与集群 default 的 添加节点 对话框（下一步）；系统设置 → 系统信息 的 初始化令牌 显示 已于 {时间} 使用。

初始化创建的对象：

2. 接入节点复制链接

1. 打开 集群与节点，选择集群 default，点击 添加节点（初始化后已打开；没有节点时侧边栏顶部的按钮也是 添加节点）。对话框立即显示 安装命令：默认节点组 default，有效期 1 小时。

2. 可选：打开 选项 修改下列字段，点击 重新生成。

   字段	说明
   节点名称	可选，最多 64 字符
   节点组	默认为集群的默认节点组；集群有多个节点组时显示
   有效期	15 分钟、1 小时（默认）或 24 小时

3. 复制 安装命令（仅显示一次），在节点主机上执行。命令下方的提醒与节点通道连接检查指出节点可能连不上的地址，见 接入节点。命令格式：

   复制

   export EDGEWEIR_TOKEN='ewt_…'
   curl -fsSL https://console.example.com/install.sh | sudo --preserve-env=EDGEWEIR_TOKEN bash -s -- --server https://console.example.com:8443 --ca-sha256 <CA 指纹>

4. 验证：对话框的 注册进度 依次完成；集群与节点 的节点表出现该节点，状态 为 在线，已应用版本 旁显示 已同步。

token 单次有效。安装脚本的校验步骤、下载镜像与失败处理见 接入节点。

3. 新建网站复制链接

1. 打开 网站，点击 新建网站。

2. 填写表单。

   字段	默认值	说明
   名称	第一个域名	最多 100 字符
   域名	无	每行一个或以逗号分隔；泛域名写作 *.example.com；1–50 个
   源站地址	无	IP 或主机名。粘贴 URL（https://origin.example.com:8443/app）或 主机:端口 时，端口与回源协议填入各自的字段
   端口	80（HTTP）/ 443（HTTPS）	源站端口
   回源协议	HTTP	HTTP 或 HTTPS
   回源 Host	跟随请求	发往源站的 Host
   缓存	开启	开启时生成一条缓存规则：路径前缀 /，缓存时间（秒） 3600，遵循源站 Cache-Control 开启（源站没有 Cache-Control、Expires 时缓存 3600 秒）

3. 点击 创建。网站所在集群发布新的配置版本，页面进入网站详情。提示 网站已创建 随节点更新：生效中 N/M → 已生效（配置金丝雀期间为 金丝雀 N/M，HH:MM 全部生效）。

源站池、缓存规则与缓存键见 源站与缓存。

4. 配置 DNS复制链接

在域名的权威 DNS 中为每个网站域名添加记录。

卡片列出每个域名当前的解析：指向正确（解析到的地址都属于集群节点）、指向其他地址、未解析、未能检查（解析失败，或节点没有已知地址）。泛域名解析其下的 edgeweir-check.<域名>。卡片与 上线检查 每 30 秒重新解析，点击卡片标题旁的 重新检查 立即解析；递归解析器缓存的结果（包括「域名不存在」）在其 TTL 内不变。

DNS 调度的线路、健康摘除与 TTL 见 配置 DNS 调度。

5. 启用 HTTPS复制链接

1. 打开网站的 HTTPS 页签。页签列出的问题（如第 4 步的记录尚未生效）修正后点击 重新检查。
2. 点击 启用 HTTPS。控制台为网站的全部域名申请证书（有泛域名时需要先添加 DNS 凭据），签发后自动选用；需要把 HTTP 跳转到 HTTPS 时，再在 HTTPS 设置中打开 强制 HTTPS。
3. 集群发布新版本。集群内有已启用的网站使用证书时，节点监听 TCP 443。

上传的证书在 证书 页上传后，在网站的 HTTPS 页签的 已有证书 中选用。

签发方式、续期、TLS 与 HTTP/3 见 HTTPS 与证书。

6. 验证复制链接

1. 查看网站 概览 页签的 上线检查，每一项可点击进入对应的设置：

   项目	通过	未通过时
   DNS 已指向 N/M	全部域名 指向正确	列出未指向的域名；进入 域名 页签
   证书	证书已覆盖全部域名，或 未配置证书（只提供 HTTP）	证书未覆盖全部域名（列出域名）、证书签发中、证书签发失败（显示原因）、证书已过期；进入 HTTPS 页签
   已在 N/M 个节点生效	N 等于 M	金丝雀期间显示窗口结束时间；没有在线节点 时先接入节点；进入集群

2. 绕过 DNS，直接向节点发送 HTTP 请求。未配置 DNS 调度时，边缘地址 卡片为每个域名给出可复制的命令（网站证书覆盖该域名时为 HTTPS）；也可以手动替换下例中的 203.0.113.10：

   复制

   curl -sI --resolve www.example.com:80:203.0.113.10 http://www.example.com/

   预期：状态码与源站一致；响应带 X-Cache 头，缓存规则覆盖的路径首次为 MISS。

3. 重复第 2 步。源站响应可缓存时返回 X-Cache: HIT。

4. 启用 HTTPS 后：

   复制

   curl -sI --resolve www.example.com:443:203.0.113.10 https://www.example.com/

   HTTPS 请求用 --resolve，不用 -H 'Host: …'：节点要求 SNI 与 Host 一致。

5. DNS 生效后：

   复制

   dig +short www.example.com
   curl -sI http://www.example.com/

   预期：dig 返回节点地址（配置了 DNS 调度时先返回 CNAME 目标）；curl 结果与第 2 步相同。

故障排查复制链接