MIHOMO / CONFIG.YAML

Clash 进阶配置手册

先区分连接接管、域名解析、规则匹配和出口选择,再修改对应的配置段。使用文档讲首次安装、导入订阅和连接验证;本页用于已经跑通基础连接之后,按主题调整和排查。尚未安装时,可从客户端下载页按系统选包,优先考虑该平台列为首推且满足系统要求的 Clash Plus。下文以 mihomo 原生字段为准;客户端是否允许从界面写入某一字段,要看它使用的内核和配置合并方式。

策略组类型与出口选择

策略组回答的是「规则命中以后走哪个出口」,不是「哪些流量应该命中这条规则」。在 Rule 模式下,内核先按 rules 顺序匹配新连接,再把连接交给规则指定的策略组。组可以引用节点、内置策略或其他组,但引用必须能解析且不能形成环。例如,办公组可以引用默认出口组,默认出口组就不能再把办公组列为候选。排错时先确认规则指向哪个组,再看组当前选中了什么。

按业务目标选择组类型

类型选择依据适用场景
select采用手动选中的候选项固定出口;隔离排查时的变量
url-test依据探测结果选择候选项多个可以互换的出口
fallback优先使用列表中靠前的可用项指定主出口与后备出口
load-balance按指定策略把不同连接分配给候选项可以接受不同连接使用不同出口的业务

需要稳定出口的业务先用 select。例如,某个后台把出口变化视为登录异常,即使另一个节点探测更快,也不应自动切过去。主备链路用 fallback 时,要按业务优先级填写候选项,而不是按某一次测速结果排序。它适用于主链路不可用时让新连接走备用链路;已经建立的长连接不会因此无缝迁移,应用仍可能需要重新连接或重新登录。

url-test 的 url 是探测目标,interval 以秒计,tolerance 以毫秒计,用于减少候选项之间差距很小时的频繁切换。探测成功只说明该出口能访问测试地址,不代表会议、文件同步或特定网站同样可用。选择探测目标时应确认各候选出口都可访问它。定时探测也会消耗流量与电量,没有必要让每个用途相同的组都单独测试同一批节点。

load-balance 分配的是连接,不是同一个下载任务中的数据包。多连接应用可能同时使用不同出口;即使采用散列类策略,也不应把它视为对外固定地址的保证。应先确认候选项属于同一可接受范围,再用两个彼此独立的新连接核对分配结果。做网页交互或登录态排查时,先切回固定出口,避免把应用自身的会话问题误判成代理协议故障。

先用内置策略验证组引用

下面是可以单独加载的最小样例。它不需要订阅:默认直连,手动切到 REJECT 后只拒绝 example.com 及其子域名。它用于验证组选择是否生效,不用于建立代理出口。已有客户端正在监听同一端口时,应在单独的测试环境中运行,或改用未占用的本地端口。

mixed-port: 7890
allow-lan: false
mode: rule

proxy-groups:
  - name: ExamplePolicy
    type: select
    proxies:
      - DIRECT
      - REJECT

rules:
  - DOMAIN-SUFFIX,example.com,ExamplePolicy
  - MATCH,DIRECT

测试请求必须经过样例配置所监听的入口。先在连接记录里确认测试域名命中 DOMAIN-SUFFIX,再查看策略链是否经过 ExamplePolicy。切换策略后关闭相关应用连接,重新发起同一个请求;浏览器连接池可能复用旧连接,因此仅刷新页面不一定能区分新旧结果。如果记录中根本没有请求,先排查连接接管,不要继续改组名或探测参数。

接入订阅后,组可用 proxies 引用明确的节点名,也可用 use 引用节点提供器。前者适合少量固定候选,后者适合订阅会定期更新的场景。若给某个组加了名称过滤条件,更新后要检查过滤结果是否为空。组名应表达用途而非供应商当天给出的节点名称,这样更换订阅时只需调整候选来源,不必逐条改写业务规则。

