[Settings]官方手册 · 系统查阅

Settings 设置项参考

从设置作用范围开始,逐项核对 DNS、On Demand、连通性测试、日志、同步与本地端口。

首次导入已有订阅、选择连接方式与验证访问,请先读快速上手;本页用于解释设置为何生效、何时需要调整,以及修改后怎样恢复。以下以 iPhone / iPad 的常见界面词组织,其他平台的设置位置与可用项目以实际界面为准。

8 个查阅章节 默认状态先核对 每次只改一项

[General]

一、设置层级与默认状态

先区分 Settings、Config 与服务器参数

Shadowrocket 的连接结果不由某一个开关单独决定。Settings 中的应用级偏好、Config 当前选中的配置文件、Home 中选中的服务器,以及系统授予的网络权限,会共同影响请求。排查前应先记录这四部分的状态。例如,修改 Config 里的 DNS 条目,不等于改了服务器的地址;改动 Add Server 中的端口,也不等于改了本机 Proxy 监听端口。先辨认字段属于哪一层,可以避免在不相关的位置反复尝试。

服务器参数描述客户端如何连接用户已有的服务器,包括协议、地址、端口、认证与传输条件。配置文件主要描述请求如何处理,包括 DNS、规则与策略。应用偏好则可能涉及测试、显示、连接触发、同步及日志。具体项目在不同系统上的位置可能不同,不能因为名称相近就认定互相覆盖。某项修改看似没有效果时,应先确认当前启用的配置与服务器,而不是立即认定设置失效。

默认值应如何理解

本页不把某一次安装看到的状态当作所有设备的固定默认值。新装应用、从备份恢复、导入远程配置及沿用旧设置,都会产生不同的初始状态;同名选项也可能随系统权限或配置内容而改变。表格中的建议是建立排错基线,不是要求覆盖所有用户的选择。若界面提供默认选项,且没有明确的调整理由,应先保留;对于配置文件中未出现的字段,不要把“未填写”直接理解为关闭。

核对时可用文字记录字段名称、所在页面、当前值与修改原因。涉及开关时记录开或关,涉及选择器时记录实际选中项,涉及配置时保留原文件。不要为了查看默认状态删除正在使用的数据,也不要在没有备份时重置全部设置。需要比较时,优先建立独立测试配置,并保留原配置作为恢复点;测试完成后明确切回哪一份,避免把试验文件长期当成日常文件。

层级主要影响修改前记录
Settings应用偏好、测试、连接触发及辅助功能具体选项名称与当前状态
ConfigDNS、规则匹配与策略引用当前文件及其原始内容
Add Server与已有服务器建立连接的参数协议、地址、端口和传输条件
系统设置网络权限、后台行为及云端账户条件授权状态与当前网络

建立一次可恢复的修改流程

开始前确认已有订阅或服务器信息仍可取得,并备份当前配置。然后选择一个能重复访问的测试目标,固定同一网络、同一服务器与同一 Global Routing 状态。每次只调整一个设置,按需重新连接,再用相同目标验证。只有在结果稳定重现后,才能把变化与该设置关联;若同时修改 DNS、服务器和规则,成功或失败都无法说明究竟是哪一项起作用。

阅读本手册不需要另行获取线路。Shadowrocket 是闭源商业应用,客户端一次性买断 ≠ 线路套餐,本站不提供、不销售、不推荐节点或订阅。获取渠道见下载页:iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。iPhone / iPad 系统要求以 App Store 页面标注为准;其他平台安装包由下载页引导至本站 /dl/shadowrocket/ 路径。

后续章节按“作用、核对、建议、验证”的顺序展开。若某个界面没有文中提到的项目,先判断当前平台和配置是否适用,不需要寻找名称相似的字段强行替代。出现明确错误提示时,应保留原文,再到常见问题按现象查找,避免让未经确认的调整扩大故障范围。

[DNS]

二、DNS 与名称解析

DNS 解决的是地址查询问题

DNS 把域名查询转换为可用于连接的地址,但解析成功不代表连接一定成功。访问域名时,可能先查询地址,再依据配置匹配规则,随后建立与目标或代理服务器的连接。不同处理路径可能由本地或远端完成解析,因此不能仅凭某个查询结果判断全部流量的去向。排查应分开记录“域名是否得到响应”“规则采用什么策略”“连接是否完成”三个结果。

