OFFICIAL MANUAL / SETTINGS

Shadowrocket 设置参考

从设置的作用范围开始,依次查阅 DNS、On Demand、Global Routing、连接测试、日志、同步与本地端口。

本页是 Shadowrocket 官方手册的系统查阅部分,适合已经导入自己的订阅或服务器信息、需要判断某个选项是否应当修改的用户。第一次连接请先读入门指南,按导入、选择模式、连接和验证的主线完成操作;遇到具体设置疑问,再回到本页对应章节。两页分工不同,不需要在首次使用前修改全部选项。

Shadowrocket 支持 iPhone、iPad、Mac、Windows、安卓和 Linux;本文以 iPhone / iPad 的常见界面词组织查阅,其他平台以实际可见选项为准,不把系统专属能力视为跨平台一致。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。客户端一次性买断 ≠ 线路套餐。本站不提供、不销售、不推荐节点或订阅。

SETTINGS / SCOPE

设置范围、初始状态与推荐基线

先分清设置保存在哪里

同一个连接结果可能同时受 Settings、当前 Config、所选服务器以及系统网络状态影响。Settings 中的偏好不等于配置文件中的指令,订阅条目的参数也不等于全局开关。例如服务器地址和认证信息属于连接条目,规则匹配属于当前配置,而系统是否允许建立 VPN 连接属于系统权限。排查前先写下正在编辑的层级,避免在错误的位置反复调整,也避免把一次导入带来的变化误认为应用自动改变了全部设置。

本文的“初始状态”指首次打开或尚未主动修改时实际显示的值,不把推荐值写成固定出厂值。不同系统、导入的配置和既有同步数据都可能使当前状态不同;升级后也可能沿用原来的选择。遇到无法确认的默认值,应先截图记录本机当前值,再查看正在使用的 Config 是否声明了对应参数。不要仅凭选项名称相似,就认定界面设置与配置文件必然有统一覆盖顺序。

建立能够恢复的最小基线

开始修改前,保存当前配置副本,记录 Global Routing、所选服务器、连接开关和当前网络。已有订阅链接、密码与密钥应存入自己控制的安全位置,不放进用于交流的截图。先保留能够正常连接的条目,只在副本中验证新规则;如果原本就不能连接,则保留原始状态作为比较起点。备份的意义是能恢复具体输入,而不是只记住“之前大概打开了哪些选项”。

推荐基线是:使用已确认有效的服务器信息,暂不添加不清楚用途的高级参数,保持单一可解释的 Config,先在稳定网络下手动连接。DNS 可以先观察系统解析是否正常,On Demand 暂不加入复杂条件,日志只在排查时开启到足够级别。这些是便于定位问题的操作建议,不是声称所有设备具有相同默认值,也不是要求长期关闭已经验证有效的功能。

作用层级典型内容修改前记录
连接条目地址、端口、协议、认证参数原条目副本与服务端要求
ConfigGeneral、Rule、Host当前生效文件及规则顺序
Settings测试、日志、同步等偏好当前选项与实际可见说明
系统VPN 权限、网络、云端账户网络类型与权限状态

一次只改变一个可验证因素

一次实验只改一个变量,并为它指定成功条件。例如修改 DNS 后,检查原先失败的域名是否能够解析,而不是只看连接开关是否仍然开启。每次测试使用相同目标、相同网络和相同服务器,记录结果后再决定是否保留。若同时换服务器、改路由模式、换解析器,即使恢复访问,也无法知道真正起作用的修改是什么,之后遇到相似故障就难以复现。

界面位置与系统能力可能不同。如果手册提到的选项在设备上不存在,不要用其他名称相近的选项代替,更不要向配置中填入未确认的键。先核对所用平台,再检查当前页面是否为 Settings 而不是服务器编辑页。客户端下载与系统放行步骤集中在全平台下载页;设置问题应在安装完成、应用可以正常打开之后处理,不能用网络参数修复安装权限问题。

SETTINGS / DNS

DNS:解析路径与本地映射

先判断失败发生在解析还是连接

