Clash 全平台
安装配置大全

通用准备：先分清客户端与配置

客户端负责运行，订阅负责提供连接信息

Clash 生态不是一个安装包覆盖所有设备。客户端是可操作的应用界面，内核负责读取配置、匹配规则和转发连接。mihomo 是这个生态中常见的内核；Clash.Meta 与它存在演进关系，但旧客户端不一定支持新字段。下载前先确定系统、处理器架构和客户端维护状态，再确认订阅提供方支持的配置格式。不能只看文件名里有 Clash 就认定可以通用。

首次选择优先查看 Clash Plus；其他客户端按平台和使用习惯选择。安装程序本身不会自动带来可用节点。订阅通常是一个带个人访问凭据的链接，返回节点、策略组、规则等配置内容。拿到链接时，先确认它是客户端订阅地址，而不是账户登录页或网页分享地址。浏览器能打开某个页面，并不代表该地址能被客户端解析。

把系统环境与连接前提记录下来

先检查设备时间、可用存储和基本网络。时间明显不准会影响加密连接验证；网络需要网页认证时，应先完成认证。公司或学校管理的设备可能限制安装、VPN 或网络扩展，不要通过关闭管理策略解决。处理器架构要从系统信息确认，不能按电脑外观或手机品牌猜。移动端还应确认当前是否运行其他 VPN、抓包工具或使用本地 VPN 通道的过滤应用。

建议记录四项基线：当前能否正常直连、使用的是无线网络还是移动数据、是否已有手动代理、是否需要访问打印机或局域网服务器。这样开启客户端后出现异常，就能区分是原有网络问题还是新设置造成的变化。不要一开始同时打开系统代理、TUN、自定义 DNS 和全局模式；先建立最简单的可用路径，再逐项增加功能。

理解规则模式与配置文件的边界

规则模式表示按照配置中的规则逐条选择出口，并不是所有请求都走代理。全局模式把通常受模式控制的连接交给全局策略，仍不能代替系统层面的流量接管。直连模式则用于暂时绕过代理出口。对大多数初次安装场景，先选规则模式，再在实际被规则引用的策略组里选择节点；只修改一个没有被使用的组，不会改变当前请求的出口。

YAML 是依靠缩进组织数据的文本格式。下面展示的只是几个常见字段，不是一份带节点的完整配置。合并时应放入现有配置的对应位置，不能在同一层重复写两次相同键，也不能把制表符当作空格。客户端有可视化开关时，优先从界面调整，避免界面生成的配置与手动文件互相覆盖。

mode: rule
log-level: info
allow-lan: false
ipv6: false

所有安装入口集中在下载页。如果正在从旧客户端迁移，先读停更后的配置备份与迁移路线，保留原配置并确认新客户端可用后，再移除旧应用。迁移时一次只运行一个接管流量的客户端，避免两个程序争用路由或代理端口。

Windows：从安装到系统代理与 TUN

选择安装包并完成首次启动

在Windows 下载区先看 Clash Plus，再按需要比较 Clash Verge Rev、FlClash 和 Clash Nyanpasu。Clash for Windows 属于已停止维护的归档选项，不建议把新环境建立在旧客户端上。进入“设置 → 系统 → 系统信息”确认系统类型，再核对下载页的适用说明。没有对应架构说明时，不要把其他架构的安装包当成原生支持。

下载后关闭旧代理客户端，再执行安装。普通安装与需要管理员权限的服务安装要分开看待：界面能启动，不代表 TUN 所需的后台服务已经就绪。安全提示出现时，检查文件来源与应用信息；不要为了跳过提示而全局关闭系统防护。如果安装受组织策略阻止，应联系设备管理人员。安装完成后先打开界面，暂时不设置开机启动，便于判断故障来自哪一步。

导入订阅并确认正在使用的配置

在配置或订阅页面选择从 URL 导入，填写便于辨认的名称，粘贴完整订阅地址后保存。注意去掉复制时带入的前后空格，但不要手动删改查询参数。等待下载和解析结束，再明确选中这份配置。有些客户端把“保存订阅”和“启用配置”分成两步，只看到列表里新增了一项，还不能证明内核已经使用它。

