01 · Add Server / Subscribe
打开 Shadowrocket,进入 Home。先判断手中资料是哪一种:能一次获取多条服务器记录的完整链接属于订阅;单独给出的地址、端口、密码或其他认证字段属于服务器信息。这两种资料的录入方式不同,不要把订阅链接当作服务器地址,也不要把服务商的账户管理页面地址填进订阅入口。
已有订阅链接:选择 Subscribe
在 Home 点击右上角加号,进入 Add Server,打开 Type 并选择 Subscribe。返回填写页面后,把从你的服务商处获取的完整订阅链接粘贴到 URL。若页面提供备注字段,可以写一个便于自己识别的名称;备注只影响列表辨认,不改变链接的内容。检查完成后,点击右上角 Done 保存,并等待订阅获取结束。
粘贴后先核对链接的开头与结尾,尤其是问号后面的参数。有些链接包含身份凭据,少复制一段、把换行或空格一起带入,均可能导致获取失败。链接应来自订阅资料中的复制入口,而不是根据网页地址自行拼接。若系统弹出粘贴询问,确认正在把自己的资料填入 Shadowrocket 后再继续。
保存成功后回到 Home,查看订阅分组下是否出现服务器记录。能看到分组名称但没有任何记录,并不代表导入已完成;需要确认此次获取是否报错,以及订阅内容是否包含可识别的服务器。已有同一订阅时优先更新原记录,不必反复新建多个同名分组。更新可能改变列表内容,完成后应重新确认当前选中的服务器。
已有单个服务器信息:按协议填写
同样从加号进入 Add Server,在 Type 中选择资料明确标注的协议,再逐项填写服务器地址、端口与认证字段。不同协议要求的字段不同,例如密码、UUID、加密方式、TLS 与 Server Name 等不能相互替代。按照原始资料填写,不要根据协议名称猜测参数,也不要为了消除报错随意关闭 TLS 或调整证书相关选项。
如果手中已有供导入使用的服务器二维码,可使用 Scan QR Code,并在保存前检查识别出来的协议和地址是否符合原资料。二维码与原始链接具有相同的保密要求。无论通过哪一种方式添加,保存后都应在 Home 点击准备使用的服务器记录,确认选中状态已落在这条记录上,再进入下一步。
本步的完成标志是:Home 中已出现可选择的服务器,而且你已选中其中一条。列表出现不等于服务器一定可连接,后面还需要选择路由模式并做实际验证。Subscribe、协议与配置文件的区别可查阅术语手册。
02 · Global Routing
服务器决定连接使用的目标信息,Global Routing 决定受客户端处理的请求采用什么策略。返回 Home,点击 Global Routing,查看当前选中的姿态。首次操作时不要只关注服务器名称而忽略这里:即使选中了可用服务器,直连模式或配置规则仍可能让某次访问不经过它。
配置(Config):按照当前配置处理
选择配置(Config)时,应用依据当前启用的配置文件匹配规则,再决定请求采用 DIRECT、PROXY 或其他已定义策略。这适合需要规则分流的日常使用,但前提是你知道正在使用哪份配置。切到 Config 页面检查当前启用项;只是把文件导入列表,还需要确认它是否成为当前使用的配置。
初次连接不必立即编辑规则。若无法确定配置来源、策略名称与规则含义,先保留现状,通过下一种姿态验证基础连接。不要把网上看到的几行规则直接追加到未知位置:规则存在顺序关系,配置中使用的策略也必须能正确对应。需要理解 DOMAIN-SUFFIX、GEOIP 或 FINAL 时,再到术语手册逐项查看。
代理(Proxy):先验证代理路径
选择代理(Proxy)后,受客户端接管的连接按代理姿态处理。首次连接可暂时使用这一姿态,减少自定义分流规则对验证的影响。它不是服务器可用性的保证,也不表示所有应用的任何流量都能用一个测试结果概括。选好后返回 Home,确认服务器仍是刚才那条,再进行连接授权。
直连(Direct):不用于证明服务器可用
选择直连(Direct)后,请求按直连姿态处理。它可用于有意识地检查直连行为,但不能作为代理服务器已经生效的证据。如果你的目标是验证刚导入的服务器,就不应停留在这一姿态。需要比较基础网络时,直接关闭连接开关再测试,会更容易区分问题发生在哪一层。
本步只选定一种符合当前目的的姿态。先验证服务器时使用代理(Proxy);验证成功且已确认当前配置时,再切换到配置(Config)。不要同时更换服务器、修改配置和切换姿态,否则失败后难以判断是哪项变化造成的。
03 · Home 连接与系统授权
回到 Home,再看一遍两个位置:服务器列表中已选中预期记录,Global Routing 显示刚才选择的姿态。确认后打开页面顶部的连接开关。首次建立连接时,系统可能询问是否允许 Shadowrocket 添加 VPN 配置;这是应用通过系统网络能力处理连接所需的授权流程,不是导入订阅的操作。
在系统弹窗中核对发起应用为 Shadowrocket,阅读提示后选择允许,并按系统要求通过设备密码、Face ID 或 Touch ID 完成认证。设备密码只在系统认证界面输入,不应填到订阅 URL 或服务器密码字段。如果此次没有授权,先返回应用重新发起连接;仅在服务器列表中选择一条记录不会自动完成系统授权。
授权完成后回到 Home,观察连接开关是否保持开启。如果开关立即回落或出现错误提示,先停在这一步处理,不要把浏览器无法访问直接归因于服务器。可到系统 Settings 的 VPN 相关位置确认对应配置是否存在,并检查设备是否有管理限制,或是否正由另一项 VPN 连接占用。设备受管理时,应遵循相应管理要求。
系统出现 VPN 标识或应用开关保持开启,只能说明连接机制已启动,尚不足以证明目标页面使用了预期策略。不同设备的状态栏显示方式也可能不同,因此应把下一步的实际访问验证作为完成依据,而不是只看一个图标。
首次设置期间先保持 On Demand 的现有状态,不必同时启用自动连接。这样关闭开关后,连接状态更容易观察。等手动连接与断开均符合预期,再单独了解 On Demand 的触发条件;它解决的是何时建立连接,不替代服务器参数、路由模式或配置规则。
04 · Connectivity Test 与实际访问
连接开启后回到 Home,使用 Connectivity Test 对服务器进行测试。测试方法及测试目标可能受应用设置影响,读数应理解为该测试条件下的结果,而不是所有网站的共同表现。出现响应可以作为继续验证的依据;出现超时则需要结合实际访问、当前网络和服务器状态判断,不能仅凭一次结果删除全部配置。
接着打开浏览器,访问一个你平时使用且明确知道应当如何连接的页面。先重新加载,再确认页面的主要内容是否能完成显示。只看到旧页面、缓存文字或此前已经打开的标签页,不足以判断此次连接是否有效。也不必通过要求提供账户或上传订阅资料的网页来验证连接。
随后回到 Shadowrocket,查看 Data 中的流量变化。统计数值用于辅助判断应用是否处理了流量,不能单独证明某个页面一定走了当前服务器:后台应用也可能产生连接,配置(Config)下也可能存在直连请求。如果当前应用提供连接记录,可结合目标域名与匹配策略核对,而不要仅根据总流量增大下结论。
若代理(Proxy)下实际访问符合预期,而切换到配置(Config)后只有部分页面表现不同,优先检查当前配置和匹配规则。此时基础服务器连接可能已经成立,不应从头重复订阅导入。反过来,如果两种姿态下都失败,则应先回到基础网络、所选服务器和认证参数逐层检查。
最后关闭连接开关,确认应用状态随之改变,再按需要重新开启。如果你准备长期使用配置(Config),切换后应重新验证刚才的同一页面,而不是沿用代理(Proxy)时的测试结论。完成标志是连接状态、所选姿态与实际访问结果能够相互对应,不是测试列表里某个数值足够小。
05 · 常见失败点排查
排查时先记录失败发生在哪一步:是链接无法获取、服务器列表为空、开关无法保持开启,还是连接开启后只有部分页面失败。保留错误提示中的关键词,随后每次只修改一个条件,再用同一目标复测。反复删除并重新导入,容易覆盖原始信息,也会让已经查明的条件丢失。
订阅无法导入或更新
先关闭连接,用浏览器检查基础网络是否可用,必要时完成当前 Wi-Fi 的联网认证。然后核对 URL 是否完整、有无前后空格,以及它是否确实是订阅链接而不是账户网页。若提示认证或有效状态异常,应从你的服务商处获取当前有效链接;账户凭据与订阅凭据不一定相同,不能自行互换。
若链接能获取但列表为空,确认返回内容是否为 Shadowrocket 支持的订阅格式,以及该订阅当前是否包含服务器记录。不要通过修改文件后缀或随意替换协议文字来处理格式问题。已有列表且需要刷新时,在原订阅对应的更新操作中重试,完成后再次核对选中项,避免使用已经变更或移除的旧记录。
有服务器记录,但测试超时
先确认 Home 实际选中的是准备测试的那条记录,再核对地址、端口与认证参数。手动添加时尤其要检查 UUID、密码、TLS 和 Server Name 是否与原资料一致。若你已有其他服务器记录,可在保持网络与姿态不变的条件下切换一条做对照;没有其他记录时,不需要为了排查额外寻找资料。
随后分别在 Wi-Fi 和蜂窝网络中复测,留意是否只有某一种网络失败。网络改变后的结果只能帮助定位路径差异,不能自动证明服务端或设备设置完全正常。仅 Connectivity Test 超时而实际页面可用时,先检查测试条件,不必立刻修改服务器参数。
开关立即关闭,或无法完成授权
这一类问题先检查系统授权与 VPN 配置状态。确认系统认证已经完成、当前设备允许添加配置,并暂停可能占用连接的其他 VPN。不要一开始就删除全部订阅或重置所有网络设置;这些操作影响范围较大,而且不一定解决授权限制。有关安装、授权与购买的具体问题可继续查阅常见问题。
连接保持开启,但个别页面失败
重新核对 Global Routing:直连(Direct)不会证明代理路径生效;配置(Config)需要检查命中的规则和对应策略。可以暂时切到代理(Proxy),保持同一服务器和同一页面进行对照。如果只有配置(Config)失败,重点检查配置;如果所有姿态都失败,则继续检查服务器、基础网络以及目标页面自身的状态。
还要留意页面是否只是复用了旧连接,或应用是否需要重新打开后才能建立新请求。DNS、证书和规则问题应根据具体提示分别处理,不要把关闭校验或清空全部设置当成通用步骤。需要解释规则关键字时阅读术语手册;需要重新核对获取入口、商店与已购恢复时阅读App Store 正版指南。
整理问题时记录设备类型、网络类型、Global Routing 姿态、失败步骤与错误关键词即可。分享截图或文本前,遮住完整订阅 URL、二维码、服务器密码及其他认证信息。恢复到最后一次能够正常工作的状态后再继续调整,通常比同时改动多处更容易找到原因。