官方手册 · 系统查阅

Shadowrocket
Settings 设置参考

按作用范围核对设置,保留修改前的值,再用相同请求验证结果。

首次配置请先阅读快速上手教程,完成已有资料导入与连接验证;本页用于连接之后的系统查阅,解释设置之间的关系、推荐基线和回退方法。下文操作路径以 iPhone / iPad 为参照,其他平台的项目位置可能不同,不能直接照搬系统权限步骤。

Shadowrocket 支持 iPhone / iPad / Mac / Windows / 安卓 / Linux。iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。获取与安装放行见全平台下载页;iPhone / iPad 的系统要求以 App Store 页面标注为准。

01 / SETTINGS

Settings 的作用范围与默认值核对

先区分服务器、配置文件和应用设置

Shadowrocket 的运行结果不是由某一个开关单独决定的。Home 中保存服务器或 Subscribe 导入的资料,Config 管理规则与相关配置,Settings 则提供应用级行为和工具选项。系统中的 VPN 权限、网络权限以及当前接入的 Wi-Fi 或蜂窝网络还构成另一层条件。排查时必须先确认修改落在哪一层:服务器地址错误应检查资料,域名走向不符合预期应检查规则,自动重新连接才应检查 On Demand,不能把所有问题都归到 Settings。

同名项目还可能在应用设置与配置文件中分别出现。例如 DNS 既可能受到当前 Config 的配置影响,也与系统网络环境有关。看到 Settings 中某个值,不代表正在运行的连接一定只使用这个值。检查顺序应当是先记录当前 Global Routing、选中的服务器和正在使用的 Config,再查看配置文件是否写入相关参数,最后确认应用设置。只有把有效配置来源确定下来,后续比较才有意义。

“默认值”不等于当前屏幕上的值

本文不把某一设备上的初始状态当作所有设备的固定出厂值。应用更新、历史迁移、订阅附带的配置和恢复备份都可能使当前值不同,部分项目的名称或可选范围也会随平台变化。因此,对没有统一可核对数值的设置,本页给出的是“保持当前可用状态”的建议基线,而不是捏造默认数字。若界面存在明确的重置选项,应先备份再使用,并记录重置前后的差异。

建立基线时,建议在一张本地记录中写下网络类型、Global Routing、当前 Config 名称、服务器备注和本次要改的项目。密码、完整订阅地址、PrivateKey 等不要写进用于分享的记录。测试前先确认一个原本能够访问的目标,修改后仍测试这个目标,不要同时换网站、换网络和换服务器。否则即使结果变好,也无法判断究竟是哪一项产生影响。

范围主要内容建议基线
Home服务器、Subscribe、当前选择保留一条已验证可用的记录
Config规则、DNS 及配置引用修改副本,不直接覆盖可用文件
Settings测试、日志、同步与本地行为只调整当前问题涉及的项目
系统设置VPN、网络权限、后台条件按实际提示授予所需权限

让每次修改都可以回退

开始编辑前,先导出或复制当前 Config;涉及服务器资料时,还要确认能够从原有资料恢复。不要只保存一张 Home 列表图片,因为图片通常不包含完整参数。随后一次只改一个变量,按需要断开并重新建立连接,再确认新设置是否进入运行状态。编辑了一个文件但没有选用它,是常见的“改了却不生效”原因;仅看文件名称也不够,还应核对实际内容。

若修改后出现异常,优先恢复刚才那一个值,而不是连续叠加其他修改。恢复后重新测试,确认问题随设置恢复而消失,才算建立了关联。找不到对应项目时,不应从名称相近的选项猜测替代功能,可以先查术语手册确认含义。共享设备上进行维护,还应说明本次调整会影响哪些连接,避免他人在测试期间继续更改当前服务器或配置。

02 / ROUTING

Global Routing 与 Config 规则优先级

配置、代理、直连分别改变什么

Global Routing 决定请求采用哪一种整体处理姿态。配置对应 Config,按当前配置中的规则决定走向;代理对应 Proxy,适合短时间确认请求是否能通过所选代理路径完成;直连对应 Direct,用于比较当前网络直接访问的结果。三者不是速度等级,也不是越“全局”越完整的开关。日常需要规则分流时通常使用 Config,排错时才临时切换另外两种姿态作对照,测试结束应恢复原来的选择。

