集群与系统

全局规则 与 IP 名单 见 规则、IP 名单与 GeoIP，封禁 见 封禁，DNS 调度 与 告警 见 DNS 调度与告警，区域探针、调度地址与智能调度规则见 区域探针与智能调度；侧边栏全部页面见 控制台导航。

集群与节点复制链接

页面：集群与节点（/clusters），上方的「集群 | 区域」切换集群与 区域（/clusters?view=regions）。集群视图的页面操作为 新建集群 与 添加节点，其下是当前集群的概要。有多个集群时用 选择集群 切换。集群还没有节点时只显示节点区块（含 添加节点）；有节点后显示概要与各页签。概览 页签是节点组、节点、配置金丝雀、缓存区、节点升级与配置版本；DNS 页签是该集群的 DNS 绑定，见 绑定集群；智能调度 页签是该集群的调度规则与预览，见 智能调度规则；端口池 页签（/clusters?tab=ports）是该集群 L4 应用可用的端口区间，见 设置端口池。

集群复制链接

集群是一组节点与分配到这些节点的网站；每个集群有独立的配置版本序列。

节点组复制链接

节点组用作 DNS 调度 的线路与备用节点组、节点升级的试运行组与配置金丝雀的金丝雀组。节点组的区域也是其中节点 兼任探针 时所在的区域。

添加节点复制链接

添加节点 对话框打开即生成一次性安装命令：集群的默认节点组，有效期 1 小时，不带节点名称。选项 显示下列字段，重新生成 按所填的值生成新的命令。

对话框显示 安装命令（带剩余时间，仅显示一次）、地址提醒与一行节点通道连接检查（未通过时带「修改」链接，打开 节点通道），其下为 注册进度。CA 指纹在命令的 --ca-sha256 中，也显示在 系统信息。每次打开对话框都生成新的 token，关闭后命令不再显示。token 以 ewt_ 开头，单次有效；数据库保存其 SHA-256 与前缀，不保存明文。地址提醒、连接检查与安装流程见 接入节点。

节点复制链接

节点升级复制链接

节点升级 区块按节点组试运行并推进签名升级，见 节点升级。

配置金丝雀复制链接

配置金丝雀 卡片按集群设置策略，并显示当前发布的状态。默认关闭。

发布进行中时，卡片另显示：

立即推进到全部（写审计 cluster.rollout_promote）与 中止并回滚（写审计 cluster.rollout_abort）都需要确认，只在 金丝雀中 与 等待推进 时可用。策略修改写审计 cluster.rollout_policy_update。

配置版本复制链接

每次影响节点配置的变更在集群内发布一个新版本。配置版本 表列出最近 20 个版本：版本、内容哈希、网站、原因、时间。每个集群保留最近 200 个版本；金丝雀的稳定版本与候选版本不清理。只为 ACME HTTP-01 挑战发布的版本不计入，1 小时后删除。

回滚 以所选版本的内容发布一个新版本，不删除历史。当前已停用的网站与 L4 应用不随回滚下发；IP 名单、全局规则、全局 Under Attack 与源站地址允许清单取当前值。所选版本引用的网站、域名、证书、IP 名单或 L4 应用已删除，L4 应用的端口已不在端口池内，或证书已过期时，拒绝回滚。

回滚 的确认对话框列出回滚相对最新版本 新增、修改、移除 的网站；内容与最新版本相同时显示「与当前版本相同」，只有网站以外的配置不同时显示「网站无变化」。不能回滚时（如 ROLLBACK_RESOURCE_UNAVAILABLE）显示原因，确认按钮不可用。预览不写入任何数据，API 见 集群与概览。

变更需要集群活动节点缺少的能力时：

待处理复制链接

概览（/overview）顶部的 待处理 列出需要处理的事项，每行显示所属集群，点击打开该集群（DNS 事项打开其 DNS 页签）；没有事项时不显示。侧边栏 概览 旁显示事项数。按下表顺序排列：

API：GET /api/v1/overview 的 attention，见 集群与概览。

网站启停复制链接

网站 概览 页签的 状态 旁有 停用 / 启用（需要确认）；API 见 站点启停。

区域复制链接

页面：集群与节点 的 区域 视图（/clusters?view=regions；/regions 跳转到这里），页面操作为 新建区域。区域是节点组与区域探针的标签（如华东），在节点组与节点表中显示；探测指标的调度条件可以只计一个区域的探测方。探针在 系统设置 的 监控 页签，见 区域探针。

服务账号复制链接

页面：系统设置 的 服务账号 页签（/system?tab=service-accounts；/service-accounts 跳转到这里），页面操作为 新建服务账号。服务账号是供集成调用 /api/v1 的身份：不能登录控制台，只能用 key（ews_ 开头，请求头 x-api-key）调用下表中的过程。