进入策略组页面，选择规则模式，并检查组内是否真的有可选节点。如果只剩 DIRECT 或组列表为空，先查订阅格式与解析日志，不要反复启动系统代理。节点测试成功后，再用浏览器访问一个实际需要该出口的网站。测试结果只说明测试地址在当时的连通情况，不能保证所有网站、协议和登录流程都正常。

先开系统代理，需要时再启用 TUN

系统代理适合先验证浏览器等常见应用。客户端开关启用后，系统代理地址通常指向本机回环地址，端口以客户端实际显示为准。下面的命令只适用于客户端混合端口确实为 7890 的情形，用来明确指定代理做一次请求；不要为了照抄命令而把已正常工作的端口强行改成这个值。

curl.exe --proxy http://127.0.0.1:7890 --head https://example.com

命令可通而某个应用不通，说明应继续检查该应用是否遵循系统代理，或是否有自己的代理配置。TUN 是通过虚拟网络接口接管流量的方式，适合不读取系统代理的程序。启用时按客户端提示安装服务或授予权限，然后检查日志是否出现接口或路由错误。不要把“管理员运行整个界面”当作长期修复所有权限问题的办法。

处理端口、睡眠恢复与退出残留

启动提示端口占用时，先查看旧客户端是否仍在托盘或后台运行，也检查开发代理、容器工具等程序。不要随意结束不认识的系统进程。若必须换端口，客户端、手动代理设置以及终端环境变量都要一起核对。系统代理与 WinHTTP 代理并非同一套设置，某些后台程序还可能完全使用自己的连接逻辑。

电脑睡眠后恢复、切换无线网络或接入办公 VPN，可能改变路由与 DNS。先停用再启用客户端的接管开关，观察是否恢复；如果每次都发生，再保存相关时间段日志。退出客户端前先关闭系统代理，异常退出后则进入系统代理设置检查是否残留回环地址。客户端已经关闭而浏览器仍指向本地端口时，会表现为所有页面突然打不开。

最后再配置开机启动，并重启一次确认后台服务、配置选择和策略组都能恢复。若要使用“允许局域网连接”，应同时理解监听地址、防火墙入站规则和认证设置；只供本机使用时保持关闭即可。更多单项问题可在常见问题里继续查，不必为了一个应用异常重装整套环境。

macOS：区分芯片架构与网络权限

下载对应架构并完成应用安装

打开“关于本机”，先确认是 Apple 芯片还是 Intel 处理器，再到macOS 下载区选择对应安装包。优先查看 Clash Plus，也可比较 Clash Verge Rev、FlClash。ClashX Meta 已停止维护，适合了解旧环境，不宜作为新装设备的默认选择。不同架构的程序即使能借助兼容机制运行，也不代表其辅助服务与网络功能完全相同。

安装磁盘映像中的应用时，按提示复制到“应用程序”目录，再从该位置启动，不要长期在挂载的安装映像里运行。这样应用更新、辅助程序路径和登录项更容易保持一致。遇到系统安全提示，先确认下载来源与签名信息，再按系统允许的流程处理；不要直接执行网上提供的整机关闭安全检查命令。

订阅导入后先做最小连接验证

打开客户端的配置页面，新增 URL 订阅，保存并等待解析完成。启用配置后检查策略组是否齐全，选择规则模式和一个实际出口。若订阅提供方区分通用配置、mihomo 配置或其他客户端格式，应选择与当前内核匹配的入口。文件能够被导入，并不等于每个扩展字段都已生效，日志中的不支持字段提示也要看。

第一次测试先使用系统代理。macOS 的代理设置与网络服务相关，无线网络和有线网络可能各有记录。切换网络后，如果客户端显示已开启但浏览器没有连接记录，进入当前网络服务的代理设置核对。浏览器扩展、开发工具和终端也可能有自己的代理来源，不能用一个应用的结果代表整台电脑。

网络扩展、辅助服务与 TUN 授权

需要 TUN 时，按客户端实际提示授权。不同实现可能使用特权辅助程序、系统网络扩展或其他机制，不要假定所有客户端都会出现完全相同的窗口。授权通常在系统设置的隐私、安全或网络相关页面确认。首次授权后应回到客户端重新启用功能，检查内核日志，不能只看系统弹窗已经关闭就认为接管成功。

如果开关自动弹回关闭状态，优先检查辅助服务是否安装成功、系统是否仍有待确认的授权，以及旧客户端是否占用了相同资源。多次重装但保留旧服务和旧配置，往往不能改变结果。应先正常退出旧应用，再按其提供的方式停用服务；不熟悉的系统目录和网络设备不要手动删除。