切回配置后若选项与预期不同,检查客户端是否保存了上一次的策略选择,以及当前读取的是哪个配置实例。列表顺序和运行时选择是两件事,不能仅凭候选项排列推断实际出口。上线前分别测试明确命中的域名、走兜底的域名和需要后备出口的连接。规则顺序仍有疑问时,可接着阅读GEOIP、GEOSITE 与 RULE-SET 分流实战。

规则集订阅化管理

当一批域名或网段要独立维护时,将规则内容放进 rule-providers,再从 rules 用 RULE-SET 引用。提供器负责取得和解析规则条目,最终走哪个出口仍由引用它的那条规则决定。维护者可以更新名单而不改主配置,但主配置中的引用名称、匹配顺序和出口名称必须稳定。先从一个对象清楚、范围有限的规则集开始,避免首次迁移就把所有业务集中到一个来源。

选择匹配行为和文件格式

behavior: domain 适用于域名匹配条目,ipcidr 适用于地址段,classical 则用规则类型与匹配内容表达对象,例如 DOMAIN-SUFFIX,example.org。经典规则集中的条目不附带出口名,出口写在主配置的 RULE-SET 行上。仅修改扩展名不能改变实际内容的格式;使用 format: yaml 时,规则文件以 payload 数组承载条目。

先用本地文件验证匹配,再切换远程来源。下面将例子域名送往 DIRECT,其余连接同样直连,因此应通过连接记录区分两条规则,而不是看出口是否相同。将规则文件放到 mihomo 工作目录下对应的相对位置;桌面客户端生成运行配置时,工作目录可能不是订阅文件所在目录,可在启动信息中核对。

# 并入 config.yaml;已有 rules 时只合并规则列表。
rule-providers:
  documentation:
    type: file
    behavior: classical
    format: yaml
    path: ./rules/documentation.yaml

rules:
  - RULE-SET,documentation,DIRECT
  - MATCH,DIRECT
# rules/documentation.yaml
payload:
  - DOMAIN-SUFFIX,example.org
  - DOMAIN-SUFFIX,example.net

远程更新与规则顺序

切换为远程维护时,将提供器的 type 改为 http,填写维护方给出的规则文件 url,保留独立的本地 path,并用 interval 设定更新间隔,单位为秒。不要让多个提供器共用一个缓存路径,否则无法可靠区分哪个来源写入了文件。更新后查看实际加载的条目和更新时间;网页在浏览器里能打开,不代表内核下载到了预期格式,响应可能是登录页或错误说明。

首次启动没有可用缓存时,要特别检查规则源的网络可达性。若规则文件只能经特定出口访问,而这个出口又依赖同一批规则或尚未初始化的节点,就会把启动前提绕成一圈。先在现有的可用配置下获取并审查规则,或用本地文件建立起始方案。之后再决定远程更新走哪个可达路径,不要把刷新间隔缩短当成解决首次加载失败的方法。

规则是从上往下采用第一条匹配。某个域名既落在精确的例外规则内,又落在较宽的规则集内,顺序就会决定结果。先放业务例外,再放较窄的域名集,随后处理宽泛的地址段或地理规则,并把 MATCH 留在最后。规则集更新后新增的条目也会参与原有顺序,不能只盯着主配置有没有改动;每一份远程规则集都应有可预期的覆盖边界。

地址类匹配还要考虑解析副作用。若连接原来带有域名,前置的地址规则可能为了匹配而触发查询,把远程解析或后续域名规则的排查变复杂。只想匹配已经掌握的目标地址时,可评估在适用的 IP 类规则或 IP 型规则集引用上使用 no-resolve;它不会把域名自动当成地址匹配,也不等于关闭整个内核的 DNS。先用域名和裸地址各试一次,再决定是否加这个参数。

出现错分流时,记录一次失败连接的目标、命中规则、规则集名称和出口。若命中的是更靠前的规则,修正顺序或范围;若根本没匹配到规则集,查加载状态、条目类型和域名是否可见。若命中正确却连接失败,应转查策略组和出口。回滚时保留上一次能用的主配置与对应规则文件,避免只恢复引用、却仍加载新名单。

DNS 上游与解析路径

