网络设置
网络设置用于统一管理 Kaloscope 服务端发起的所有 HTTP 请求的网络规则。它不是单一的“全局配置”页，而是由 URL 规则、DNS 解析器和代理服务器三部分组成。
- 管理可复用的 DNS 解析器和代理服务器
- 为不同的 URL 匹配模式建立规则
- 分别控制是否启用 DNS 或代理
- 通过规则顺序决定匹配优先级
作用范围
网络规则对服务端发起的所有 HTTP 请求均生效，包括：
- 工作流的 HTTP 请求节点
- GitHub API 请求
- Git 克隆和拉取请求
匹配模式
每条 URL 规则通过匹配模式字段与请求的完整 URL 进行 shell 风格的通配符匹配（* 匹配任意字符，? 匹配单个字符）。如果匹配模式不以 * 结尾，系统会自动在末尾补上 *，因此填写前缀即可匹配该前缀下的所有路径。
| 匹配模式 | 实际生效 | 匹配示例 |
|---|---|---|
https://api.example.com | https://api.example.com* | https://api.example.com/search |
https://*.example.com/v2 | https://*.example.com/v2* | https://api.example.com/v2/search |
https://* | https://* | 匹配所有 HTTPS 请求 |
规则优先级
规则按列表位置从上到下依次匹配，命中第一条后即停止，所以更具体的规则应放在前面，更通用的规则放在后面。
DNS 解析器
DNS 解析器使用加密协议进行域名解析，支持 DNS over TLS（DoT） 和 DNS over HTTPS（DoH） 两种协议，避免 DNS 查询被劫持或篡改。
| 字段名称 | 字段类型 | 说明 |
|---|---|---|
| 名称 | 字符串 | 解析器的显示名称，全局唯一 |
| 协议 | TLS/HTTPS | 解析协议 |
| 域名服务器 | 字符串 | DoT 填写域名服务器 IP 地址，DoH 填写 IP 地址或完整的 HTTPS URL（如 https://dns.example.com/dns-query） |
| DNSSEC | 布尔值 | 开启后要求服务器返回经过验证的应答，验证失败则丢弃结果 |
一条 URL 规则可以关联多个 DNS 解析器，系统会并发查询所有解析器，取最先返回的有效结果。解析结果会在本地缓存 6 小时。
代理服务器
代理服务器用于转发 HTTP 请求，支持 HTTP 代理 和 SOCKS5 代理 两种协议，适用于需要通过代理访问外部资源的场景。
| 字段名称 | 字段类型 | 说明 |
|---|---|---|
| 名称 | 字符串 | 代理的显示名称，全局唯一 |
| 协议 | HTTP/SOCKS5 | 代理类型 |
| 主机 | 字符串 | 代理服务器地址 |
| 端口 | 整数 | 代理服务器端口 |
| 用户名 | 字符串（可选） | 代理认证用户名 |
| 密码 | 字符串（可选） | 代理认证密码 |
一条 URL 规则只能关联一个代理服务器。
代理与 DNS 的兼容性
- HTTP 代理 + DNS：两者不会同时生效。请求通过 HTTP 代理时，DNS 解析结果会被忽略。
- SOCKS5 代理 + DNS：两者可以同时生效。DNS 先解析出 IP 地址，请求再通过 SOCKS5 代理使用该 IP 建立连接。