scutil --proxy
scutil --dns
route -n get default

这三个只读命令分别查看代理、DNS 和默认路由，可在开关功能前后对照。输出里出现某个解析器，不代表每一次查询都会用它；系统还可能根据网络接口、域名范围和优先级选择解析路径。提交输出前隐藏个人网络信息。需要分析 DNS 时，应结合客户端日志和实际访问域名，而不是只截取一行地址下结论。

处理局域网、睡眠与网络切换

启用 TUN 后若打印机、文件共享或本地开发服务异常，先区分目标是回环地址、私有地址还是依赖局域网发现的名称。私有地址直连规则只能解决其中一部分问题；组播发现、链路本地域名和虚拟机网络可能需要客户端专门的排除设置。不要把整个局域网网段随意指向外部代理，也不要为了访问打印机永久切到全局模式。

合盖休眠后重新联网，连接会话可能已经失效。先等待网络恢复，再重新建立客户端通道；若 DNS 一直使用旧网络结果，可通过停止并启动接管功能观察变化。切换手机热点、公司网络与家用网络时尤其要注意认证页和其他 VPN。应先确认基础网络可用，再检查代理，否则会把上游网络中断误判为配置损坏。

迁移到另一台 Mac 时，优先重新导入订阅，再恢复必要的覆写和规则。不要把辅助服务、绝对路径和旧机器网络接口名称一并照搬。完成浏览器、终端和常用应用的实际验证后，再开启登录启动，并确认退出应用时系统代理能正常还原。

Android：VpnService 授权与后台保活

安装前核对架构与旧应用

在Android 下载区优先查看 Clash Plus，也可按需求选择 Clash Meta for Android、FlClash 或 Surfboard。不同客户端对配置格式的支持并不完全一致，尤其是 Surfboard，不能默认把任意 mihomo YAML 原样导入。先检查订阅提供方的格式说明，再选择客户端。架构以系统实际支持为准，设备使用六十四位处理器也不必然代表系统只运行六十四位应用。

安装外部下载的应用时，系统可能要求允许当前浏览器或文件管理器安装应用。只对本次使用的来源授予必要权限，完成后可关闭该来源的安装授权。更新提示签名不一致时，不要立即卸载旧应用；先导出订阅和覆写，确认新旧安装包是否来自同一维护渠道。直接卸载通常也会清除客户端保存在应用私有目录中的数据。

完成订阅导入与系统 VPN 授权

进入配置页面，从 URL 新建订阅，保存后等待下载结束，再选中它作为当前配置。切换到策略组，确认节点存在并选择规则模式。首次启动连接时，Android 会显示 VPN 连接请求。这里的 VpnService 是系统提供的接口，客户端用它建立本地虚拟通道接收流量；出现 VPN 图标不表示流量一定经过某个远端服务器。

授权前核对弹窗中的应用名称。拒绝授权后，客户端可能仍能显示配置和节点列表，但无法接管其他应用流量，需要再次启动连接触发授权。如果系统始终没有弹窗，检查是否已有其他 VPN、工作资料中的 VPN 或设备管理限制。Android 通常不能让两个普通应用同时占用同一用户空间的 VPN 通道。

规则、按应用分流与始终开启 VPN

先保持规则模式，并用浏览器验证一次，再调整按应用分流。按应用分流可能采用“仅包含所选应用”或“排除所选应用”两种相反逻辑，勾选前先读清说明。被排除的应用可能不会进入内核日志，不能靠更改节点让它恢复代理。支付、局域网设备控制或工作应用如有异常，应逐项测试，不要一次排除大量应用。

系统 VPN 设置中的“始终开启 VPN”用于维持指定 VPN 应用的系统关联；“阻止未使用 VPN 的连接”则可能在通道未建立时阻断联网。两者不是同一项功能。先确认客户端在重启和网络切换后能够恢复，再考虑启用阻断选项。否则订阅过期、应用被限制或启动失败时，整台手机可能暂时没有可用网络。

锁屏后掉线，先查电池限制

锁屏后中断而亮屏恢复，优先检查应用电池设置。将客户端设为允许后台活动或不受电池优化限制；部分厂商还需要允许自启动，并在后台任务管理中保留应用。不同系统名称不同，目标是让 VPN 服务在锁屏后继续运行。通知权限与持续运行通知也应按客户端说明处理，但仅打开通知并不能代替电池白名单。