DNS 排查要先确认请求由谁发出,再确认交给了哪个解析器。应用可以使用系统解析,也可以启用自己的加密 DNS;内核需要时也会发出查询,例如解析代理服务器的域名或为某些地址规则取得目标地址。设置了 mihomo 的 dns 段,不意味着每个应用都使用这个入口。判断解析路径时,要把浏览器、系统、内核和上游分别列出来,而不是把所有查询都归到系统设置里看到的地址。

区分一般查询、上游引导和节点解析

字段职责容易混淆的地方
default-nameserver为以域名填写的 DNS 上游提供引导解析不是普通域名查询的首选列表
nameserver处理未被专用策略覆盖的一般查询不决定业务连接最终走哪个出口
nameserver-policy按域名等匹配条件指定解析上游匹配 DNS 查询,不等同于 rules
proxy-server-nameserver专用于解析代理节点的服务器域名应在代理出口尚未建立时仍可访问

配置可以先用直接可达的 IP 上游跑通,减少域名上游自身需要解析这一层依赖,再逐项引入加密上游或域名专用策略。若节点地址用的是域名,而解析该域名又要借助这个尚未连通的节点,失败就会出现在出口建立之前。启用 respect-rules 前,应按 mihomo 的要求配置 proxy-server-nameserver,并确认它与其底层出口不会构成这种循环。

下例在回环地址监听,只用于单独验证内核 DNS,使用可直接查询的公共解析器。它不改变系统 DNS,也不把本机变成局域网 DNS 服务。redir-host 便于在核对阶段观察真实地址答案。应确认网络允许访问示例上游;办公网仅允许使用内部解析器时,替换为管理员提供的地址,而不是增加一条无法到达的公共备用上游。

dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: redir-host
  nameserver:
    - 223.5.5.5
  proxy-server-nameserver:
    - 223.5.5.5
dig @127.0.0.1 -p 1053 example.org A

按域名指定解析器,再检查接管范围

内网主机只在组织的解析器上有记录时,用 nameserver-policy 将相应域名后缀交给内部上游,并确认去这个解析器的链路经过正确的接口。把内部解析器和公共解析器堆在同一列表,不能等价实现内外查询分工,还可能把内部名称送到不相干的上游。验证时分别查一条明确存在的内部记录和一条公共记录,不用仅凭后台是否加载成功来推断解析正确。

诊断时比较三组结果:直接向内核监听地址查询、使用操作系统默认解析器查询、在出现故障的应用内重新发起连接。第一组证明监听与上游基本可用;第二组能看出系统有没有把查询交过来;第三组才反映应用是否用了自己的解析机制或缓存。三组答案不同不必然是错误,重要的是差异能否用预期路径解释。浏览器自带的加密 DNS 通常不能只靠接管普通的端口五十三查询来改写。

查看所谓 DNS 泄漏时,先定义允许的解析路径。例如内网域名使用组织解析器,普通外部域名使用指定公共上游,应用的加密解析另有约束。检测页面显示的往往是递归解析链的出口,未必显示设备直接连接的服务器地址。遇到不一致时,结合系统或客户端的查询记录,用一条受控请求确认归属,不要只换多个检测网站重复读结果。

查询超时和查询成功但答案不符,需要分开处理。超时先查监听是否启动、上游能否到达、路由有没有回到内核自身;答案不符则查专用策略、缓存、地址族以及应用是否使用别的解析通道。若只有某个应用失败,应优先复现该应用的路径。还在核对配置各段关系时,可对照config.yaml 文件结构详解,确认 DNS 段和出口规则没有写反。

用 A 与 AAAA 查询分别核对两个地址族。只关闭 DNS 的 IPv6 回答,不会改变所有应用的既有 IPv6 连接或系统路由;反过来,单独关闭接口的 IPv6 也不是修复上游解析失败的办法。修改后从同一个入口重新发起请求,并记录域名、查询类型和得到的结果;不要同时改 DNS 上游、TUN 和浏览器设置,否则恢复后也无法判断是哪一项产生了作用。

TUN 接管与 Fake-IP 映射