这里的 Config 姿态与底部 Config 页面需要区分:前者决定是否按规则处理,后者用于管理具体文件。即使已经编辑并选中一个配置文件,如果 Global Routing 仍是 Proxy,也不能据此判断某条域名规则是否正确命中。相反,处于 Config 时访问异常,也不能直接断定服务器不可用,因为请求可能被前面的 DIRECT 或 REJECT 规则处理,根本没有经过预期的代理路径。

中文说明 / 界面词查验目的不能据此证明
配置 / Config验证当前配置的匹配结果全部请求都经过所选服务器
代理 / Proxy对照所选代理路径的可用性Config 中每一条规则都正确
直连 / Direct对照当前网络的直接访问结果所有目标都适合直连

按顺序阅读规则,不按名称猜用途

规则通常按照配置中的顺序进行匹配,先命中的规则决定对应请求的处理方式。DOMAIN 针对精确域名,DOMAIN-SUFFIX 针对域名后缀,IP-CIDR 与 IP-CIDR6 针对地址网段,GEOIP 按 IP 地理数据库归类,FINAL 接住前面没有匹配的请求。DOMAIN-SUFFIX 不应填写带协议头的完整网址,也不应把路径和查询参数一起写入。需要区分主域名与子域名时,先明确匹配范围再选关键字。

下方片段只展示语法和顺序:第一个域名后缀交给 PROXY,随后对匹配 GEOIP 条件的请求使用 DIRECT,其余请求进入 FINAL 指定的 PROXY。它不是适合所有人的完整配置,也不包含服务器凭据。GEOIP 规则可能涉及解析后的地址与数据库结果,不能替代明确的业务域名判断。若某个目标既满足前面的域名规则又符合后面的地址规则,不能忽略顺序只看后面的策略。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

用一次实际请求验证命中关系

检查某个域名时,先在当前配置中搜索精确域名、上级后缀和相关规则引用,判断是否存在更早命中的条目。接着清理测试干扰:关闭目标页面后重新发起请求,必要时断开并重连,避免旧连接仍在传输。浏览器中的一个页面可能调用多个域名,页面正文成功而图片失败,并不等于整站只命中一条规则。应从日志里找出实际失败的主机名,再分别检查。

建议先在配置副本中增加一条范围明确的测试规则,确认命中后再决定是否合并进正式文件。不要为了修复一个域名,把 FINAL 随意改成另一种策略,因为那会影响所有未匹配请求。默认策略必须根据已有配置的用途核对,不存在通用的“永远正确”取值。如果 Proxy 姿态可访问、Config 姿态失败,优先比较命中规则、DNS 和策略目标;如果两者都失败,再检查服务器、认证资料与底层网络。

规则更新之后还应检查远程资源是否成功取得,以及配置是否重新载入。Subscribe 更新服务器列表与 Config 更新规则不是同一件事,不能用列表刷新成功证明规则已经生效。想先完成基本连接,再返回此处研究匹配关系,可按教程中的 Global Routing 步骤建立基线;遇到专有关键词则查阅术语手册,不要从中文备注推断规则语义。

03 / DNS

DNS 解析、缓存与请求路径

DNS 解决名称,不直接决定所有流量

DNS 把域名转换为可用地址,是连接链路的一部分。解析成功只能说明取得了回答,不能证明目标端口可连接、TLS 握手成功或网页资源完整。反过来,网页打不开也不必然是 DNS 故障,可能是服务器认证失败、规则走错路径或目标服务异常。设置前应明确当前问题发生在哪一阶段,避免把任何失败都通过反复更换解析服务器来处理。

先查看当前 Config 是否显式声明 DNS,再检查 Settings 中对应项目。若没有明确需求,建议保留现有可用配置,不把某个公共解析地址当作所有网络的标准答案。系统提供的解析器、手动指定的解析器以及加密解析方式各有可达性条件;解析服务器本身也需要能够从当前网络路径访问。新增一个不可达地址,可能使原本只有一个网站异常的问题扩大到多个域名。