不要只做一次亮屏测速就判断已经修复。先连接，锁屏一段时间，再解锁查看客户端服务状态和断开时间；随后分别测试无线网络与移动数据。数据节省模式、后台数据限制和厂商省电模式都可能改变结果。具体路径可结合VpnService 授权与省电白名单设置要点逐项确认。

DNS、热点共享与跨客户端迁移

Android 的私人 DNS、浏览器安全 DNS 与客户端内的 DNS 设置可能同时存在。遇到域名解析失败，应先记录各层设置，再一次只改一处验证。不要看到 DNS 字样就全部关闭；需要判断请求由哪个应用发出、是否进入 VPN、最终走哪个解析器。节点地址本身也需要解析，节点服务器域名无法解析时，后续规则再正确也建立不了连接。

手机开启热点，不代表连接热点的设备会自动共享手机应用的 VPN 路径。不同系统的转发机制和权限限制不同，不应把“允许局域网连接”理解成热点一键代理。迁移客户端时也要重新检查按应用列表、省电设置和 VPN 授权，它们通常不能随 YAML 文件移动。最后完成锁屏、重启和网络切换三种测试，再把旧客户端停用或移除。

iOS：商店安装、配置兼容与 VPN 连接

从商店安装 Clash Plus

iOS 优先使用 Clash Plus，可从iOS 下载区进入，也可直接打开Clash Plus 的 App Store 页面。产品官网为 clashplus.io。安装前查看商店列出的系统兼容要求，以设备实际系统与商店信息为准，不把桌面客户端的功能列表直接套到手机上。

首次打开应用后，先找到配置导入和连接页面，暂时不要修改大量高级选项。iOS 应用通常通过系统提供的网络扩展建立 VPN 通道，系统授权与订阅内容是两件事：允许建立通道，不代表已经获得节点；导入订阅成功，也不代表系统已允许应用接管网络。这两个环节必须分别完成并验证。

导入时确认格式，而不只看链接名称

在客户端支持的导入入口粘贴订阅地址，确认保存后选中对应配置。如果应用支持文件导入，也应确认文件类型与字段范围。Clash 生态中的配置并不是跨实现完全一致的标准，内核扩展、规则提供器、本地文件路径和脚本功能都可能存在差异。桌面上能加载的 YAML，在手机上可能需要调整或改用订阅提供方给出的兼容入口。

导入失败时先看报错属于下载失败还是解析失败。下载失败检查链接是否有效、网络是否需要认证，以及地址是否被复制截断；解析失败则检查返回内容是否为配置，是否混入登录网页或错误提示。不要把整个订阅地址贴到公开问答中。需要求助时，保留错误类型和字段名，隐藏链接参数、节点密码与个人账户标识。

允许添加 VPN 配置并选定出口

首次启动连接时，系统可能要求允许添加 VPN 配置，并通过设备密码或生物识别确认。完成后回到应用查看连接状态，再检查系统 VPN 记录是否对应当前应用。应用创建的 VPN 配置与设备管理描述文件不是同一概念；日常订阅导入不应因此变成安装来源不明的管理描述文件，更不需要为了普通代理连接授予整机管理权限。

在应用支持的范围内先选规则模式，再在被使用的策略组里选择节点。若页面可打开但指定应用不通，先查看是否存在分流差异，而不是立即切换所有网络选项。iOS 上某些应用会保持已有连接，改变策略后可能需要重新打开应用或重新建立连接才能看到新出口。测试时也要区分缓存页面和真正发出的新请求。

锁屏与网络切换要单独验证

iOS 的 VPN 网络扩展与应用前台界面生命周期不同，不能照搬 Android 的后台锁定办法。不要通过反复划掉应用来测试保活；应正常返回主屏，锁屏后观察再次联网的表现。低电量模式、网络切换和系统资源状态都可能影响连接恢复，判断时看实际是否需要重新建连，而不是仅看应用是否仍在多任务界面。

无线网络切到移动数据时，原有连接可能失效并重新建立。如果只在某个无线网络失败，先检查该网络的认证页和访问限制。遇到其他 VPN、设备管理策略或系统隐私相关网络功能同时启用，先记录当前状态，逐项停用验证冲突。不要把每一个异常都归因于节点，也不要同时重置所有系统网络设置而失去对照依据。