域名无法访问而某个地址能够连接,只能提示需要检查解析链路,并不能直接证明某个 DNS 服务不可用。地址访问可能改变 TLS 校验、服务器虚拟主机选择与应用行为,二者并非完全相同的测试。更可靠的方法是在同一应用和同一请求路径中观察错误:名称查询超时、服务器连接超时与证书名称不匹配,应分别处理,不能统一归为 DNS 故障。

核对 dns-server 与 system

在当前 Config 中查找 [General] 下的 dns-server。若已有明确设置,先记录完整内容及来源;若未出现,不要假设正在使用某个固定公共地址。下面的片段表示该项采用系统提供的解析设置,适合作为理解字段的最小示例,不是要求替换整份配置。系统解析器的实际来源可能由当前网络、设备管理或其他系统配置决定。

[General]
dns-server = system

推荐先用当前可工作的系统设置建立基线,尤其是在办公网络、校园网络或需要访问内网名称的环境中。内部域名未必能由外部解析器回答;贸然替换后,公网访问可能正常,而文件服务、登录页面或内部应用开始失败。确有必要使用其他解析方式时,应依据自己的网络要求填写,并确认该解析器本身在当前连接路径上可达,而不是只比较名称或宣传指标。

缓存、网络切换与地址族

修改 DNS 后立即刷新页面,可能仍在使用应用连接池或已有缓存,因此一次刷新不一定代表新设置已被使用。先结束相关测试请求,按需断开并重新连接 Shadowrocket,再在相同条件下复测。不要反复快速切换多个解析器;这样可能同时引入网络切换、缓存更新与服务端响应差异,难以确定真正原因。记录修改前后的现象,比连续尝试更多地址更有用。

同一域名可能返回 IPv4 与 IPv6 地址。若某个地址族的网络路径不完整,就可能出现部分应用正常、部分应用等待较久的情况。此时需要结合连接日志观察实际尝试的地址,而不是看到 IPv6 就立即关闭相关能力。禁用一个地址族可能暂时绕过路径问题,却也可能影响依赖该网络环境的服务。建议先比较不同网络下的结果,再决定是否需要针对性调整。

观察到的现象优先核对避免的误判
查询没有响应解析器可达性、当前网络与连接状态直接认定服务器认证错误
已有地址但连接超时路由策略、目标端口与实际连接路径继续盲目替换 DNS
只有内网名称失败内部解析器及内网访问条件用外部解析结果替代内部记录

安全的调整与回退边界

加密解析能改变查询的传输方式,但不会自动修复服务器参数、规则顺序或目标站点故障。使用带主机名的解析端点,还需要考虑最初如何解析这个主机名,以及请求究竟经过哪条路径。若无法说明这些依赖,应先恢复原有设置,确认普通访问恢复,再单独研究解析方式。不要把多个不理解的 DNS 选项一次性加入配置,尤其不要从不同配置中拼接相互矛盾的条目。

验证成功的标准应是实际目标在预期策略下持续可用,而不是某个测试按钮显示通过。建议至少检查一个日常公网目标、一个确实需要的内网目标,以及网络切换后的表现。回退时恢复原始 DNS 条目,并按同样流程重新连接;若现象没有随设置恢复而变化,应继续检查其他层级。与 DNS 相关的规则行为在下一章说明,两者有关联,但不应被当作同一个开关。

[Rule]

三、Global Routing 与配置规则

Config、Proxy、Direct 的作用范围

Global Routing 是判断配置是否参与处理的第一处检查点。配置、代理、直连分别对应界面词 Config、Proxy、Direct。Config 按当前配置文件中的规则选择策略;Proxy 用于按代理路径处理可接管的请求;Direct 用于按直连路径处理。这里的姿态是客户端的处理选择,不代表目标必然可达,也不应被理解为能够覆盖设备上的所有特殊流量或系统限制。

日常需要规则分流时,推荐在验证配置内容后使用 Config。Proxy 与 Direct 可用于缩小问题范围,例如比较同一目标在不同处理路径下的表现,但不适合替代对规则的理解。若只在 Proxy 下正常,应检查 Config 中的命中规则、策略引用和最终策略;若三种状态都失败,应优先核对当前网络、服务器或目标服务,不能只在规则列表中寻找原因。

界面状态主要用途验证重点
Config按配置进行规则分流当前文件、命中规则与策略
Proxy对照代理路径表现已有服务器能否完成实际请求
Direct对照直连路径表现本地网络到目标是否可达