默认状态与建议基线怎样记录

DNS 的默认状态应以当前安装、当前 Config 和系统网络实际显示为准。记录时不仅写地址,还要写清它来自系统、应用设置还是配置文件;如果填写了多个地址,也要保存完整顺序与相关选项。下面使用 system 表示采用系统 DNS 的配置写法,只用于说明参数结构,不表示所有设备出厂文件都有这一行。不要将片段直接覆盖到已有完整文件,尤其不能丢掉原来的服务器和规则部分。

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

推荐的排错基线是先保留一个已确认可达的解析方案,暂停同时调整多个 DNS 相关选项。若从系统解析切换到手动解析,必须用相同域名、相同网络和相同服务器复测,并检查返回地址是否发生变化。地址变化本身不等于错误,因为同一服务可能根据位置和负载返回不同结果。只有把回答、后续连接与实际访问结果一起比较,才能判断调整是否有效。

缓存、IPv6 与局域网名称

DNS 缓存可能存在于应用、系统和访问工具的不同层级。修改设置后继续看到旧地址,不一定是配置没有生效,也可能是已有连接尚未关闭或缓存仍有效。如果当前界面提供清理缓存功能,可在记录旧结果后使用,再重新连接并发起一次新请求;没有对应入口时,不要猜测隐藏操作。仅刷新网页有时仍会复用原连接,应结合日志判断是否真的产生了新的解析和连接。

对同时返回 IPv4 与 IPv6 地址的目标,不能只看到一个地址可达就认定整体正常。网络可能提供 IPv6 地址却无法稳定完成目标连接,也可能只对某一种地址族存在限制。排查时记录实际连接地址及其类型,用相同条件比较结果;不要一开始就把关闭某种地址族当作永久方案。涉及局域网主机名、路由器管理地址或单位内部域名时,还应确认它们是否依赖当前网络专用解析器。

局域网名称在切换到外部解析器后可能无法得到正确回答,这不意味着远端服务器资料失效。应先在原网络直接验证该名称,再检查规则是否让内部流量走了不合适的路径。网络登录页面也可能依赖系统提供的解析与跳转条件,尚未完成网络认证时不宜先大幅修改 DNS。完成网络接入之后再恢复 Shadowrocket 测试,更容易区分环境问题与配置问题。

04 / ON DEMAND

On Demand 与连接生命周期

自动触发与规则分流分开处理

On Demand 用于根据设定条件触发连接行为,属于连接生命周期管理;Global Routing 决定连接建立后请求如何处理。两者不是同一个开关。启用 On Demand 不会自动修复错误的服务器资料,也不会替你生成完整分流规则。使用前应先在手动连接状态下确认服务器、Config 与目标访问都正常,否则自动化只是反复触发同一个失败过程,增加排查难度。

默认是否启用,应以当前设备界面及系统 VPN 配置为准,尤其是恢复过备份或更换过设备的情况。排错阶段建议暂时采用手动连接,记录 On Demand 原来的开关和条件,再做网络切换测试。等手动连接稳定后,才按实际需要逐项恢复自动触发。不要为了实现“一直连接”的观感,未经验证就打开所有条件;条件越多,越需要明确它们之间的匹配关系。

网络切换后为什么可能重新连接

从 Wi-Fi 切换到蜂窝网络时,本地地址、路由和可用解析器都可能改变,既有连接可能需要重新建立。此时状态短暂变化不一定代表配置损坏,应先等待当前连接过程完成,再检查实际请求。如果每次切换都失败,而在原网络内长期可用,应比较两种网络对服务器地址、端口及解析路径的可达性,而不是只调整自动触发开关。自动连接能发起尝试,不能改变底层网络条件。