更新订阅与迁移时保留可恢复路径

更新订阅前保留已有本地规则或应用支持的配置备份，更新后确认策略组名称和选择没有变化。节点被删除或组名改变时，旧选择可能失效。手机与电脑同步使用同一订阅，还需要遵守订阅服务的设备和并发约定；能导入同一个链接不等于允许无限设备同时连接。

更换手机后优先重新安装应用、重新导入订阅并授权，不假定系统备份会完整恢复 VPN 状态。完成浏览器访问、常用应用、锁屏和移动数据测试后，再清理旧设备上的配置。涉及具体客户端差异，可结合手机客户端横向对比核对支持范围，避免把其他应用的操作步骤当作当前界面的固定路径。

Linux：桌面代理与独立内核部署

先区分桌面客户端与服务器内核

Linux 下载区提供 Clash Verge Rev 和 FlClash 等图形客户端，适合桌面环境；独立 mihomo 内核更适合服务器、路由器或需要自己管理服务的场景。先确认发行版、包格式和处理器架构，再选择安装包。Debian 系与采用 RPM 包管理的发行版不能只凭扩展名相近就混用，桌面组件依赖也可能不同。

桌面用户优先用包管理器安装对应客户端，以便记录依赖和卸载关系。启动后从配置界面导入 URL 订阅，启用后检查策略组与规则模式。不要在图形界面里用管理员账户长期运行整个应用来绕过权限问题。TUN 所需的特权服务应按客户端文档安装，界面权限与网络接口权限分开处理。

系统代理与终端环境要分别设置

GNOME、KDE 等桌面环境有各自的网络代理入口，但并非所有应用都读取它。命令行程序经常使用环境变量或独立配置文件，容器内程序又有自己的网络空间。客户端已开启系统代理而终端仍直连，是常见情况，不一定表示内核异常。先用显式指定代理的请求验证监听端口，再检查具体程序的代理设置。

curl --proxy http://127.0.0.1:7890 --head https://example.com

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,::1

unset http_proxy https_proxy no_proxy

以上示例假定混合端口为 7890，需以实际配置为准。环境变量只影响继承它的进程，已经运行的程序不会自动改变；不同工具对变量大小写的支持也有差别。这里只在当前 shell 临时设置，验证有效后再决定是否写入登录配置。不要把代理变量直接写进全系统配置，导致客户端未启动时所有维护命令都无法联网。

独立内核先前台测试，再交给服务管理

独立部署前准备可执行文件和完整配置，将它们放在权限明确的目录。下面假定程序安装在 /usr/local/bin/mihomo，配置位于 /etc/mihomo/config.yaml。先运行语法检查，再以前台方式启动，观察订阅引用、本地规则文件和监听端口是否正常。语法检查通过只代表配置可被解析，不保证节点可达或路由正确。

/usr/local/bin/mihomo -t -d /etc/mihomo -f /etc/mihomo/config.yaml
/usr/local/bin/mihomo -d /etc/mihomo -f /etc/mihomo/config.yaml

前台工作正常后，再根据发行版采用服务管理器。systemd 服务需要明确程序路径、配置目录、运行身份、重启策略与日志查看方式。普通本机代理可按最小权限运行；TUN 涉及创建网络接口和修改路由，需要额外权限设计。不要直接复制来源不明的服务文件，也不要把订阅凭据写进可被其他用户读取的启动参数。

TUN、DNS 与容器网络的边界

TUN 启用前检查系统是否提供 TUN 设备，以及服务账户是否有必要权限。自动路由可能与其他 VPN、策略路由、容器网桥或远程管理路径冲突。远程服务器操作时尤其要保留恢复方式，先验证当前 SSH 管理连接不会被新路由带走，再考虑持久化。不要在唯一的远程会话中直接试验全流量接管并立刻重启服务。

DNS 常由 NetworkManager、systemd-resolved 或其他组件管理。不要把 /etc/resolv.conf 当成一定能永久手工编辑的普通文件，它可能是链接或由服务生成。应先确认现有管理链路，再决定客户端如何接收查询、上游解析走哪里，以及节点服务器域名怎样解析。容器中的回环地址指向容器自身，并不自动指向宿主机代理。