TUN 决定哪些设备流量被送到内核,Fake-IP 决定内核怎样回答被接管的域名查询。两者可以配合,但解决的问题不同。系统代理通常只影响遵循系统设置的应用;TUN 可从虚拟接口接管更多流量。Fake-IP 为域名分配映射地址,连接进入同一内核实例后再恢复域名,以便按域名规则判断。只启用 Fake-IP 却让使用映射地址的连接绕开内核,通常会看到解析有结果但连接失败。

按顺序启用接口、DNS 接管和映射

先用旧配置确认内核和出口正常,再记录当前默认路由以及已有的 VPN 或虚拟网卡。桌面客户端通常需要具备创建接口和调整路由的权限;移动端由系统的 VPN 机制提供接管入口,应使用客户端自身的选项。不要直接把桌面端 YAML 当作移动端设置说明。若同时运行另一套 VPN,先根据使用环境确定哪一套负责默认路由,再测试是否能并行,而不是依赖启动顺序碰运气。

下面是桌面环境的起始片段,合并进已经能运行的配置。mixed 是 TUN 协议栈选择,不是 mixed-port;auto-route 安装接管所需的路由,auto-detect-interface 用于选择出口接口。dns-hijack 中分别列出普通的 UDP 与 TCP DNS 匹配,不会把加密 DNS 自动变成内核可解析的普通查询。

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53
    - tcp://any:53

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - '+.lan'
  nameserver:
    - 223.5.5.5

样例中的过滤项只决定相应域名是否返回 Fake-IP。对于环境中确实存在的内部名称,应让它返回真实地址,并通过专用解析策略交给能够解析该名称的上游。过滤项本身不会添加直连规则,也不会为真实地址创建一条绕过虚拟网卡的路由。内部打印、文件共享或服务发现异常时,分别检查名称能否解析、目标地址的实际路由以及应用使用的发现协议。

按流量路径定位断点

启用后用三类目标验收:一个可核对域名规则的公共站点、一个确实可达的本地资源,以及一个不经过系统代理设置的应用。公共站点应产生预期的规则命中;本地资源按需求保持可达;独立应用的连接应在内核中可见。测试时先停用本应用单独配置的代理,避免经另一个本地端口接入后误以为 TUN 已经完成了接管。

域名查询返回映射范围内的地址,但连接列表没有对应记录时,检查目标地址的路由和接口归属,尤其要看设备是否已有重叠网段。接入另一套 VPN 或局域网后才出问题,说明路由优先级、接口选择或地址段冲突更值得检查。若连接已经进了内核却识别不出域名,确认生成映射与处理连接的是同一实例,并排除应用保留了旧映射答案的情况。

切换网络接口之后,自动选择不一定符合现场要求。双网卡、外接网卡或办公 VPN 接入时,先记录切换前后的实际出口,判断默认路由是否变化。有些应用会在原接口中保留旧连接一段时间,不适合用一条已经建立的长连接做验收。若需要限定接管范围,先明确哪些网段应该保留在原接口,再根据内核和平台支持调整路由配置,不要大范围排除可能与目标流量重叠的网段。

遇到整机断网,先从客户端关闭 TUN,确认默认路线和 DNS 状态是否恢复;如果没恢复,检查是否有残留服务在重新安装路由,或另一套 VPN 是否已接管。恢复基础网络以后,再单独启用 TUN 复现。不要测试到一半同时打开系统代理、切换协议栈、调整网段;这些改动分别作用于不同层,叠在一起容易掩盖真正的故障点。

如果需要回到 redir-host 做对照,请同时重新发起查询和连接,避免应用继续使用此前缓存的 Fake-IP。对照结果应包含具体表现:是 DNS 答案变了、规则命中变了,还是仅默认路由变了。只在某个平台出现接管问题时,先核对权限和 VPN 状态,再参考常见使用问题;不应直接移植另一平台的系统设置。

域名嗅探与匹配边界

域名嗅探用于给只有目标地址的连接补充域名线索。启用它之前,先确认流量确实进入了内核,并且连接缺少域名导致规则错配。若已经有可靠的代理请求域名或 Fake-IP 映射,通常可直接按域名匹配;若应用实际只访问一个裸地址,且协议没有携带可识别的名称,开启嗅探也不会生成一个可用域名。