若设置中按网络名称或网络类型区分触发条件,先核对当前连接是否真正满足条件。名称相近的两个 Wi-Fi 不一定属于同一个规则范围,系统是否向应用提供相关网络信息,也受权限与系统行为影响。测试时选择一个明确的场景,例如只在当前 Wi-Fi 中观察一次,再切换到另一个已知网络。每一步都记录连接是否被触发、是否建立成功,以及失败后是否继续尝试。

  1. 先关闭自动触发,确认手动连接与实际访问都能完成。
  2. 记录原有条件,只保留本次需要验证的一组 On Demand 条件。
  3. 切换一次网络,等待状态稳定,再检查新的访问请求。
  4. 测试结束恢复原值,避免将临时条件留作日常设置。

手动断开后又连接,如何定位

手动断开后很快重新连接,首先检查 On Demand 是否仍处于启用状态,以及系统 VPN 设置中是否保留了相应的按需行为。接着确认是否有其他已授权的自动化操作在调用连接动作。不要连续点击开关来“压住”重连,因为这会在短时间内制造多次连接与断开记录,使日志难以阅读。先停止自动触发来源,再进行一次明确的手动操作,更容易得到可解释的结果。

系统 VPN 标记可以作为状态线索,但不能单独证明目标流量经过了哪一条规则,更不能证明已有服务资料仍有效。应同时核对 Shadowrocket 的连接状态与一次实际请求。设备锁定、网络暂时不可用、系统资源管理都可能影响连接表现;不要据此承诺任何场景下持续保持同一会话。对需要长时间传输的任务,测试时还应观察网络切换后的恢复情况,而不只是打开页面的瞬间。

如果在需要网络登录的 Wi-Fi 中自动连接反复失败,可先停止 On Demand,完成系统要求的网络认证,再手动连接验证。离开该网络后记得恢复原有设置。若只有特定网络出现问题,保留网络类型与发生顺序即可,不必公开完整网络名称或个人位置。长期使用建议保留最少且用途明确的触发条件,定期检查更换设备或修改 Config 后是否仍符合原来的使用目标。

05 / CONNECTIVITY TEST

Ping、Connectivity Test 与超时判断

测试名称相近,测量对象可能不同

Ping 在日常表述中常被泛指为延迟测试,但应用中的具体测试可能涉及不同过程。网络层的探测、到服务器端口的连接测试,以及通过代理访问测试目标,不能混为一谈。使用 Connectivity Test 前,应先看当前界面提供的测试方式和目标说明。不要只凭列表旁边显示了一个时间值,就认定认证、DNS、规则和网页加载都已经通过验证,测试覆盖到哪一层才是关键。

默认测试方式、目标和超时应以当前界面为准,本文不规定一组未经核对的出厂数字。建议先保持原有可用值,只在确定测试目标本身不可达、响应过慢或不适合当前网络时才修改。若测试地址需要自行填写,应选择自己能够验证、响应稳定且不要求登录的目标,并确认测试是否经过代理。不要把带私人参数、访问令牌或临时授权信息的链接作为公共测试地址。

延迟、吞吐与业务可用性分开观察

一次较短的响应时间,反映的是当时、该测试方式与该目标下的结果,不等于大文件传输一定更快。吞吐还受到链路带宽、拥塞、服务端限制和目标站点负载影响;页面加载则可能包含多个域名和多轮请求。选择已有服务器时,先确认目标业务能完成,再比较同条件下多次测试的稳定性。不要仅按一次测得的最小值更换当前选择,也不要把测试结果当成长期保证。

观察结果优先检查下一步验证
测试超时,实际访问正常测试目标、方式、超时范围保持业务请求不变,对照另一种测试方式
测试有响应,网页失败认证、DNS、规则与目标服务查日志中具体失败的连接阶段
仅某个网络下失败服务器端口与网络路径在另一个已知网络重复同一测试
偶发波动网络切换、并发传输、目标负载分时重复,保留相同测试条件

超时并不等于服务器已经失效。可能是测试目标没有按预期响应,也可能是当前网络无法到达服务器端口,还可能是测试超时设置短于实际完成时间。应先确认其他访问是否同步失败,再判断故障范围。若只有一个测试方式失败,优先核对测试机制;若所有请求都失败,再检查服务器地址、端口、密码或密钥,以及当前设备是否真正建立了连接。

