官方手册 · 首次设置
Shadowrocket 使用说明
先把已有服务器或订阅导入客户端,再选路由模式、打开连接。最后分别检查服务器测试和实际访问,确认结果符合预期。
在 Add Server 添加服务器或导入订阅
打开 Shadowrocket,在 Home 的 SERVER 区域找到 Add Server。先分清手上的资料:只有一台服务器的地址、端口和认证参数,就走手动添加;拿到的是用于更新一组服务器的订阅链接,就走 Subscribe。两种方法任选其一即可,不必先建一条手动记录再导入订阅。
已有单台服务器:先确定 Type
进入 Add Server 后,点 Type,按资料上注明的协议选择,例如 Shadowsocks 或 Trojan。然后核对 Host 和 Port:地址与端口分别填入各自字段,不要把完整链接贴进 Host。下方字段随 Type 变化,出现 Password 或 Method 时,照已有参数填写;没有提供的可选参数不要套用别的记录。粘贴后检查首尾空格,尤其不要把聊天消息里的引号、句号或换行一起带进去。
如果收到的是明确用于导入服务器的二维码,可从 Scan QR Code 扫描;出现相机权限提示时,再决定是否允许。识别后仍要核对 Type 和地址,不要把扫描成功当成已经连通。手头没有对应的云端数据时,不用点 Import from Cloud JSON。确认后保存,返回 Home,找到刚新增的条目。
已有订阅链接:使用 Subscribe
在 Add Server 的 Type 列表选 Subscribe,将原始订阅链接完整粘贴到链接输入处,再保存。链接如果带查询参数,不要删掉问号后的内容,也不要用聊天软件显示的省略版本。回到 Home,确认订阅分组和其中的服务器条目已经出现;如果只看到分组而没有条目,先按界面提供的更新操作重新获取,再看是否提示错误。订阅地址可能含有访问凭据,遇到错误时记录提示文字即可,不要公开整条链接。
条目出现说明客户端已收到服务器信息,不表示服务器一定可用。先在 SERVER 点选本次要用的那一条;如果导入了多个同名条目,按分组和地址辨认,避免只看名称选错。接下来决定哪些连接应经过这台服务器。
在 Global Routing 选择路由模式
回到 Home,点 Global Routing。这里决定连接怎样分配,并不负责导入服务器。已经有明确的分流配置,就选配置(Config);需要暂时验证所选服务器能否代理普通访问,可用代理(Proxy)做对照;要判断当前网络在不经代理服务器时能否访问,则用直连(Direct)做基线。做对照前,记下原来的选项。
- 配置(Config):由当前启用的配置文件决定匹配结果。同一次浏览中,主站请求与图片、登录接口等其他域名的请求可能走不同路径,这是按连接匹配的结果。
- 代理(Proxy):将由客户端接管的流量按代理模式处理,适合短时间对照。某个站点在此模式下可访问,不等于它在配置(Config)下也一定匹配代理规则。
- 直连(Direct):由客户端接管的连接不经代理服务器。它适合与代理结果对比,但不等同于关闭
Home顶部开关;想停用连接,应回Home关闭开关。
使用 Config 时,确认正在生效的文件
Global Routing 中的 Config 是模式,底部的 Config 是管理文件的页面。设置模式后,再打开底部 Config,核对当前启用的是预期文件。点开文件看到编辑页,只说明正在查看它,并不等于已经将它设为当前配置。先确认启用状态,再进入文件的 Rule 看规则,不要为了首次连接去改动 Hosts 或 HTTPS Decryption。
需要核对某个域名时,从列表前面向下看,先找更早命中的规则,再看末尾的 FINAL 如何处理没有命中前置规则的连接。比如域名虽然符合后面的 DOMAIN-SUFFIX,但前面已有匹配的规则,就不能只凭后面那条推断结果。首次设置以读规则为主,不必点 Add Rule。想进一步了解规则顺序和动作,可查阅Shadowrocket 完整使用手册。
退出设置后回看 Home 上的 Global Routing 摘要,确认显示的是刚选择的模式。若这次只是试连,不要同时切换服务器和配置文件;保留一个已知条件,后面才容易判断是哪项设置使结果改变。
打开 Home 开关并确认 VPN 权限
在 Home 复核两处:SERVER 中本次要用的条目,以及 Global Routing 显示的模式。顶部还显示 Not Connected 时,点旁边的连接开关。开启之前最好先确认设备能正常使用当前 Wi‑Fi 或蜂窝网络;需要登录的公共 Wi‑Fi,先完成网络本身的登录,再回来试连。
首次启动:在系统提示中确认来源
如果 iPhone 或 iPad 弹出添加 VPN 配置的系统提示,先确认提示确实由刚才打开开关的操作触发,再按系统指示允许;设备可能要求通过生物识别或解锁密码确认。授权应在系统提示中完成,服务器信息和设备解锁密码不是同一类资料。首次允许添加 VPN 配置是给客户端建立连接的系统权限,不会验证你的订阅,也不会改变 Global Routing 的选择。
若刚才选择不允许,返回 Home 发现开关没有保持开启,可以再次发起连接,让系统重新显示提示。若提示始终未出现,先到系统设置搜索 VPN,查看是否已有配置,以及公司或学校的设备管理策略是否限制了修改。受管设备应向管理员确认,不要删除辨认不出的配置或设备管理项目。
授权后回到 Home,等状态完成切换。开关保持开启,说明客户端已启动连接;这并不能证明所选服务器可达,也不能说明某个网站走了代理。如果开关一开启就回落,记下提示原文和当时的网络类型,直接按失败点排查处理,不必反复开关。状态稳定后,再进入下一步验证。
用 Connectivity Test 和实际访问交叉验证
验证分三层:开关是否保持开启、所选服务器是否通过本次测试、目标站点是否按预期访问。前一层通过才有必要继续看下一层,但不能拿前一层的结果代替后一层。
- 核对测试对象。在
Home确认选中的服务器后,点Connectivity Test,等待本次测试完成,查看对应条目的结果。不要把其他条目留下的数值当成当前条目的结果。测试有响应,表示在当前网络和测试条件下得到了响应;它不是实际下载速度,也不保证所有目标都能访问。 - 打开实际要用的站点。到浏览器打开一个平时可正常访问的站点,重新加载页面,确认不是只看到了旧标签页中缓存的内容。若日常要使用配置(Config),再选一个能按当前规则判断处理方式的站点,核对实际表现。只打开一个平时就能直连的页面,无法区分连接究竟是直连还是经过代理。
- 结果不一致时做单项对照。保持同一个网络、同一服务器和同一目标地址,仅在需要时短暂切换配置(Config)、代理(Proxy)或直连(Direct),每次用同样方式重试。若代理(Proxy)能访问、配置(Config)不行,先查当前文件和规则顺序;若直连(Direct)也无法打开平时可访问的页面,先检查当前网络或目标站点。试完恢复日常要用的模式。
按失败阶段检查权限、服务器和设置
先回到第一个没有得到预期结果的步骤,不必重装或清空配置。开关打不开,优先处理权限;开关稳定但没有测试响应,优先检查选中的服务器;测试能返回而访问异常,再看路由和目标站点。每次只改一项,改完回 Home 重做上一节的同一项检查。
开关回落,或关闭后连接又出现
开关回落时,先确认是否完成系统 VPN 授权,再检查设备上是否有其他正在使用的 VPN。个人设备上如果确认可临时断开另一条连接,可以断开后重试;不要直接删除配置。反过来,如果手动关闭后更换网络时又连接,打开 Settings 查看 On Demand 是否设置了触发条件。排查期间可暂时停用自己设置的按需连接,验证完再按原需求恢复。
导入后没有条目,或测试一直得不到响应
订阅分组为空时,回到订阅记录核对原始链接是否完整,确认更新时设备本身可以联网;若更新报错,向已有服务方核对链接状态。手动添加的条目若始终得不到测试响应,返回该条目逐项核对 Type、Host、Port 和认证信息。不要用修改认证参数的方式碰运气。如果只有某条记录失败而同组另一条在相同条件下通过,先处理该条记录;如果所有条目都在同一网络失败,换一个已知可用的网络做对照。
在 Settings 中确认 Test Method,比较测试结果时尽量使用同一种方法。测试方式不同,结果可能不同,不能直接把两次显示的数值排在一起。仍需定位时,可在 Diagnostics 中查看与复现时段有关的信息;分享排查材料前,先遮盖订阅链接、密码、账号和不宜公开的地址。
测试有结果,但部分页面仍打不开
先确认问题是否只出现在一个域名或页面的一部分。页面能打开但登录或图片失败时,主页面和失败资源可能不属于同一域名。回 Config 查看当前文件中是否存在先匹配的规则,再看 FINAL;不要一见异常就把所有连接改走代理。若切回原设置后恢复正常,保留原配置,并记录是哪项改动影响结果。关于规则细节、Data 和日常维护,可继续阅读完整使用手册。