限定要识别的协议与端口

明文 HTTP 可从请求头的主机字段取得名称;TLS 有机会从握手中的 SNI 取得名称;QUIC 则需要对应的协议识别,并受握手数据和实际网络行为限制。端口只能缩小尝试范围,不能证明该流量就是指定协议。不要把办公软件的自定义端口整段加入嗅探:先观察失败流量的协议和端口,再为一小类连接开启识别。开启 TLS 嗅探不等于读取 HTTPS 页面内容,也不需要导入证书。

sniffer:
  enable: true
  parse-pure-ip: true
  override-destination: false
  sniff:
    HTTP:
      ports: [80, 8080]
    TLS:
      ports: [443]
    QUIC:
      ports: [443]
  skip-domain:
    - '+.lan'

这里用 parse-pure-ip 允许尝试识别缺少域名的连接,并关闭 override-destination,避免把嗅探得到的域名用于改写原始拨号目标。这样可以先观察规则是否受益,再判断是否有理由更改拨号方式。不要把这段当作强制修复:若服务通过固定地址提供访问,即便握手中带有名称,也可能应当继续连原地址,而不是重新按名称解析。

skip-domain 用于排除已知不适合参与嗅探的域名,不是任意地址段的排除项。若应用使用裸地址,内核在处理前未必能得到可用于此项匹配的名称。对于这类故障,先缩小协议或端口范围,必要时按实际内核支持用目标地址排除项;不要写一个并未出现的域名来期待它跳过整段网段。也不要把域名排除列表和 DNS 的 Fake-IP 过滤列表当成同一份配置。

用连接记录对比启用前后

为测试域名提前写一条位置清楚的精确规则,临时把出口固定在一个可确定结果的策略组。关闭嗅探发起一次新连接,记下目标地址和命中规则;开启后从同一应用再发起一次,观察是否出现域名、规则是否改变、最终访问是否成功。若只是日志多出一项名称但规则仍走原路线,先核对该名称的匹配条件,不能仅凭看到 SNI 就判断域名分流已经按预期工作。

同一个地址可能承载多个站点。连接中可见的域名应当来自该连接本身,而不是把以前在同一地址上观察到的另一个域名填回规则。即便取得外层名称,它也可能只对应握手所见对象,不等同于用户最终访问的业务主机。对需要精确识别的应用,优先使用能保留原始请求域名的接入方式,或在解析与连接都受控时依赖 Fake-IP 映射。

加密客户端问候可能隐藏实际服务器名称;某些 TCP 或 UDP 应用从一开始就不携带可用的域名。出现这类情况时,按实际目标地址与端口设计范围明确的规则,或将该应用的流量交给一个明确的出口。继续扩大嗅探端口范围不能恢复从未出现的名称,还会增加误识别的可能。应把这种场景标为域名不可观测,而不是判为规则集维护失败。

若只在 UDP 流量下复现问题,区分浏览器走 QUIC 时是否取得域名、出口是否能处理该类流量,以及应用是否在失败后回退到 TCP。对照测试只改变一个条件,并在每次切换后建立新连接。TCP 成功而 UDP 失败不能直接证明嗅探模块异常;出口协议、路由和防火墙也属于这一条链路的前提。反过来,嗅探取得一个名称也不代表数据包已经成功经过出口。

需要共享日志时,保留规则类型、协议、端口与问题发生顺序,删去内部域名和其他会暴露业务环境的信息。确认配置有效后,只保留测试证明有用的协议和端口。若实际收益仅限一个应用,记录复现条件与回退项;这样客户端升级或配置覆写变化后,可以用同一组对照判断究竟是识别能力变化,还是源流量的接入方式已经变了。

本地覆写与多订阅合并

把可更新的订阅与需要长期维护的本地规则分开。订阅负责随来源变动的节点;本地主配置负责端口、策略组、规则顺序和日志口径。直接在已导入的远程订阅正文里追加字段,下一次更新可能恢复成远程内容。使用客户端覆写功能前,先确认它作用的是单个订阅、全部配置还是生成后的运行配置,并弄清列表采用替换、前插还是其他合并方式。