建立可复现的对照测试

批量测试前先停止大文件传输,尽量保持设备处于同一网络,并选择少量已有记录验证。大量并发测试会占用连接资源,结果可能受设备与网络负载影响,不能把不同批次的数据直接排名。对同一条记录连续测试几次,观察是否每次都能完成;如果只有第一次慢,可能与连接建立、解析或缓存有关,需要结合日志进一步确认,而不是立刻修改协议参数。

要比较两个设置,先记录修改前的方式、目标和结果,再只改变一个值。测试过程中不要同时更新 Subscribe、切换 Global Routing 和更换 DNS。结束后补做一次实际使用动作,例如重新打开同一页面并等待主要资源加载完成。只有测试和实际访问的变化方向一致,才能把结果用于日常选择;若两者矛盾,应优先保留可以完成实际任务的配置并继续定位差异。

已有多份 Subscribe 时,备注相同不代表连接参数相同,测试前应确认所测记录属于哪一份来源。更新后出现重复项,还可能让你误以为正在比较不同服务器。分组、排序和重复记录的处理可参阅多个订阅管理文章。本节只讨论测试方法,不根据测试数值评价或推荐任何服务来源,也不把测试列表作为服务质量证明。

06 / LOG

Log、Data 与分阶段故障排查

先缩小时间窗口,再读取错误信息

Log 用于观察连接过程,Data 中的流量记录可辅助判断是否有数据传输,两者都不能单凭一个总量证明某个目标已经访问成功。日志位置与可见字段以当前界面为准,查找时先记下复现问题的时间,再只执行一次测试动作。大量历史记录混在一起时,很容易把后台请求的错误当作当前页面失败原因,因此应优先缩小观察窗口,而不是一开始就逐行阅读全部内容。

日志详细程度的默认状态应以当前设置为准。建议日常保留满足基本诊断所需的状态,只有复现复杂问题时才临时增加详细程度;若界面没有日志等级选项,不应照文档猜测一个不存在的开关。详细日志可能增加存储与处理开销,也会暴露更多访问上下文。问题查清后应恢复原设置,并按自身隐私需求管理已有记录,不要长期收集超出实际需要的信息。

按解析、连接、认证和应用响应分层

先看请求是否出现。若完全找不到目标相关记录,确认应用是否正在连接、目标是否复用了既有会话,以及该流量是否进入当前处理范围。接着看是否取得目标地址,再看是否建立到服务器或目标端口的连接。地址解析失败与端口连接失败属于不同阶段,处理方法不同;不要只看到一个 timeout 字样就认定密码错误,超时可能发生在链路中的多个位置。

认证失败应回到用户已有的服务器资料,核对协议、端口、密码或密钥、加密参数,以及需要时的 TLS 和传输参数。不要把某个协议的字段生搬到另一个协议中。若连接已经建立,但 TLS 阶段失败,要核对服务端要求的名称、证书有效条件和设备时间,不能以关闭验证作为通用修复办法。若已经收到目标的应用层错误响应,则需要进一步判断目标权限或服务本身的状态。