规则顺序比条目数量更重要

在 Config 中,请求通常按规则顺序匹配,先命中的条目决定处理策略。因此,较具体的例外一般应放在范围较大的规则之前,FINAL 放在规则末尾。若把宽泛规则放在前面,后面的细分条目可能没有机会命中。增加更多规则并不自动提高准确性,反而可能让重叠条件更难排查;修改前应先确认现有条目为何没有达到预期。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

此片段只展示语法与顺序,不能作为所有网络的完整配置。DOMAIN-SUFFIX 匹配指定域名及其子域范围,DOMAIN-KEYWORD 按域名中的关键字匹配,后者可能覆盖比预想更多的名称。IP-CIDR 针对地址网段,GEOIP 依赖地址地理数据库,FINAL 为前面未命中的请求提供最终策略。示例中的 example.com 仅供说明,不是可导入的服务信息。

策略、解析与网络边界

PROXY、DIRECT 与 REJECT 是不同的处理策略。前者需要可用的代理路径,直连依赖当前本地网络,拒绝则会主动阻止匹配请求。自定义策略名称还需要在配置中有对应定义,拼写差异可能导致引用错误。排查时应先用能够理解的基础策略确认逻辑,再检查较复杂的策略选择,不要仅凭名称推断其实际指向的服务器。

域名规则与地址规则的行为也有区别。请求保留域名信息时,可以直接参与域名匹配;按地址判断时,可能涉及解析结果及其所属网段。同一个服务使用多个域名或动态地址,单独为一个地址写规则不一定覆盖全部请求。看到页面部分内容加载失败,应检查具体失败的目标,而不是只查看浏览器地址栏里的主域名。登录、图片与接口可能分别使用不同名称。

维护配置时的推荐做法

远程配置与本地修改要分开管理。若直接编辑会被更新替换的文件,下次刷新后可能丢失调整;若长期停留在本地副本,又可能错过原配置的必要维护。应先明确文件来源、更新方式和自己的修改位置。对每条例外写清用途,保留原始副本,并用少量实际目标验证。完整操作主线见快速上手中的 Config 与连接步骤。

配置更新后不要只检查文件能否保存,还应重新确认 Global Routing、选中的文件与测试目标。若规则表现突然变化,先比较变更内容,再检查服务器,不要立刻重置全部 Settings。需要查规则关键字含义时可读术语表。本章的推荐值不是一套固定规则集合,而是保持 Config 与实际意图一致、让每个例外都有可验证的理由,并为任何修改保留清晰的回退路径。

[On Demand]

四、On Demand 按需连接

按需触发不等于服务器始终可用

On Demand 用于根据系统支持的条件触发连接行为。它处理“什么时候尝试建立连接”,并不负责修复服务器认证、更新已有订阅或保证目标能够访问。启用后仍需要可用的配置、服务器和网络权限。若连接反复建立又断开,应先区分是条件重复触发,还是连接本身失败;把所有重连都归因于开关不稳定,会忽略真正的网络或参数问题。

不同系统对按需连接的支持与展示方式可能不同。本章以 iPhone / iPad 的设置核对方法为主,具体条件以当前界面为准,不要求其他平台寻找完全一致的开关。默认状态应查看设备现有设置,尤其是从旧设备迁移后,不要假设仍是新装状态。推荐先在关闭自动触发干预的条件下完成一次手动连接验证,再决定是否启用 On Demand。

从手动基线到按需条件

先在 Home 确认选中的服务器,核对 Global Routing 与 Config,再手动建立连接并访问实际目标。只有这一流程稳定,才进入 On Demand 检查条件。若当前界面允许按网络类型或网络名称设置行为,应逐项记录自己的意图,例如某个可信网络是否需要连接、移动网络下是否需要触发。不要复制不属于自己网络环境的条件,也不要把无法识别的网络名称作为唯一判断依据。

无线网络名称并不能独立证明网络可信,同名网络可能出现在不同地点。需要依赖网络条件的场景,应结合实际环境和使用要求判断,不能把名称匹配当作身份验证。对办公或受管理设备,还应考虑管理员施加的网络配置与权限限制。若设备已有其他网络管理策略,先确认其作用,再调整 Shadowrocket,避免在两套策略之间反复覆盖而无法解释最终状态。

网络切换后的验证顺序