用提供器隔离节点来源

若来源是符合 mihomo 节点提供器格式的 proxies 文件,可以用 proxy-providers 组合多个来源。完整订阅常带有 rules、dns 和自己的策略组,不能假定客户端会自动把它拆成适合提供器的节点文件。导入前检查顶层结构和实际响应。若客户端只支持导入完整配置,可以使用它明确提供的合并入口,再查看导出的最终配置;不要把客户端私有覆写语法当成内核原生字段。

# 两个文件均需存在,每个文件为带 proxies 列表的节点文件。
proxy-providers:
  office:
    type: file
    path: ./providers/office.yaml
  personal:
    type: file
    path: ./providers/personal.yaml

proxy-groups:
  - name: Office
    type: select
    use: [office]
  - name: Personal
    type: select
    use: [personal]

rules:
  - DOMAIN-SUFFIX,example.org,Office
  - DOMAIN-SUFFIX,example.net,Personal
  - MATCH,DIRECT

样例把两个来源分别放入不同用途的组;将域名替换成已获授权且确实属于该用途的对象,再测试各自的连接。不要为了列表看起来整齐就把所有来源加入同一个自动选择组。个人出口和办公出口通常有不同的可达范围和使用条件,混用会让同一站点在不同时间得到不同结果,也让故障归属难以判断。多个来源有同名节点时,宜让命名包含稳定的来源前缀,并核对界面中显示的实际候选。

已有可用的提供器远程地址时,可以改为 type: http,用各自的 url 和本地缓存路径,按来源的更新频率设置 interval。订阅链接可能含访问凭据,应留在受控的本地配置或客户端存储中,不发到公开仓库、网络转换服务或截图。单个来源失效时,先确定影响的是哪几个用途组,不应把所有组统一替换成另一个出口来掩盖该来源的问题。

核对合并顺序和最终生效文件

映射和列表是两种不同的合并对象。覆写 dns 时,某些实现替换整个映射,可能一并丢掉旧有的域名策略;有些实现逐字段合并,则可能保留旧上游。对 rules 做列表追加时,如果新增规则排在原来的 MATCH 后面,就永远不会命中。编辑前明确预期操作是整体替换、前插还是在某一项之前插入,生成以后用最终文件确认,而不是只看编辑器是否保存成功。

建议规定固定的组名与规则集名,用这些稳定名称做跨段引用。若将某个组重命名,至少检查规则出口以及其他组中的引用;若重命名的是规则提供器,还要检查 RULE-SET 和任何使用该集的解析策略。发现同名对象时先明确保留哪份定义,不要依赖合并器在重复键上的偶然行为。即使 YAML 可以被某个编辑器读取,内核得到的结构也可能与预期不同。

使用独立 mihomo 二进制时,可以在加载前运行配置检查。以下命令假定已进入包含配置与提供器相对路径的工作目录,本机已安装内核命令。若客户端是托管内核,优先用它自身的检查或日志功能,并用相同的内核检查最终配置,避免测试的是一份文件而运行的是另一份。

mihomo -t -d . -f ./config.yaml

配置检查通过只表示内核能接受当前配置,不代表远程文件可取得、每个组都有候选或业务已经分流正确。实际加载后,分别触发办公、个人和兜底三类连接,核对提供器加载状态、命中规则和出口。模拟一次订阅刷新,再重复相同测试;只有刷新后本地改动和引用仍成立,才能确认覆写的位置合适。将这些测试的输入和预期结果写在本地运维记录里。

更新后只有一个组失效时,先看该来源是否改名、清空或改变了条目格式,再查组合逻辑。若所有组都异常,优先检查是否加载到了错误的基础订阅,或者客户端更新改变了覆写作用范围。回退时恢复上一份可用主配置和相应的提供器文件,确认规则目标仍存在,再逐个恢复来源。适合长期维护的结论是可定位哪个输入变化,而不是手工修完一次就失去复现条件。

外部控制面板与运行状态