更新内核前保存当前程序和配置，更新后先执行测试命令，再重启服务并查看启动日志。遇到字段兼容问题，参考Clash、Meta 与 mihomo 内核差异，不要直接把错误字段删光。确认本机请求、DNS、远程管理与重启恢复都正常，才算完成部署。

配置常见问题：按链路定位，不反复重装

订阅下载失败与配置解析失败怎么区分

先看错误发生在哪一层。连接超时、域名无法解析或服务器拒绝请求，属于订阅获取问题；出现缩进、字段类型或引用不存在的报错，才进入配置解析范围。订阅地址返回网页时，客户端可能把网页内容当作 YAML 解析，错误位置往往没有实际参考价值。先确认链接有效且返回预期格式，不要只对着第一行报错改缩进。

更新后突然失败，保留上一份可用配置，比较变化范围。订阅中的组名、规则提供器或协议字段可能已经调整，旧内核未必支持。通过客户端的配置测试与日志确认后，再决定更新客户端还是换兼容订阅。第三方在线转换会接触订阅内容，使用前应理解资料暴露范围，不要为了处理一次导入错误把私人链接交给不明服务。

节点能测试，网页却打不开

按“应用 → 流量接管 → 规则 → 策略组 → 节点 → 目标站点”的顺序检查。客户端没有对应连接记录，优先查系统代理、VPN 授权和应用排除；有记录但走 DIRECT，查规则命中；命中预期组却选错节点，查组内选择；出口正确仍失败，再看 DNS、握手或目标服务限制。每次只变更一个条件，才能判断是哪一步改善了结果。

全局模式可以短暂帮助区分规则问题，但不适合当作所有故障的最终答案。测试后恢复原模式。节点延迟来自特定测试请求，受测试地址、超时和网络条件影响，不能简单当作下载速度排名。连续测速还可能增加手机耗电。需要自动选择策略时，先理解 url-test、fallback 与 load-balance 的不同，再参考策略组配置详解设置。

自定义规则为什么没有生效

规则通常从上往下匹配，具体规则应放在宽泛兜底之前。策略名称要与现有策略组严格一致，名称中的空格和大小写也要留意。下面是用于说明顺序的局部示例，其中私有地址直连，指定域名直连，最后才走“手动选择”；该策略组必须已存在，不能只复制规则而不定义引用对象。

rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,手动选择

若客户端使用订阅覆写、规则前置或合并配置，应编辑持久化的覆写入口，而不是仅修改下载缓存。否则更新订阅就会覆盖修改。规则看起来正确却没有命中时，还要核对请求实际使用的是域名还是 IP、连接是否在修改前就已建立，以及客户端展示的是源文件还是最终运行配置。对照最终配置比反复刷新订阅更有效。

DNS 失败、IPv6 与局域网问题

DNS 是把域名转换为地址的过程，解析成功之后仍可能连接失败。先区分节点服务器域名与目标网站域名，前者失败会让整个代理出口无法建立。使用 Fake-IP 时，客户端可能给出用于内部映射的地址，这不一定是错误，但要求相关连接继续进入同一套处理链路。遇到兼容异常，应在理解配置后对特定域名做排除，而不是随意更换整段地址范围。

IPv6 同样要检查整个路径：系统是否获得地址、DNS 是否返回相应记录、客户端是否接管、节点是否支持出口。关闭某个开关只适合用于缩小问题范围，不能直接推导所有网络都应关闭 IPv6。局域网异常则先核对路由与直连规则，再看发现协议和名称解析。不要把代理错误、证书错误和局域网发现失败混成同一种“连不上”。

备份、回退与求助要带什么信息

一次可靠的备份应包含订阅来源、本地覆写、必要的规则文件和客户端设置说明，敏感数据单独保护。回退时恢复最近一次可用状态，再重现单项改动，不要同时换客户端、订阅和 DNS。求助时提供系统类型、客户端名称、接管方式、错误发生步骤与脱敏日志；日志临时提高详细程度即可，定位后恢复普通级别，避免长期记录不必要的访问细节。

如果问题已经定位到单一设置，继续查常见问题；忘记术语含义时查术语手册；想重新按顺序建立一条可用连接，则返回快速上手教程。本手册的使用原则是先保存可用状态，再逐层验证。只要能明确请求停在哪一层，就不必用反复卸载安装来代替排查。