DNS 把域名转换为网络地址,但得到地址不表示后续连接一定成功。域名请求失败可能发生在解析阶段,也可能是已得到地址却无法建立连接。应先从 Log 中确认是否存在解析结果,再看连接所用地址、目标端口和策略。如果把所有超时都归因于 DNS,频繁更换解析器只会增加变量;服务器认证失败、目标服务停止响应和规则选错策略,都不会因为更换解析器而自然消失。

需要区分三类名字:浏览器访问的目标域名、代理服务器自身的域名,以及订阅链接的域名。它们可能在不同阶段使用不同网络路径。尤其服务器地址本身使用域名时,建立代理连接之前就可能需要完成解析,不能简单认为“连接后所有解析都经代理”。如果只有服务器域名无法解析,应先检查当前网络和服务商提供的信息,再讨论目标网站的 DNS 行为。

理解 dns-server 与 system

配置中的 dns-server = system 表示使用系统提供的解析来源,不表示预设某一家公共解析服务,也不表示解析一定经过某个指定服务器。系统结果可能随 Wi-Fi、蜂窝网络或网络管理策略变化。作为排查起点,系统解析有利于保留当前网络原有行为;若日志已经表明系统解析异常,再按实际需要设置受信任且当前网络可达的解析来源,并比较同一域名的结果。

[General]
dns-server = system

[Host]
localhost = 127.0.0.1

这个片段只演示段名与参数,不是完整网络方案。将它加入已有 Config 前,先查找是否已经存在同名段和重复键,避免在文件尾部重复追加后误判实际生效内容。设置了其他解析方式时,要核对应用当前支持的地址格式、传输方式以及该解析服务的说明。不要把普通域名、完整网页地址和解析服务器地址混为一谈,也不要为了试验同时填写一长串来源。

Host、缓存与 IPv6 的边界

Host 映射用于显式指定名称对应的地址;它不会修复目标服务器证书,也不会改变应用层认证。示例中的 localhost 是本地回环名称,不应改成代理服务器地址。若曾经为某个域名写过固定映射,目标迁移后旧地址仍可能继续影响访问,因此检查顺序应包括当前 Config 的 Host 段。删除映射前先保存副本,避免把用户有意设置的内网名称一并清除。

缓存会使连续测试看起来矛盾。应用、系统和目标程序都可能保留先前结果,修改后应按当前平台可用方式刷新相关缓存,或退出目标程序并重建请求,再查看新产生的记录。不要仅靠重复刷新同一个页面判断设置是否生效。涉及 IPv6 时,还要确认网络是否具备有效的 IPv6 连通性;解析出 IPv6 地址与能通过该地址完成连接,是两个独立条件。

观察到的现象优先检查下一步
没有解析结果解析来源与网络可达性换同一网络下的对照域名
有地址但连接超时策略、目标端口与地址族检查对应连接记录
仅个别域名异常Host、缓存与精确规则撤回对应单项修改

推荐取值应以能够解释和验证为准:系统解析正常就先保留,确有需求才增加自定义解析配置。初始值以本机当前 Config 与 Settings 为准,不承诺所有平台一致。验证时记录域名、解析结果、时间和网络环境;分享结果时遮盖内部域名和服务器信息。若解析成功但仍无法访问,应转到本页的路由和日志章节继续检查,而不是继续堆叠 DNS 参数。

SETTINGS / ON DEMAND

On Demand:条件连接与手动断开

按需连接与规则分流不是同一层

On Demand 用于依据系统支持的网络条件触发连接行为;Rule 用于连接中的请求应该采用什么策略。前者回答“何时建立连接”,后者回答“连接后怎样处理请求”。因此,打开 On Demand 并不等于所有请求都走代理,关闭它也不等于配置中的规则被删除。排查时应把连接状态和流量策略分开观察,否则容易把按需重新连接误判为规则失效,或把直连规则误判为没有建立 VPN。

On Demand 的实际条件、入口和可用程度受平台影响。本文主要说明 iPhone / iPad 上的使用逻辑,不将某个系统的条件列表写成所有设备都具备的固定功能。初始状态以设备当前显示为准;旧的系统 VPN 配置、同步恢复或之前的手动修改都可能影响观察结果。首次配置前先关闭自动触发,确认手动连接、断开以及目标访问都符合预期,再逐步加入条件。