测试应覆盖真实会发生的状态变化:从无线网络切到移动网络、返回原网络,以及短暂断网后重新获得连接。每次切换后先确认设备已具备正常上网条件,再观察 Shadowrocket 是否按预期触发,最后验证目标访问。若底层网络仍在登录认证或尚未取得可用地址,此时的连接失败不代表 On Demand 条件写错;过早连续切换只会增加不确定性。

需要网页认证的网络尤其要分开处理。先完成网络本身要求的登录,再测试代理连接;若尚未登录就重复触发连接,可能出现连接状态变化但页面打不开的现象。验证期间应避免同时更新订阅、切换配置或更换服务器。记录切换前后时间顺序,有助于判断是网络未就绪、条件未匹配,还是连接已触发但远端没有响应。

后台、耗电与恢复策略

On Demand 不等于让应用界面持续停留在前台,也不表示所有后台任务都由客户端主动维持。系统调度、网络变化、应用自身的活动与连接失败重试,都可能影响观察到的耗电。若启用后电量消耗明显变化,应在相同使用强度下比较连接次数、网络切换频率和失败现象,而不是只看某一时刻的电池百分比。长时间诊断记录也应在测试结束后恢复日常状态。

建议只设置能够清楚说明用途的条件,并保留关闭后手动连接的恢复办法。出现无法解释的重复触发时,先暂停 On Demand,确认手动连接是否正常;如果手动也失败,就转向服务器、DNS 或规则排查。手动正常而自动异常,再逐条恢复条件,找出最小复现组合。不要通过删除全部网络数据来代替这一步,否则可能失去判断依据。

最终验收应包括主动断开后的预期行为、网络变化后的触发行为,以及实际请求是否采用正确策略。若只是希望快速操作连接,不一定需要自动触发,可参阅后文的 Widget。若希望请求按目标分流,则应调整 Config,而不是扩大 On Demand 条件。把“何时连接”与“连接后怎样处理请求”分开,能让设置更容易维护,也能减少误把规则问题当成连接触发问题的情况。

[Connectivity Test]

五、Ping 与连通性测试

先确认测试究竟测了什么

Ping、Connectivity Test 与实际网页访问不是同一件事。不同测试方式可能只检查主机是否响应、某个端口能否建立连接,或某个请求能否通过指定路径完成。看到一个较小的时间值,只能说明该次测试所覆盖的环节响应较快,不能直接代表所有网站的访问速度。排查前应先核对当前选择的测试方式、目标以及是否经过所选服务器,不要只比较列表里的数字。

有些网络不会响应某类探测,但实际应用请求仍能完成;也可能服务器地址可以建立连接,认证或后续传输却失败。因此,单项测试失败不应立刻成为删除服务器的理由,单项通过也不能替代实际访问。推荐把测试分成三个层次:底层网络是否可用、服务器连接是否成立、目标应用请求是否完成,并分别记录结果,避免用一个“超时”概括全部现象。

测试方式、目标与等待时间

如果当前界面允许选择 Ping 或其他测试方式,先保留现有或默认选择作为基线,并查看其说明。需要调整时应保证目标固定,且自己能够理解测试含义。测试地址应选用稳定、允许访问且与使用场景相关的目标;不要把需要登录、频繁跳转或可能限制探测的页面当成所有服务器的统一标准。某个目标不可达,可能只是该目标的响应策略或临时状态。

超时阈值应结合实际网络,而不是一味缩短。等待时间太短,会把较慢但可用的连接判为失败;过长则会延迟发现问题。界面若没有明确需求,推荐保持当前默认,不填写没有依据的统一数值。若确需改变,应记录原值,并观察多次测试结果分布。一次很快或一次很慢都可能受无线信号、移动网络切换与并发任务影响,不能作为长期结论。

测试层次可以支持的判断不能直接推出
主机或端口响应某条基础路径当前有响应认证正确、目标网站可用
经服务器完成请求该服务器与该目标的组合可用所有目标和协议均正常
实际应用操作当前场景的访问结果其他网络下表现相同

怎样做有意义的对照

比较已有服务器时,应固定设备、网络、测试目标和方式,关闭不必要的并发大流量任务,再进行数次间隔测试。不要一边切换无线网络,一边比较结果;也不要把不同测试方式得到的数值放在同一标准下排序。对于会自动选择策略的配置,还要确认每次测试实际使用了相同路径,否则表面上比较同一项目,背后可能已经换了处理方式。

