步骤 01 · Home / Add Server
添加服务器或导入已有订阅
先确认拿到的是订阅链接,还是单个服务器的连接信息。两者都能形成 Home 中可选择的服务器条目,但录入方式不同。订阅通常用于集中更新一组服务器;单个服务器则需要按协议填写各项参数。不要仅凭链接中是否出现某个英文单词判断类型,应以你已有服务的说明为准。
有订阅链接:选择 Subscribe
打开 Shadowrocket,进入 Home,点击右上角加号,进入 Add Server。在 Type 中选择 Subscribe,将完整订阅链接粘贴到 URL,按需填写便于辨认的备注,然后保存。复制时注意不要带入前后的引号、空格或换行,也不要删除链接问号后的参数;这些参数可能是订阅识别所必需的内容。
保存后等待订阅读取完成,再返回 Home 查看结果。正确的检查点是列表中出现了订阅分组及服务器条目,而不只是编辑页关闭。如果只看到订阅名称、没有任何服务器,先检查当前网络是否能访问订阅地址,以及链接是否已失效;暂时不要反复新建同一条订阅,以免后续分不清正在使用哪一组资料。
订阅更新与 VPN 连接是两件事。更新用于读取服务提供方发布的条目变化,并不代表已经选中服务器或建立连接。导入成功后,还需要点击一个服务器条目,使其成为当前选择,之后才进入模式设置与连接步骤。
有单个服务器:按协议填写参数
在 Add Server 的 Type 中选择资料注明的协议,例如 Shadowsocks、VMess、VLESS 或 Trojan,再按界面显示填写地址、端口与认证信息。协议不同,所需字段也不同;不要把一种协议的密码、标识或传输参数套用到另一种协议上。涉及 TLS、服务器名称、路径等字段时,逐项对照原始资料,不靠猜测补齐。
如果已有资料以二维码提供,可使用 Scan QR Code 读取,再检查解析出的协议与关键字段。二维码只是输入方式,不是有效性证明。保存前核对是否漏填内容,保存后返回 Home 选择该服务器。协议名与参数含义不清楚时,可查阅术语手册,但最终取值仍以你的服务器信息为准。
本步完成标志:Home 中存在可选择的服务器,并且已选中准备测试的一项。此时先不要急着打开连接,下一步确认请求将按哪种方式处理。
步骤 02 · Global Routing
选择请求的整体处理姿态
Global Routing 决定整体处理方式,不负责补齐服务器参数。在 Home 点击 Global Routing,核对当前选项。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。首次操作时先记住当前选择,测试过程中只改变这一项,避免把模式差异误认为服务器时好时坏。
配置(Config):按当前配置处理
配置(Config)会依据当前启用的配置决定请求如何处理,规则可能将不同目标交给 DIRECT、PROXY 或其他已定义策略。使用它之前,进入 Config 查看当前使用的文件,确认这就是你准备采用的配置。服务器订阅与 Config 配置文件不是同一种资料:前者主要管理服务器,后者涉及规则及相关设置,导入订阅不等于已经导入一套分流规则。
如果已有可信且理解用途的配置,按其说明启用后再返回 Home。不要为了完成本教程而随意覆盖现有 Config。规则如何匹配、DNS 如何配合属于后续设置内容,可在连接验证完成后阅读设置手册;当前只需确认正在使用哪个文件,以及目标请求预期走哪条路径。
代理(Proxy):检查所选服务器路径
代理(Proxy)适合在首次验证时检查所选服务器承载请求的情况,减少分流规则对判断的影响。它不意味着所有服务一定可达,也不会自动修正认证、TLS 或远端服务器的问题。如果此模式下仍无法正常访问,应先检查服务器和网络,而不是继续叠加规则。完成对照后,是否切回配置(Config),应依据你的实际分流需求决定。
直连(Direct):对照本地网络
直连(Direct)用于按直连路径处理请求,可帮助比较本地网络与代理路径的表现。网页在此模式下能打开,只能说明相应的直连访问可用,不能证明所选服务器已经工作。也不要把直连(Direct)理解为关闭系统 VPN 开关;模式选择与连接开关是两个不同控制项。
本步完成标志:知道当前选中的姿态及其用途。如果选择配置(Config),还应知道当前启用的配置文件。记录这一状态,再进入连接授权步骤。
步骤 03 · Home
打开连接开关并完成系统授权
连接需要系统允许建立 VPN 配置。返回 Home,先核对当前服务器,再确认 Global Routing 与上一步记录一致,然后打开顶部连接开关。首次连接可能出现系统请求,提示允许添加 VPN 配置。核对请求对应 Shadowrocket 后选择允许,并按照系统提示完成密码或设备认证;具体提示形式由设备系统决定。
如果刚才取消了授权,返回应用后重新尝试连接,按系统实际弹出的请求处理。不要因为没有立即看到网页变化就连续开关多次;先观察连接开关是否保持开启,以及是否出现明确的错误提示。若系统仍要求确认,先完成该流程,再回到 Home 检查状态。
测试期间,若另一个 VPN 应用或已有 VPN 配置正在连接,可先断开另一条连接后再试,以免不同连接状态互相干扰。受组织管理的设备可能限制 VPN 配置,此时应核对设备管理要求,而不是重复删除应用。若设备无法完成系统授权,可转到问答页继续检查安装与首次打开相关问题。
系统显示 VPN 状态,表示相应的系统连接已建立或正在使用;这不等于远端服务器认证、域名解析和每一个目标网站都已经验证成功。相反,状态栏未持续显示某个标识时,也不宜仅凭这一点判断失败,应结合应用开关与系统 VPN 状态查看。下一步仍要用实际请求验证。
本步完成标志:已完成所需系统授权,应用连接开关能够保持开启。此时保留当前服务器与模式,不急着更改 DNS、On Demand 或其他高级选项,直接进行一轮固定条件的测试。
步骤 04 · Connectivity Test
分别验证服务器与实际访问
测试结果要分层看:服务器可测、网页可访问、规则符合预期,不是同一个结论。先在 Home 使用 Connectivity Test 检查服务器条目,再选中本次准备使用的服务器。测试方式会影响结果含义;某个数值只反映该测试当时的情况,不能直接当作网页加载速度,也不需要为了追求更小的数字不断换服务器。
随后打开浏览器,访问一个日常使用、已知正常的页面,观察能否完成加载和后续交互。尽量使用新打开的页面,不把已经缓存的文字或图片当作新请求成功。若只有某个应用异常,再用浏览器访问相同服务作对照,从而判断问题是否局限在该应用,而不是立刻更改整套配置。
在配置(Config)下,网页能打开也可能是规则选择了 DIRECT。要验证代理路径,应先了解目标在当前配置中的预期策略,必要时暂时切到代理(Proxy),保持同一服务器、同一网络,再访问同一个目标。对照完成后恢复原本需要的姿态。不要同时切换 Wi-Fi、服务器和模式,否则即使结果发生变化,也难以确定是哪一个条件起作用。
如果 Connectivity Test 有结果但网页无法访问,说明还需要检查实际请求使用的协议、认证、DNS 或目标服务情况;如果测试失败而实际网页正常,也要先确认测试方法及请求是否实际走了代理路径。单项测试不是最终裁定,应把服务器测试、浏览器访问和当前路由选择放在一起判断。
需要进一步确认时,可在应用内查看与本次请求对应的 Log,核对目标、连接错误与处理路径。日志可能包含访问记录和服务器信息,查看后应妥善保管,不直接公开整份内容。如何阅读 DNS 与 Log 可继续查阅DNS 设置参考及设置手册。
本步完成标志:能说明测试用了哪个服务器、哪种 Global Routing、什么网络,以及实际页面是否正常。验证通过后再逐项加入需要的规则或 On Demand 设置,每加入一项就重复同一轮验证。
步骤 05 · 按层检查
从导入结果定位常见失败点
排查从最早没有完成的步骤开始,而不是从重装开始。先判断失败发生在导入、选择、授权还是访问阶段。每次只调整一项,调整后复用刚才相同的服务器、目标页面与测试方法;保留调整前的值,避免失去一个原本可用的基准。
订阅保存了,但列表没有服务器
先检查 URL 是否完整,是否复制了普通网页地址而不是订阅地址,以及链接是否被换行截断。再确认当前网络能够读取该订阅,向你已有的服务提供方核实链接状态和格式。订阅中包含敏感凭据,不应粘贴到公开讨论区,也不要用反复新建订阅来代替检查导入错误。已有可用条目时,先保留它们再处理更新问题。
服务器已出现,但测试与访问都失败
对于手动添加的服务器,返回 Add Server 对应的编辑内容,依次核对协议、地址、端口与认证字段,然后核对 TLS 和传输参数。对于订阅条目,先确认订阅资料是否仍有效,再进行更新。若只有一个条目失败,可在自己已有的其他条目中做对照;若全部失败,则进一步检查本地网络是否正常,以及远端服务是否存在统一故障。
连接开关无法保持开启
先查看是否完成系统 VPN 配置授权,再检查其他 VPN 连接或设备管理限制。确认没有待处理的系统提示后再试。若开关在手动关闭后又自动开启,应检查 On Demand 是否已启用;先暂停自动连接条件,再进行手动测试,避免把自动行为当成开关失灵。不要在不了解后果时删除设备上的其他配置。
连接已开启,只有部分页面异常
先比较代理(Proxy)与配置(Config)的结果。前者正常、后者异常时,重点检查当前 Config、规则顺序与相关 DNS 设置;两者都异常时,再回到服务器及网络检查。还应确认目标服务本身是否正常,避免把单一网站的故障扩大为客户端整体故障。DNS 不应作为固定的第一修改项;只有出现解析相关证据时,才记录原值并进行针对性调整。
提交问题前,整理一份最小复现记录
记录设备系统、导入方式、协议名、Global Routing 选择、使用 Wi-Fi 还是蜂窝网络,以及具体在哪一步出现何种提示。引用 Log 时,仅保留与错误有关的片段,并删除订阅链接、认证信息、密码和其他私人内容。无需公开完整配置或二维码,也不要发送任何可直接使用的服务凭据。
基础连接通过后,本页操作即告完成。常见问题可继续查阅问答,协议和规则关键字查阅术语手册;需要逐项理解 DNS、On Demand、Connectivity Test 与其他设置时,再进入设置手册,不必在首次连接时一次改完所有选项。