先写出需要的网络行为

设置前用一句话描述目标,例如“在指定 Wi-Fi 下不自动连接,切换到其他网络时按既定条件连接”。然后把每种实际网络列出来,包括家中 Wi-Fi、单位 Wi-Fi、蜂窝网络以及需要网页认证的网络。只配置能明确识别且确实需要区分的条件,不要把名称相似的无线网络当作同一个网络,也不要把 Wi-Fi 名称当作可信身份凭据。

逐项设置时,先保存一条条件并做网络切换测试,再增加下一条。测试应等待系统完成网络交接,而不是在信号尚未稳定时连续点击连接开关。记录切换前后的网络、应用中的连接状态和系统 VPN 状态;三者共同判断结果比只看状态栏图标更可靠。如果两个条件可能重叠,应按实际界面说明确认优先关系,不能假定它一定采用与 Rule 相同的匹配顺序。

解释“刚断开又连接”

手动断开后很快重新连接,首先检查 On Demand 是否仍在满足条件。系统按条件重新建立连接,与按钮失灵是不同现象。准备长时间断开、排查其他 VPN 或处理网络认证前,可以先停用按需触发,再断开连接,确认系统状态随之变化。完成操作后按需要恢复原条件;不要只反复点击开关,因为每次重新触发都会覆盖对故障时序的观察。

网页认证网络需要单独考虑。接入 Wi-Fi 不代表已经获得正常网络访问能力,可能还要在系统弹出的页面中完成认证。在认证完成前自动连接可能失败,也可能令认证入口不易观察。遇到这种情况,应先停用自动触发、完成该网络的必要认证并验证普通网络访问,再手动连接。不要用改 DNS、改规则和连续重试来替代网络本身要求的认证步骤。

与系统权限、休眠恢复一起复核

应用获得系统 VPN 授权后,仍可能受到设备管理策略或其他网络工具的影响。若系统拒绝连接,应查看系统提示和已安装的 VPN 配置,确认是否存在冲突,而不是在应用里寻找不存在的规则例外。受管理设备的限制应由设备管理方处理,不应通过删除不明系统配置来试错。也不要把桌面系统的后台运行选项照搬到 iPhone / iPad 的 On Demand 中。

完成配置后,至少检查一次锁屏再解锁、Wi-Fi 与蜂窝切换、手动断开和重新连接。若只在恢复网络时异常,保留发生时间并查看同一时段日志,区分网络尚未就绪、解析失败和连接被拒绝。推荐长期保留的不是最多的条件,而是已验证、能说明用途的条件集合。需要重新走通基本操作时,可返回入门指南,先恢复手动连接主线。

CONFIG / GLOBAL ROUTING

Global Routing 与 Config 的生效关系

先确认当前姿态,再解释规则结果

Global Routing 的常用三姿态为配置 Config、代理 Proxy、直连 Direct。Config 按当前配置处理请求,适合需要分流的日常使用;Proxy 用于以代理方向进行整体对照;Direct 用于直连方向的对照。它们首先是路由行为选择,不是服务器协议,也不是网络测速等级。看到访问结果与预想不同,应先确认当前姿态,不能只盯着 Config 中某条规则判断应用是否执行错误。

姿态查阅重点常见用途
配置 Config当前文件、策略名称与命中顺序验证按规则分流
代理 Proxy所选服务器与代理方向连通性隔离部分规则因素
直连 Direct当前网络的直接访问能力建立直连对照结果

初始姿态不应凭记忆推断,尤其换设备或恢复数据后,应直接查看 Home 中的当前选择。推荐在已确认服务器有效后使用 Config,并保留一个结构清楚的配置;临时使用 Proxy 或 Direct 做对照后,要恢复原来的日常选择。若界面还提供 Scene 等入口,应按该入口的实际功能另行核对,不把它和本文的三姿态测试混成同一个开关。

Rule 从上到下匹配