若测试通过但应用访问失败,下一步应查看应用目标与规则命中,而不是继续重复测速。若只有某个协议配置失败,应核对该协议的认证、传输与 TLS 条件。协议名称相同也不意味着字段可以互换;例如服务器主机名、用于 TLS 的名称与实际连接地址可能承担不同作用。需要辨认已有配置类型时,可读Shadowrocket 支持的协议说明。

从测试结果回到实际使用

批量测试会产生额外请求,频繁执行不一定提高判断质量。日常只需在出现现象时选取少量相关项目测试,并结合日志定位。若测试目标本身出现故障,应更换目标后重新比较,而不是把整份订阅判定为不可用。已有订阅更新成功仅表示取得了内容,不表示其中每条服务器信息都能在当前网络下工作,更新与连通性验证应作为两个独立步骤。

完成测试后,恢复日常使用的服务器与 Global Routing,防止把临时对照状态留在后台。对于长期反复的问题,记录发生网络、测试方式、错误类型与实际失败操作,比保存一张只有延迟数字的图片更有帮助。最后以能够重复完成的真实操作验收,例如打开同一页面并完成必要交互;若只有测试按钮通过而业务仍失败,应继续查 Log 与规则,不应把问题视为已解决。

[Log]

六、Log、Data 与故障定位

日志用于重建请求过程

Log 的价值在于说明一次失败发生在哪个环节,而不是让记录越多越好。诊断前先写清可复现的操作:当前网络、所选配置、服务器、Global Routing,以及哪个目标无法访问。然后在当前界面可用的日志入口查看或开启所需记录,再执行一次相关操作。不要在大量无关请求持续产生时寻找单条失败记录,尤其不要同时打开多个应用制造难以辨认的背景活动。

日志字段会随记录类型与平台而变化,阅读时应围绕目标名称、目标地址、匹配策略、连接状态与错误文本展开。先确认这条记录是否对应当前测试,再解释内容。时间相近不一定就是同一个请求,页面也可能同时调用多个接口。某条失败记录不必然导致整个页面失败,某条成功记录也不代表页面所有资源均已完成;需要结合用户实际看到的现象判断。

按环节处理,而不是按关键词猜测

名称查询相关错误优先检查 DNS 与网络条件;建立连接超时要核对目标地址、端口和处理路径;认证失败应回到已有服务器信息;TLS 相关错误则需要核对系统时间、名称与证书条件。错误文本只是线索,不能直接推出唯一原因。例如超时既可能发生在本地到服务器之间,也可能发生在后续目标连接上,应结合前后记录判断位置,而不是看到“超时”就更换全部设置。

对于 Trojan 等包含 TLS 条件的配置,应依据用户已有的服务器资料核对密码、SNI 与相关选项。不要把 Allow Insecure 当作通用修复开关;跳过校验会改变连接的安全边界,也可能掩盖名称填错或服务端配置问题。字段作用可参阅Trojan 参数逐项说明。日志应帮助回到正确字段,而不是推动与故障无关的放宽设置。

线索下一步保留的信息
名称查询失败检查 DNS 与当前网络查询目标和错误原文
规则结果不符检查 Config 与规则顺序命中条目和实际策略
认证或 TLS 失败逐项核对服务器资料协议类型和相关错误
连接中途断开比较网络切换与断开时序发生条件和重现步骤

Data 统计不等于线路计费

Data 中显示的流量或连接统计,应按当前界面标注的范围理解。统计可能对应某个时间段、某次连接或应用记录,不能直接等同于服务商账户中的使用量。隧道封装、重试、统计起止时间与服务端口径,都可能造成差异。若数值看似异常,应先核对统计范围及是否曾清零,再检查后台活动,不要仅凭一个累计值判断某个目标产生了全部流量。

需要做前后对照时,先记录初始读数,再执行单一操作并观察变化。如果选择清除本地统计,应确认不会丢失仍需保留的诊断依据。不要为了让数字看起来正常而不断清零;这样会破坏排查所需的时间关系。对于疑似持续产生请求的情况,可以暂时减少其他应用活动,并比较连接停止前后的变化,但仍需结合实际请求记录才能确定来源。

诊断记录的隐私与保存