端点与请求格式见 API 与端点。

审计日志复制链接

页面：审计日志（/audit）。管理操作写入审计日志。控制台自身的变更与审计条目在同一事务中提交；登录、修改密码、两步验证与通行密钥的变更由 better-auth 完成，审计条目在其提交后写入，写入失败只记录日志。审计日志不自动清理。

页面显示 时间、操作者、操作（名称与代码）、对象，每页 50 条；筛选 操作、对象 类型与时间范围（全部时间、近 1 小时、近 24 小时、近 7 天、近 30 天）。行末的 详情 显示全部字段：完整时间、操作者与对象的 ID、IP、User-Agent 与格式化的元数据 JSON。没有名称的旧代码按原样显示。/api/v1 返回全部字段，读取方式见 API 与端点。

系统设置复制链接

页面：系统设置（/system），页签：

系统信息复制链接

只读。

节点通道复制链接

地址：节点与区域探针连接节点通道的地址，即安装命令中的 --server。输入框为空时使用 EDGEWEIR_NODE_API_URL，未设置时为 https://<EDGEWEIR_PUBLIC_URL 的主机名>:<NODE_API_PORT>；占位文字为当前生效的地址，标签显示其来源。

地址为 localhost、回环或内网地址时标「仅本机可达」或「内网地址」：其他网络的节点无法注册。地址下方显示 连接检查 的结果：连接正常、控制台无法连接该地址、证书不符，前面可能有代理或 CDN，或 出站策略不允许连接该地址（保存的地址是内网、回环等特殊用途地址，EDGEWEIR_OUTBOUND_ALLOW_CIDRS 未放行，控制台不连接）。修改写审计 system.node_channel_update。证书名称见 节点通道地址与证书。

源站地址允许清单复制链接

允许的地址段（每行一个 CIDR），最多 256 条。清单内的内网、回环等特殊用途地址可作为源站。保存后所有集群各发布一个配置版本，并写审计 system.origin_allow_list_update。源站地址规则见 源站地址限制。

节点发布源复制链接

发布源地址：节点升级读取发布清单的镜像地址，布局为 <地址>/v<版本>/checksums.txt。

每个节点另有本机固定的发布源与签名信任锚，控制台不能修改；见 节点升级。

用量复制链接

修改写审计 system.usage_update。用量接口与 completeUntil 的定义见 用量。

平台错误页复制链接

每个模板最多 65536 字节（UTF-8），占位符 {{status}}、{{request_id}}、{{client_ip}}、{{host}}、{{time}}、{{path}} 的值经 HTML 转义；用到 {{time}} 或 {{path}} 时所有集群的配置要求节点能力 rules-v3。保存后所有集群各发布一个配置版本（原因「修改平台错误页」）；修改写审计 system.error_pages_update。旧节点忽略平台错误页。见 错误页。

设置优先级复制链接

控制台中保存的值优先于环境变量，环境变量优先于默认值。环境变量只作为已有部署的后备。

节点通道 与 节点发布源 的标签显示当前生效值的来源：已保存、环境变量 或 默认。系统设置中保存的发布源地址受 EDGEWEIR_OUTBOUND_ALLOW_CIDRS 约束；环境变量中的值由运维设置，不经该检查。全部环境变量见 环境变量。

防护设置复制链接

页面：防护设置（/protection），在侧边栏 访问控制 下。

封禁复制链接

修改写审计 system.bans_update。见 封禁。

防护复制链接

开关变化，或开启时更换挑战类型，所有集群各发布一个配置版本。修改写审计 system.protection_update。全局 Under Attack 需要节点能力 challenge-v1，缺少该能力的节点继续使用原配置，见 配置版本。网站自己的 Under Attack 与 CC 防护见 挑战与 CC 防护。

CC 模板复制链接

网站开启 CC 防护并 跟随默认模板 时使用的阈值：最高级别、验证码级别改用高难度计算验证、窗口、站点 QPS、单 URL QPS、单 IP QPS、IP 封禁时长、源站错误率、最小回源请求数、持续多久升级、冷却多久降级。「预设」选择宽松、标准或严格，或选择「自定义」逐项填写；字段、范围、默认值与各预设的取值见 CC 防护。保存后，有网站跟随模板的集群各发布一个配置版本；修改写审计 system.cc_template_update。

GeoIP 数据库复制链接

只读。逐个节点显示 国家、省份 与 ASN 数据状态（可用 / 未配置），并带 IPinfo 署名链接。国家和 ASN 数据随节点发布镜像内置，其余数据库由各节点本机配置；配置数据库 链接到 规则、IP 名单与 GeoIP。

故障排查复制链接