在 Config 下,规则按顺序匹配,先命中的规则决定相应请求的策略。因此,较精确的 DOMAIN、DOMAIN-SUFFIX 通常放在较宽的兜底规则之前,FINAL 放在末尾。规则里的策略名称必须在当前配置中具有实际含义;下方 PROXY 仅表示需要关联的代理策略示例,不能因为复制了这个单词就认为服务器已经建立。使用示例前,应核对自己的配置结构与策略名称。

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

这段展示域名后缀、域名关键词、地址网段、地理归属与最终规则的排列关系,不是适合所有人的完整配置。DOMAIN-SUFFIX 针对相应域名及其子域名,DOMAIN-KEYWORD 的范围更宽,容易影响名称中包含该片段的其他域名。IP-CIDR 针对地址网段,GEOIP 依赖可用的归属数据;它们不能简单替代按业务域名编写的精确规则,也不能保证某项服务始终使用相同地址。

修改规则后验证新请求

配置保存与配置选中是两回事。编辑了一个文件后,应确认它正是当前使用的 Config,再按界面要求重新加载或重建连接。已经存在的长连接不一定立刻按新规则重新选择路径,验证时应关闭目标应用的旧连接并产生新请求,再从日志中核对目标与策略。只看到网页仍然打开,不足以证明新规则已经命中,因为页面可能来自缓存或沿用原连接。

若同一应用部分内容正常、部分异常,通常需要分别检查它请求的域名,而不是给应用名称写一条想象中的通用规则。登录、图片、接口和媒体内容可能来自不同目标。先从日志找到失败请求,再选择足够精确的匹配方式;不要为了修复一个域名就添加过宽关键词。USER-AGENT 等匹配也有适用前提,不能假定每一种流量都能提供可用于匹配的相同信息。

推荐的回退方式是切回保存的 Config,而不是在文件底部继续追加相反规则。需要理解 General、Rule 与 Host 的完整结构,可读配置文件分段说明。当 Proxy 对照能够访问、Config 不能访问时,优先检查命中策略;两者都失败时,再检查服务器和网络。这样的顺序能把规则问题与连接问题分开,减少重复修改。

TOOLS / CONNECTIVITY TEST

Ping 与 Connectivity Test 的读数

测试结果只回答对应的问题

Ping 在不同测试方式下测量的对象并不相同。某种方式可能只检查主机或端口是否响应,另一种方式可能包含协议握手或测试请求。先查看当前测试方式的实际说明,再解释时间和失败状态,不把所有读数都当作访问网页的完整耗时。主机能够响应并不能证明认证参数正确,代理握手成功也不能证明某个具体目标的业务接口一定可用。

Connectivity Test 用于验证特定测试条件下的连通性。测试地址、超时时间、所选服务器、DNS 和当前网络都会影响结果。初始测试方式与地址以当前设备显示为准,本文不指定未经核对的统一默认网址。推荐先保留现有可解释的设置,选用自己确认稳定、响应简单的测试目标;遇到失败时记录错误类型,而不是仅把红色或空白状态理解为服务器永久失效。

延迟、吞吐和稳定性分开看

延迟是一次往返或一次操作耗时,吞吐量是持续传输能力,稳定性则需要多次观察。一次较低读数不代表下载一定更快,一次超时也不代表之后所有请求都会失败。小请求容易受网络瞬时排队、设备休眠恢复和域名缓存影响。比较服务器时,应尽量使用相同测试方式、相同目标和相近时间窗口,避免把不同条件下的结果放在一起排序后得出长期结论。

超时时间太短会把暂时较慢的有效连接判为失败,太长又会拖慢故障定位。推荐先使用当前合理设置,只有在日志表明握手经常接近超时边界时再调整,并记录调整前后的完成率。不要通过无限延长超时来掩盖持续拒绝连接或认证错误。测试间隔同样需要克制,连续密集测试会改变设备和网络负载,还可能令服务端限制影响后续结果。