日志可能包含访问域名、服务器地址、局域网地址、订阅信息或请求参数。分享前应先复制必要片段,移除认证字段、完整订阅链接及能识别个人账户的内容,同时保留错误类型与必要上下文。只把敏感文本涂掉一部分可能仍可还原结构;更稳妥的是用明确的示例值替换,并注明已替换,避免他人误把示例当成真实连接信息。

诊断结束后,将日志详细程度恢复到日常需要的状态,按实际需要清理本地记录。长期保留大量详细日志会增加存储占用,也会扩大需要保护的信息范围。若问题仍未解决,整理一份最小复现说明:修改前后状态、单次操作、对应错误与已经排除的分支,再到常见问题对照。这样的材料比整包未经筛选的记录更容易阅读,也更不容易遗漏关键条件。

[iCloud]

七、iCloud、备份与 Widget

同步、备份与导出各有用途

iCloud 同步用于在符合条件的设备之间传递应用支持的数据,备份用于保留可恢复的状态,导出则用于取得明确的文件副本。这三者不能直接互相替代。同步中的删除或修改也可能传播,因此“另一台设备能看到”不等于已经保存了一份独立历史备份。重要调整前应保留可识别的本地副本,并确认其中究竟包含哪些内容,而不是只确认某个同步开关已打开。

本章的 iCloud 说明适用于具备该功能及对应系统条件的设备,不意味着所有平台共享同一种同步机制。首次设置时,先核对系统账户、iCloud 可用状态、网络与剩余空间,再检查应用中实际提供的同步项目。默认是否启用应以当前设备为准,尤其是旧设备迁移或重新登录账户后。推荐在确认数据范围后再启用,并先用一项可识别的非敏感修改验证传递过程。

哪些内容需要另外保留

配置文件通常承载规则与相关设置,但不应默认一份导出文件包含全部服务器、订阅、应用偏好与系统授权。导出前查看当前界面说明,导出后检查实际内容;涉及认证信息的文件需要妥善保存,不要放进公开目录或公开分享。若文件只有规则,在新设备上仍可能需要重新取得用户已有的订阅或服务器资料,不能把导入成功等同于已经完成全部恢复。

已有订阅的更新地址也需要保护。它可能带有账户识别信息,能够访问该地址的人可能取得对应配置。备份时应把配置副本与订阅来源记录清楚,并避免把真实链接粘贴到公开反馈中。若只是讲解格式,使用示例值即可;恢复时则应从自己的受保护记录中取回真实内容。本站仅说明导入与保存方法,不提供任何订阅或服务器资料。

多设备修改与恢复验证

两台设备同时编辑同一份配置时,可能出现内容覆盖、时间差或冲突副本。遇到这种情况,先停止并行编辑,分别保存两边当前内容,再选择一份作为基准逐项合并。不要只根据文件名相同就判断内容一致,也不要连续开关同步希望自动修复冲突。先确认哪份规则、服务器引用和备注需要保留,能减少误覆盖后无法恢复的风险。

换机时建议先在旧设备完成独立导出,再在新设备确认同步或导入结果,最后验证连接。依次检查服务器列表、订阅更新、当前 Config、Global Routing、On Demand 与必要的系统权限。某些系统授权需要在新设备重新确认,不能通过复制文件代替。详细顺序见配置备份与换机恢复,完成验证前不要急于清除旧设备上的数据。

Widget 的状态与操作边界

Widget 用于在系统允许的位置展示或快速操作应用支持的项目。它是辅助入口,不是独立的连接引擎,也不负责替代 Home 中的服务器选择与 Config 检查。可显示内容、刷新时机与操作能力受系统和当前界面支持范围影响。若状态没有立即变化,应打开 Shadowrocket 查看实际连接,再判断是否只是 Widget 显示尚未刷新,不要仅依据桌面上的文字推断连接已停止。

添加 Widget 后先做一次受控验证:记录应用内状态,使用 Widget 提供的操作,再回到应用核对结果并访问测试目标。若同时启用了 On Demand,手动断开后可能再次满足触发条件,因此看似 Widget 操作没有保持,实际可能是自动连接重新生效。此时应先检查按需条件,而不是重复删除并添加 Widget。两者分别负责快速操作与条件触发,作用不同。

不需要快捷入口时可以不添加 Widget,这不会改变规则本身。若其中展示了不适合旁人看到的服务器名称或状态,应调整显示内容或放置位置。日常维护建议是减少重复的自动化入口,让连接控制方式保持清楚:应用内操作用于核对,Widget 用于便捷访问,On Demand 用于按条件触发。每种入口都应有明确用途,避免多个控制来源叠加后难以解释最终状态。

