Home › First Connection

Shadowrocket
导入与首次连接

先准备连接资料,再选择模式、打开开关并验证结果。本篇官方手册面向 iPhone 与 iPad,按首次操作顺序说明每一步应检查的界面与状态。

  • Add Server
  • Subscribe
  • Global Routing
  • Connectivity Test

单条服务器与订阅是两种资料入口,不必重复添加。如果已有订阅链接,可以直接跳到第二步;如果已有完整服务器参数,则先完成第一步,再继续选择模式。

Step 01 › Add Server

Add Server:填写已有服务器信息

打开 Shadowrocket,进入 Home,在 SERVER 分组找到 Add Server。进入后先查看 Type,而不是立即填写地址。Type 决定随后出现的字段:不同协议的认证方式与连接参数不同,不能仅凭服务器名称判断。应照已有资料选择 Shadowsocks、VMess、VLESS、Trojan 等对应类型,不要为减少字段而改成另一种协议。

随后填写 Host 与 Port。Host 是服务器域名或地址,Port 是该服务实际监听的端口,两者必须来自同一份连接资料。示例中的 example.com 仅用于说明格式。不要把完整订阅链接粘到 Host,也不要把链接里的路径或查询参数当作端口。粘贴后检查首尾空格、换行和标点,避免输入法把英文符号替换成其他字符。

继续填写该 Type 要求的认证信息。截图展示的 Password、Method 属于所示类型的字段,并不表示每种协议都使用同一组参数。如果已有资料还列出 TLS、Server Name 或其他传输选项,应逐项保持一致;不清楚某一值时,先核对原始资料,不要通过关闭验证或随意更换加密方式来试错。

资料以二维码提供时,可使用 Scan QR Code 导入,再回到编辑页复核 Type、Host 与 Port。Import from Cloud JSON 是另一种指定内容格式的入口,不应把任意网页地址当作相应配置。保存后返回 Home,确认 SERVER 列表出现新条目。此时只是完成保存,尚不能据此判断连接已经成功。

Shadowrocket 的 Add Server 页面,显示 Type、Host、Port、Password、Method 与导入入口
Add Server:字段随 Type 变化,按已有资料填写。
Step 02 › Subscribe

Subscribe:导入自己的订阅链接

如果手中是一条用于更新服务器列表的订阅链接,使用 Subscribe,而不是逐个手填其中的服务器。先从自己的服务商处复制完整链接,再进入 Home 的 Add Server,将 Type 选择为 Subscribe,在对应 URL 字段粘贴链接,并填写便于辨认的备注。具体字段位置以当前应用显示为准,保存前确认没有把介绍网页、账户页面或订单页面地址当作订阅地址。

订阅地址可能包含用于识别账户的查询参数,必须完整保留。复制时漏掉末尾字符、夹入换行,或者手动删去看似多余的参数,都可能使服务器列表无法读取。链接应按私密资料保管;寻求帮助时只描述提示文字与失败阶段,不公开完整链接。这里不需要把订阅内容转贴到其他网站处理。

保存后执行订阅更新,等待读取结束,再返回 Home 检查相应分组是否出现服务器。检查的重点是“是否成功取得条目”和“条目能否连接”这两件不同的事:更新成功表示本次内容可被读取,不代表每个服务器都能连接;列表为空也不等于连接开关有故障,应先检查链接、订阅状态以及当前网络是否能访问该地址。

首次上手建议先手动更新一次,确认内容正常后再考虑自动更新。重复创建同一订阅通常不会修复链接本身的问题,反而会增加难以区分的分组。更新失败时保留已有条目与原始链接,记录错误提示,按订阅解析失败或列表为空自查步骤逐项核对;自动更新的区别见订阅更新说明。

Step 03 › Global Routing

Global Routing:区分三种姿态

返回 Home,点开 Global Routing,查看当前选项。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。它们描述的是请求路径的选择方式,而不是服务器协议。添加服务器不会替代这一步:相同服务器在不同模式下,可能只处理部分请求,也可能不参与当前请求。

姿态用途操作前检查
配置(Config)按当前配置中的规则选择策略。确认当前使用的 Config 与 Rule。
代理(Proxy)以代理路径处理请求,用于核对所选服务器是否可用。确认已选中预期服务器,留意配置中的例外设置。
直连(Direct)使用直接连接路径。不要将目标可访问直接视为代理成功。

日常按规则使用时,选择配置(Config),同时进入 Config 核对实际使用的配置文件。在对应文件的编辑页可以看到 General、Rule、Hosts 等分段;其中 Rule 决定匹配条件与策略。只打开一个文件查看,不应当作已经切换到该配置,应返回列表核对当前使用标记。初次操作先保留原配置,不要同时编辑多个分段。

例如,DOMAIN-SUFFIX,example.com,PROXY 表示符合该域名后缀条件的请求使用 PROXY;FINAL,PROXY 用于前面规则均未命中时的最终选择。这些只是语法说明,不是适合所有人的完整配置。规则顺序与所用策略都影响结果,不能只看到关键词就判断请求一定走代理。

如果暂时只想区分“服务器连接问题”和“规则选择问题”,可记录原姿态后,临时使用代理(Proxy)做对照测试,测试结束再恢复。直连(Direct)适合确认直接访问的表现,但它不能验证服务器是否可用。更完整的匹配顺序与模式说明见Global Routing 设置参考及规则检查章节,本篇先完成一次可验证的连接流程。

Shadowrocket 的 Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:检查当前配置中的 Rule,不把编辑页面当作模式选择页。
Step 04 › Home