测试现象可能说明不能直接推出
主机有响应对应探测路径可达代理认证与目标访问正常
握手失败协议或连接阶段异常一定是 DNS 故障
测试请求成功该目标在当时可达全部网站与应用均正常
偶发超时存在瞬时失败服务器已长期不可用

把测试拆成可以定位的阶段

先检查当前网络能否正常使用,再确认订阅条目中的地址、端口和协议是否与服务商提供的信息一致。随后检查服务器域名能否解析、连接能否建立、认证是否通过,最后才测试目标请求。每一步都使用相应记录确认,不要跳过认证阶段直接更改分流规则。对于需要额外传输或安全参数的协议,应逐项核对服务端要求,不凭另一个条目的参数进行套用。

出现“测试成功但应用打不开”时,应回到实际应用产生的请求。测试目标可能走了另一条规则,也可能只访问了一个轻量地址,而实际应用还需要多个域名。检查 Global Routing 和命中策略,并在 Log 中查看失败目标。反过来,测试地址本身不可达时,实际业务仍可能正常,此时应修正测试目标,而不是删除已经验证可用的服务器信息。

如果所有条目同时失败,优先检查共同因素:当前网络、系统 VPN 权限、测试目标和 DNS。只有某一条失败时,再核对该条目的输入与服务端状态。不要把列表排序当作自动修复,也不要在结果波动时反复更新订阅覆盖现场。常见错误的短问短答见常见问题;本页日志章节说明如何把测试结果与具体连接过程对应起来。

SETTINGS / LOG AND DATA

Log 与 Data:定位请求而不是堆积记录

在复现前准备日志范围

Log 的价值在于把一次失败放回具体时序,而不是记录越多越好。开启前先写下需要确认的问题,例如“域名是否解析”“命中哪条规则”“握手在哪一步失败”。不同平台和界面提供的记录级别可能不同,默认级别以当前设置为准。推荐使用能够回答问题的最低必要级别,仅在普通记录信息不足时临时提高详细程度,完成排查后恢复原来的日常设置。

复现前记录当前时间、网络类型、Global Routing、Config 名称以及所选服务器的本地备注。若已有日志过多,可以在确认不需要保留后清理,再执行一次最小操作,例如只打开一个失败页面。不要同时启动多个应用、运行测速并更新订阅,否则产生的大量请求会混在一起,使同一秒内的失败难以对应。设备时间不准确时,也应先校正时间再比较记录。

按解析、策略、连接的顺序阅读

阅读时先找到目标域名或地址,再看是否有解析结果,然后确认实际策略,最后检查连接和认证结果。若目标根本没有出现在记录里,可能是请求没有产生、目标程序使用了缓存,或者当前记录范围没有覆盖它;不能直接认定客户端丢弃了请求。应退出目标程序、重建连接并重新复现,再核对系统 VPN 状态与应用开关是否一致。

出现超时,应确定超时发生在解析、建立连接还是等待目标响应;出现拒绝连接,应核对目标端口和服务端监听;出现认证或安全握手错误,应检查协议参数、系统时间和服务端要求。错误文本相似并不代表根因相同。不要为了消除提示就随意降低安全校验要求,也不要向外发送包含完整认证上下文的记录,应先提取足以说明失败阶段的最小片段。

Data 统计的含义与限制

Data 中的流量统计可以帮助观察是否确实产生了传输,但不能单独证明某个业务已经成功完成。连接建立、重试、后台刷新和协议开销都可能产生数据。统计范围也要看实际界面说明,不能把应用内部计数直接当作运营商账单,或把一次会话的数字当作从安装开始的累计量。重置统计前应记录时间点,之后只在同一范围内比较变化。

若连接开启但 Data 没有明显增长,先确认目标程序是否真正发起新请求,再检查路由和记录范围。若 Data 持续增长而页面仍失败,则应定位具体失败请求,不能据此判断“连接一定正常”。后台应用、系统服务和自动重试都可能产生传输。关闭无关目标、保留一次最小复现,比长时间盯着总流量数字更容易找到问题所在。

记录内容排查用途分享前处理
目标域名与时间对应实际失败操作遮盖内部名称与查询参数
策略与错误阶段区分规则、解析、连接问题保留必要上下文
服务器与认证信息本地核对输入隐藏地址、密码与密钥
Data 的统计变化确认相同时间段的传输说明统计起点与范围