[Proxy]

八、Proxy 端口与局域网边界

本地端口不是服务器端口

Proxy 相关端口描述本机向其他应用提供代理服务时使用的监听入口,与 Add Server 中远端服务器的连接端口不是同一概念。修改本地端口不会修复远端认证或传输参数,修改远端端口也不会自动改变本机应用的代理设置。排查前先确认请求从哪里发起、连接哪个地址和端口,以及该入口接受哪种协议;把三个信息写完整,比只记住一个端口数字更可靠。

并非所有平台都提供相同的本地监听项目,名称与位置应以实际界面为准。HTTP 与 SOCKS5 入口不能仅因端口相近就互换;使用方填写的代理类型必须与监听方匹配。默认端口应查看当前 Settings,不在本页指定一个所有设备通用的数值。若日常只使用设备内的连接方式,且没有其他应用需要显式代理,推荐先保持相关设置原状,不为排错而额外开启网络入口。

地址范围决定谁能访问

只在本机使用与允许局域网设备访问,是不同的安全边界。回环地址用于本机通信,局域网地址用于网络中的设备互联;监听到更广的地址范围可能让同一网络上的其他设备接触该服务。若界面提供允许局域网访问的选项,启用前应明确使用者与网络环境,并检查系统防火墙及应用支持的访问控制。连接了同一个无线网络,不代表所有设备都应获得访问权限。

推荐优先限制在实际需要的最小范围。确需给自己的另一台设备使用时,先确认双方处于允许互通的网络,记录提供服务设备的当前局域网地址,再在使用方填写正确协议和端口。不要把该地址误写成远端服务器地址,也不要把回环地址填到另一台设备上;对另一台设备而言,回环地址指向它自己,并不会指向运行 Shadowrocket 的设备。

端口冲突与代理循环

若监听无法启动,可能是端口已被其他进程占用、地址不可用或系统权限不满足。先查看当前错误与本机已有服务,再决定是否换端口。更换后必须同步修改所有使用该入口的应用,否则它们仍会连接旧端口。不要通过连续尝试大量端口来代替定位,也不要关闭不认识的系统服务;先确认冲突对象和用途,才能避免影响其他正常功能。

显式代理设置还可能形成循环:某个请求被送到本地入口,而配置又把该入口相关连接送回同一条处理链。表现可能是连接反复出现、请求不完成或资源使用异常。遇到这种情况,应先撤销最近新增的使用方代理设置,恢复单一连接路径,再逐层加入需要的环节。不要同时启用多处系统代理、应用代理与局域网转发后再猜测请求经过哪里。

检查点推荐基线失败时优先处理
监听地址仅开放实际需要的范围确认本机与局域网地址区别
代理类型使用方与监听入口一致核对 HTTP 或 SOCKS5
监听端口保留可用现值,避免冲突核对占用与使用方填写值
连接路径每一层去向明确撤销新增环节,排除循环

远程解析与使用方差异

某个应用是否通过代理解析域名,还与使用方的实现和代理类型有关。不能只在 Shadowrocket 修改 DNS,就认定所有显式代理应用都会采用相同解析路径。若本机应用正常,而局域网中的使用方失败,应分别检查使用方是否先自行解析、网络是否允许设备互通、监听是否启动,以及目标请求是否出现在日志中。日志完全没有对应请求时,应先查入口路径,而不是改远端服务器。

移动设备的网络地址、后台条件和连接状态可能变化,因此不应把临时可用的局域网入口当成永久固定服务。网络切换后先核对新地址与当前连接,再测试使用方。完成临时任务后,关闭不再需要的局域网访问,并移除使用方遗留的代理设置,防止后续连接到不存在的入口。对不受信任的网络,尤其不应开放超出需求的访问范围。

全页设置回查顺序

最终回查按依赖顺序进行:先确认底层网络与已有服务器资料,再核对 Config、Global Routing 和 DNS,之后检查 On Demand,最后验证 Widget 或本地 Proxy 等辅助入口。每一步都用相同目标记录结果,失败时回到最近一次有效状态。若需要重新获取客户端或查看系统放行步骤,请使用下载页的安装说明;若只是日常操作不熟悉,回到快速上手即可,不必重置全部设置。