[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT

上面的窄范围规则可用于配置副本中的对照:只将精确域名交给 PROXY,其余按 FINAL 处理。它不覆盖该网站可能调用的子域名,也不是完整排错配置。若主页面和静态资源走向不同,日志会出现多个主机名,应分别核对。处理完毕后删除临时规则或恢复原文件,避免测试用的 FINAL 改变日常请求路径。保存配置与确认正在使用该配置,是两个都要完成的步骤。

把日志变成可以交流的复现材料

一份有效的问题记录应包含设备平台、网络类型、Global Routing、当前 Config 的用途、失败动作和已经完成的对照测试。版本信息可从应用内查看,反馈时使用实际读到的值,不要从旧文章抄写。错误文本尽量保留原文和上下文,但在分享前删除完整订阅地址、认证字段、个人域名、网络名称等敏感内容。只遮住密码却留下带令牌的链接,仍可能泄露服务访问权限。

若 Config 可访问部分目标,先比较成功与失败请求的规则命中和地址类型;若只有某一条服务器记录失败,比较它与原始资料是否一致;若全部记录在一个网络失败、另一个网络正常,优先调查网络路径。这样的分支能不断缩小范围。相反,连续重装、删除全部配置、同时重置多个选项,会丢掉有用证据,还可能使原本可以恢复的状态无法找回。

排查结束后再做一次回归检查:恢复日志等级与临时规则,验证原先正常的目标仍能访问,确认 On Demand 没有残留测试条件,查看是否有异常持续重连。故障解释应对应观察事实,例如“更换网络后端口连接恢复”,而不是泛称“设置修好了”。如果证据还不足,就保留不确定性并继续收集单次复现记录,不要把某一次偶然成功写成固定解决步骤。

07 / BACKUP

iCloud 同步、Config 备份与迁移

同步不是独立的历史备份

iCloud 同步用于在满足条件的设备间传递应用支持的数据,但具体支持哪些内容,应以当前界面和实际恢复结果为准,不能假定所有服务器、规则、日志与系统权限都会一起迁移。同步也不等于可以随时回到任意历史状态:删除或错误修改可能随同步传播。因此,在大幅整理 Config、批量删除记录或更换设备前,应另做一份可独立保存的导出备份,并确认文件能够读取。

默认同步状态要分别检查应用内选项、系统 iCloud 权限和账户状态,不能因为设备已经登录账户就认定 Shadowrocket 已同步。推荐先保持当前可用设备不动,在另一设备检查是否出现预期内容,再决定是否调整选项。若某项能力只在特定平台提供,应按该平台实际入口操作;跨平台迁移时尤其不能把某个系统的云同步能力当成全部平台通用的文件传输方式。

分别备份规则、服务器资料与设置记录

Config 文件主要承载配置内容,但它可能只引用服务器或远程资源,并未内嵌完整资料。导出前应打开文件,理解它包含的是规则、DNS 参数、资源引用,还是也包含认证信息。单独保存一个文件名不足以证明备份完整,单独保存 Subscribe 地址也不保证未来一定能够重新取得内容。原始资料应由用户自行妥善保管,同时避免把真实凭据写进公开笔记或分享目录。

建议把迁移准备分为三部分:第一份保存当前可用 Config 的副本,第二份保存能够重建已有服务器记录的资料,第三份记录应用级设置,如 Global Routing、On Demand、测试方式和本地端口用途。导出文件保存在受控位置,文件名可注明用途,但不要直接包含密码或订阅令牌。涉及敏感资料的备份不应随意发送给他人,也不应把公开网盘链接当作长期保管方案。

  1. 在旧设备确认当前连接可用,再导出 Config 并检查文件内容。
  2. 单独核对已有服务器与 Subscribe 是否有可恢复的原始资料。
  3. 在新设备导入后,重新选择 Config、Global Routing 和当前服务器。
  4. 完成实际访问与自动连接测试,再整理旧设备和重复文件。

同步冲突与新设备恢复检查

两台设备同时编辑同一份配置,可能产生覆盖或难以辨别的副本。开始处理前先保留两边文件,比较规则、资源引用与关键设置,再决定以哪一份为基础。不要只凭文件名相同就认为内容一致,也不要在尚未同步完成时连续删除与重建。推荐先指定一台设备作为本次编辑端,另一台暂时停止修改,等结果确认后再继续操作,这样更容易追溯变化来源。

恢复后先手动连接,不急于启用 On Demand。系统 VPN 授权通常需要在新设备重新确认,局域网访问与其他系统权限也应按实际提示检查。随后确认 Global Routing 是否符合原用途,Config 是否选中了正确文件,服务器是否仍指向有效记录。若规则引用远程资源,还要确认资源能够正常取得;看见文件出现在列表里,并不等于其中所有外部依赖都已准备完成。

旧设备可用而新设备失败时,应逐项对照,不要立即判断为同步损坏。两台设备可能连接不同网络、使用不同解析条件或选择了同名但参数不同的记录。先让它们处于可比较的环境,再核对配置内容和当前选择。还要考虑已有服务是否对同时连接存在限制,这属于用户原有服务条件,不能通过修改客户端显示名称解决,也不应为测试公开账户凭据。

完整迁移顺序见配置备份与换机迁移文章。清理旧数据前应至少完成一次重启应用后的访问验证,并确认备份仍可独立取得。若新设备安装尚未完成,先按下载页处理获取与系统提示,再继续恢复配置。应用安装、资料恢复与连接验证是三个阶段,分开完成能避免把获取问题、同步问题和网络问题混成同一类故障。

08 / LOCAL ACCESS

Proxy 端口、Widget 与日常维护基线

本地 Proxy 端口不是服务器端口

本地 Proxy 端口用于让符合条件的程序通过指定协议接入客户端,而 Home 中服务器端口是远端服务的连接参数。两者可以恰好相同,但没有必须相同的关系。若某个程序要求填写 HTTP 或 SOCKS5 代理,应先确认 Shadowrocket 当前平台是否提供相应监听功能,以及该功能是否启用,不能直接把远端服务器地址和端口填进本地代理设置,除非原有服务本来就要求那种接入方式。

端口的当前值、监听地址与默认开关,以实际 Settings 界面为准,本文不指定一个所有设备都通用的数字。推荐基线是:没有程序需要显式代理时,不额外开启局域网共享;只有本机程序使用时,优先限制在本机访问范围。修改监听端口前,先记录原值,确认没有其他程序占用新端口,再同步更新使用它的程序。只改一端,另一端仍指向旧端口,就会出现连接被拒绝或超时。

项目含义核对重点
监听地址哪些本地网络接口接收连接本机访问与局域网访问范围不同
本地端口客户端接收代理请求的位置调用程序填写的端口必须一致
代理协议调用程序与本地监听之间的约定HTTP 与 SOCKS5 不能随意互换
服务器端口已有远端服务的接入参数以用户持有的服务器资料为准

局域网共享的边界与验证顺序

允许局域网设备接入会扩大可访问范围,因此只应在明确需要且网络受控时使用。先确认接入设备与运行 Shadowrocket 的设备能够互相访问,再检查系统防火墙、监听地址和端口;同一个 Wi-Fi 名称不必然意味着设备之间可以通信,访客网络隔离就可能阻止连接。不要为了验证一个程序而直接放宽全部系统防护,也不要将本地监听暴露到不必要的外部网络。

需要填写代理地址时,本机程序与另一台设备看到的“本机”不是同一对象。调用程序中的本地回环地址指向运行该程序的设备,不会自动指向另一台正在运行 Shadowrocket 的设备。跨设备访问应使用实际可达的局域网地址,并考虑地址在网络重连后可能变化。完成测试后,如果不再需要共享,应关闭相应入口,恢复原来的监听范围,并清理调用程序中遗留的代理设置。

Widget 是入口,不替代连接验证

Widget 提供便捷查看或操作入口,实际可用动作以当前系统和应用提供的组件为准。添加前先在应用内确认连接正常,再按系统的小组件管理方式添加。Widget 的显示更新受系统调度影响,不能把某一瞬间的文字或图标当作实时网络监测。若显示状态与实际访问不一致,先打开 Shadowrocket 查看当前连接和服务器,再发起一次请求,不要连续通过组件反复切换开关。

默认是否添加 Widget 由系统布局与用户选择决定,不属于 Config 文件中的统一取值。推荐只保留用途明确的入口,尤其要注意锁定屏幕和共享屏幕上是否显示服务器备注等信息。换机或恢复备份后,小组件位置和授权可能需要重新确认;即使组件恢复了,也仍应检查 Config、Global Routing 与当前服务器。组件能触发动作,不代表原来的服务器资料或系统权限已经恢复完整。

日常维护可采用固定顺序:先确认已有服务资料有效,再核对当前配置与规则引用,随后检查 DNS、自动触发和测试设置,最后处理本地端口与 Widget。每次只调整与当前问题有关的一层,保留可用副本和回退记录。需要重新获取应用时前往全平台下载页;刚完成首次配置则回到快速上手教程做连接验证。稳定的基线比频繁叠加设置更有利于定位后续变化。