导出、留存与排查闭环

日志可能包含访问目标、服务器地址、订阅请求和设备环境信息。导出前先在本地检查,隐藏密码、密钥、完整订阅链接及其中的查询参数;只需要错误附近几行时,不应发送完整历史。截图也要检查顶部、侧栏和分享面板中的备注名称。若已经暴露有效凭据,应向自己的服务商处理对应凭据,而不只是删除已经发送的图片。

完成排查后,把结论写成“在什么网络下,哪项设置导致什么阶段失败,撤回后是否恢复”。保存必要片段和已验证配置,清理不再需要的敏感导出,并把临时详细日志恢复。这样下一次出现类似现象时可以沿用判断路径,而不是重复尝试全部选项。只有结论与可重复结果对应,日志才真正完成了诊断任务。

SETTINGS / WIDGET AND ICLOUD

Widget、iCloud 同步与换机恢复

Widget 是快捷入口,不是独立配置

Widget 用于在系统允许的位置提供状态或快捷操作,具体尺寸、按钮和刷新行为以设备实际提供的内容为准。它不是另一套独立服务器,也不是后台始终持续刷新的完整监控页。首次使用应先在应用内完成连接配置,再添加系统提供的 Widget;如果系统没有相应组件入口,不要把其他平台的桌面小组件操作步骤照搬过来。

Widget 显示可能受到系统刷新时机影响。看到状态与预期不一致时,先打开 Shadowrocket 查看真实连接状态,再检查系统 VPN 状态,不要只依据组件上一行文字判断是否断开。通过组件切换后,也要等待系统处理完成再观察结果。On Demand 仍然满足条件时,手动断开后重新连接的原因应按需连接章节排查,而不是删除并反复添加 Widget。

同步前先明确数据范围

iCloud 同步属于 Apple 设备上的相关能力,需要设备允许应用使用对应云端服务。本文不把它描述为所有平台通用的账户同步。初始开关状态、可同步项目与当前设备条件以实际界面为准;开启之前先确认系统云端账户正确、存储空间可用、网络正常。系统登录成功不等于应用数据已经传输完成,也不代表所有本地文件都会自动纳入同步。

应分别核对服务器条目、订阅、Config 和偏好设置是否出现在另一台设备,不凭其中一项出现就认为迁移全部完成。尤其需要区分导出的配置文件和服务器清单:一个文件能够恢复规则,不表示同时包含完整认证信息;一个订阅链接能够重新拉取条目,也不表示会重建所有本地手动修改。先列出自己真正需要保留的内容,再选择同步或导出方式。

同步不是历史备份

同步可能把删除和修改传到其他设备,因此不能代替独立保存的恢复副本。批量整理之前,应导出当前重要配置,并把订阅信息存放到自己控制的安全位置。两台设备同时编辑同一份内容,可能出现覆盖或重复;推荐指定一台作为本次修改来源,等另一台核对完成后再继续编辑。不要在尚未确认同步状态时交替重命名和删除同一批条目。

如果云端没有出现预期数据,先检查同一账户、应用云端权限和网络,再等待合理的同步过程,最后逐项核对内容。不要通过不断关闭开关、退出账户和清空本地数据来催促同步,因为这些操作会改变现场,也可能移除尚未传出的唯一副本。出现冲突时先分别保存两端内容,再比较差异,保留确认有效的一份,而不是仅按设备新旧决定去留。

换机后的验证顺序

新设备先确认应用可以打开,再恢复数据,检查当前 Config、所选服务器和 Global Routing。服务器备注相同不表示参数一定相同,必要时核对地址、端口、协议与服务商要求。首次连接可能需要系统授权,应按系统提示完成;恢复了配置文件并不能替代这一步。不要在尚未测试成功前删除旧设备上的副本,也不要把旧设备的系统权限状态当作会同步的普通偏好。