外部控制器是内核的管理接口,不是代理流量入口。面板通过它读取连接、规则与组状态,并可能更改组选择、关闭连接或调整配置。它与 mixed-port 和 DNS 监听端口各司其职。客户端自带面板已经能满足需求时,不必额外开启监听。确实需要独立管理时,默认绑定回环地址,使用独立且仅在本地保存的高强度密钥。

使用回环地址并单独设置认证

将控制器配置合并到顶层。如果客户端已经托管控制端口,应先查看当前监听地址,避免同一台机器上的多个内核实例争用端口。下面的密钥只是明显不可复用的教学值,运行前须换成本机生成的独立随机值。allow-lan: false 可限制普通代理入口的局域网使用,但不能替代控制器自身的回环绑定和认证设置。

external-controller: 127.0.0.1:9090
secret: "replace-with-local-random-value"
allow-lan: false

独立面板若以本地静态资源提供,可按所用内核的方式设置 external-ui,填入可信且由本机维护的面板目录。若面板由控制器提供,通常从同一控制服务的 /ui/ 打开,能减少浏览器跨源问题。目录未部署时,控制 API 正常不代表面板路径可用;同样,面板页面能打开也不证明它通过了 API 认证。两者应分别验证。

以下命令从运行内核的同一台机器发起带认证的只读查询,适用于有 Bash 和 curl 的环境。密钥通过交互输入,不写入命令文本或脚本文件;执行前应确认没有开启 shell 跟踪,也不要把终端录屏或请求头转给他人。客户端内置面板可直接用它提供的连接诊断替代命令。

read -rsp '控制密钥:' controller_secret
printf '\n'
printf 'header = "Authorization: Bearer %s"\n' "$controller_secret" |
  curl --fail --silent --show-error --config - \
    http://127.0.0.1:9090/version
unset controller_secret

分清面板、监听与实际配置

现象优先核对不要先改
连接被拒绝服务是否启动,地址和端口是否对应当前实例规则顺序和 DNS
返回未授权当前密钥与面板连接设置是否一致监听范围
API 正常但面板空白面板资源、浏览器安全限制和面板中的接口地址内核出口策略
面板有数据但不是预期实例实际连接地址、配置文件及后台服务归属模型无关的其他组参数

本机接口返回未授权时,先核对是否连接错了后台实例,再重填密钥;不要为了排查而移除认证。若命令可访问、浏览器却报跨源或混合内容错误,先用同源的本地面板复测。网页脚本的安全限制是浏览器的一层保护,关闭限制或把允许来源放开到任意网站不是修复办法。特别是浏览来源不明的面板时,不应把本机管理凭据提交给那个页面。

不要把控制器绑定到所有接口,也不要转发这个端口到公网。确有远程管理需求时,优先使用组织已有的受控远程桌面或管理通道,从设备上的本地会话打开面板。即便网络入口有访问限制,控制器仍应保持独立认证。多人使用同一设备时,限制配置文件的访问权限,避免将密钥与普通代理端口一起留在可被其他进程或账户读取的共享目录。

排查业务时,面板先用于观察而不是频繁点选。记录一条新连接的目标、协议、命中规则及实际策略链,再到对应章节调整唯一变量。若切换了策略组,主动重新建立测试连接;旧会话可能继续沿用原出口。若某个变更只在界面上生效,重启就丢失,检查它是运行态选择、客户端保存的偏好,还是已经写进本地主配置的持久变更,这三者不应混为一谈。

日志也应按范围开启。短时间内提高日志详细度可以定位加载失败或域名识别问题;问题复现后恢复原级别,避免长期积累连接目标和个人使用记录。对外求助时可保留错误类型和已脱敏的相关配置段,不必交出完整运行配置。页面能够显示节点和规则,仅说明管理接口能读取状态;代理是否可用仍要以实际连接记录和可重复的请求来判断。

最终验收按固定顺序进行:确认应用进入内核,确认所需域名可解析或可识别,确认命中预期规则,再确认该组选择了可用出口。最后刷新一次订阅并重载,验证至少一个关键场景没有变化。若基础连接本身未通过,回到使用文档重新验证导入和连接;若只是系统代理、权限或端口问题,先查常见问题,无须一次改完整份配置。

Clash下载