Home:选中服务器并打开连接

回到 Home,在 SERVER 分组中点选本次要使用的服务器,并观察条目左侧的圆点标记。进入条目编辑页与选中默认服务器是不同操作;不要只查看参数就认为已完成选择。若导入了多个分组,先确定所选条目属于哪一个分组,后续测试都保持同一个选择,便于比较结果。

确认 Global Routing 后,打开 Home 顶部的连接开关。首次连接时,系统可能请求允许 Shadowrocket 添加 VPN 配置。核对请求来自当前正在操作的应用,再按系统流程允许并完成设备认证。这个授权用于建立应用所需的网络配置,不会替代服务器密码,也不会为账户增加可用订阅。

返回 Shadowrocket 后查看顶部状态是否仍为 Not Connected,以及开关是否保持开启。若系统授权被取消,应先处理授权步骤,而不是立即修改服务器参数。若开关打开后随即关闭,记录提示文字与发生时机:是在授权前、授权后,还是开始访问目标时。不同阶段对应不同检查方向。

开关保持开启与目标可访问仍是两件事。连接状态首先说明本地连接流程是否建立,不能单凭状态文字推断服务器认证、DNS 和每条规则都正确。现在先保持模式与服务器不变,进入下一步进行验证,避免在缺少对照结果时连续修改设置。

Shadowrocket 的 Home 页面,顶部显示 Not Connected 开关、Global Routing 和 Connectivity Test,下方为 SERVER 分组与 Add Server
Home:依次检查服务器选择、Global Routing 与顶部连接开关。
Step 05 › Connectivity Test

Connectivity Test:分别验证连接与访问

在 Home 运行 Connectivity Test,等待本次测试结束,再观察所选服务器的结果。测试方法会影响检测内容,因此应先保持同一种 Test Method 做比较。一个可用的测试结果只说明对应检测条件下得到响应,不等于目标应用的所有连接都已成功;一次超时也不能独立确定是认证错误、服务器不可达还是测试目标暂时没有响应。

接着打开需要使用的目标页面或应用,执行一个明确操作,例如重新加载页面,而不是只查看已经缓存的内容。可以选择两个自己日常使用的目标进行对照,记录哪个成功、哪个失败。若在配置(Config)下只有某个目标异常,应先检查该请求命中的规则,而不是立即更换所有服务器。

需要确认路径时,结合当前应用可查看的连接记录或日志,核对目标域名与最终策略。PROXY、DIRECT、REJECT 分别表示代理、直接连接与拒绝策略;本地连接开关开启时,DIRECT 请求仍可能正常直连。若请求命中 REJECT,先检查相应规则是否符合预期,不能把被规则拒绝的请求直接归因于服务器失效。

可按“服务器测试有响应 → 系统连接保持 → 目标实际可用 → 策略符合预期”的顺序记录结果。前三项正常但策略不符时,应回到 Global Routing 与 Config;测试失败且目标也失败时,再按下一步检查资料和网络条件。一次只改变一个变量,复测后再决定是否保留修改,这样才能知道是哪项调整产生了影响。

Step 06 › Settings

Settings:按失败阶段逐项检查

导入失败:先检查资料完整性

如果订阅保存后解析失败或列表为空,先回到订阅编辑页检查链接是否完整,再确认已有服务的状态及当前网络能否访问订阅地址。若是单条服务器,重新比对 Type、Host、Port 和认证字段。此阶段不需要先改 DNS、规则和 On Demand,因为连可用条目都尚未确认时,后续设置无法修正缺失的连接资料。

无法连接:检查选择与系统授权

如果条目已经存在,但打开连接后立即停止,先检查 Home 中的选中标记以及系统 VPN 配置授权是否完成,再看应用提示。切换网络环境可作为对照,但应保持同一服务器与相同参数。不要同时重建订阅、修改端口并切换模式,否则成功或失败都难以追溯原因。

测试与访问不一致:核对 Test Method 和 DNS

进入 Settings 可查看 Test Method,并确认测试方式与自己的判断目标是否一致。某些测试只覆盖连接的一部分,因此应结合实际访问结果。如果表现为域名无法解析而其他连接仍正常,再检查 DNS。先记录现有值与当前 Config,不要直接叠加多个解析地址。系统 DNS、自定义 DNS 与 DNS over HTTPS 的进一步取舍见DNS 设置说明。

连接行为不符合预期:检查 On Demand

若连接会按网络条件自动触发,或与手动开关的预期不同,检查 Settings 中的 On Demand 及其条件。首次排查时先记录其当前状态,保持一次手动连接的条件稳定,再决定是否调整。On Demand 的默认值以当前应用显示为准,不应因为其他人的设置不同就直接照搬。

仍然失败:保留最少必要的诊断信息

需要进一步分析时,再查看 Diagnostics 或当前应用提供的相关日志。只记录发生时间、操作步骤、错误提示、所用 Type 与最终策略即可起步。分享前遮盖订阅链接、服务器认证信息以及与问题无关的访问记录。日志可能包含目标域名与地址,不应整份公开。

如果已找到可用设置,先恢复正常使用,再逐项处理需要优化的选项。Settings 中的 Proxy、TCP、UDP 等项目属于更深入的连接行为设置,并非首次连接都要改动。逐项含义与取值建议请继续阅读Settings 选项手册;需要重新走一遍操作时,可返回本教程的 Add Server 步骤核对资料入口。

Shadowrocket 的 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP 设置入口
Settings:按问题进入对应选项,不必为首次连接修改全部项目。