最后执行一次手动连接、目标访问、断开和网络切换检查,再重新配置 On Demand 与 Widget。若出现重复条目,先确认它们来自手动导入还是订阅更新,避免删除后又被重新生成。完整迁移步骤见备份与换机迁移说明。推荐保留一份已验证的独立配置副本,并记录恢复时所需的信息类别,而不是只依赖云端列表当前看起来完整。

SETTINGS / LOCAL PROXY

Proxy 端口、局域网访问与最终复核

本地监听端口不是服务器端口

Proxy 相关的本地端口用于让本机或获准设备把请求交给客户端处理;Add Server 中填写的端口则是远端服务器接收连接的位置。两者角色不同,不能为了让数字一致而修改。远端端口应与服务商提供的信息对应,本地监听端口应与需要接入的程序保持一致。初始端口值以当前平台实际显示为准,本文不指定所有系统共用的固定数字,也不要求未使用该功能的用户主动开启。

本地端口还要区分接收的代理类型。HTTP 与 SOCKS5 的接入方式不同,目标程序必须选择与监听器一致的类型;把一种端口填到另一种协议的字段里,可能表现为连接成功却无法完成请求。确认类型、监听地址和端口后再测试,不根据选项名称中的 Proxy 就假定它可以接收所有协议。若本机程序根本没有代理设置,应按其实际能力判断,不在 Shadowrocket 中臆造适配选项。

回环地址与局域网地址的差别

回环地址只指向当前设备自身。另一台设备使用自己的回环地址,不会连接到运行 Shadowrocket 的那台设备。确需局域网接入时,需要使用运行端的可达局域网地址,并核对监听范围、系统防火墙以及网络是否允许设备之间通信。不同平台是否提供相关能力以实际选项为准,不能把桌面端的监听方式直接推断到移动设备。

推荐日常只开放确实需要的范围。如果只供本机程序使用,优先限制在本机;需要局域网访问时,应仅在自己理解并控制的网络中启用,按可用选项设置访问限制。不要把监听服务直接暴露到公共网络,也不要为了消除一次连接失败就关闭整套系统防护。无线网络可能启用了设备隔离,即使两台设备连接同一名称的 Wi-Fi,也不一定能够互相访问。

参数类别应该与谁一致常见误区
远端服务器端口自己的服务商配置误改为本地监听端口
本地监听端口接入程序的代理设置端口已被其他程序占用
监听地址本机或局域网接入范围用回环地址连接另一台设备
代理类型HTTP 或 SOCKS5 接收方式只核对数字而忽略类型

按本机、局域网、目标请求分层检查

端口无法使用时,先确认监听功能已经启用、设置已经保存且端口没有被其他程序占用。再从本机发起与协议匹配的测试,确认请求进入 Log;本机成功后才测试另一台设备。远端接入失败而本机正常,优先检查地址、监听范围、防火墙和网络隔离。这样可以避免把局域网连通性问题误判为代理服务器故障,并减少对已经有效的连接条目进行修改。

请求进入客户端后仍然失败,应继续检查 Global Routing、命中规则、解析结果和远端连接,而不是继续换本地端口。端口只负责接收入口,不保证后续每个阶段都成功。特别要避免循环:如果系统代理指向本地监听器,而某个上游设置又把请求送回同一入口,就可能重复转发或失败。添加系统级代理前先画清请求方向,保留能够撤回的原设置。

用一次闭环结束设置修改

完成调整后,按固定顺序复核:确认当前网络,核对服务器信息,手动连接,检查 DNS 和规则,产生实际请求,再查看 Log 与 Data。最后再恢复需要的 On Demand、Widget 和同步偏好。一次只保留已通过验证的修改,未改善结果的选项应撤回。若只在某个应用失败,保留该应用的目标和错误阶段,不要因为局部现象重写全部配置。

长期维护时,把设置记录写成用途与验证方法,而不只是开关清单:为什么指定解析来源、哪条规则需要优先、哪个本地程序使用监听端口、迁移后需要检查什么。遇到新现象先回到对应层级,再查常见问题或新手十问十答。这份参考的目标是让每个保留下来的设置都有明确作用、可观察结果和可执行的恢复路径。