Shadowrocket 配置文件 .conf 详解:General、Rule、Host、URL Rewrite 各段作用
先分清全局参数、本地映射、请求改写与分流规则各自负责什么,再找出应该改动的那一段。笔记逐段给出示例,也说明为什么同一请求可能先命中一条更靠前的规则。改过多个分段时,可以用备份逐项对照,避免把映射或改写造成的结果误判为服务器故障。
阅读配置分段笔记 →安装、配置与连接 · 官方手册
适用于手机、平板与电脑的全平台客户端;导入已有服务器或订阅后,可用规则分流决定哪些请求走代理、直连或拒绝。
当前版本 v2.2.92 · iPhone / iPad $2.99 一次性,其他平台免费
01 客户端功能
配置决定请求走哪条路径,服务器决定代理请求发往哪里。可以先了解这两个选择,再看按需连接、同步和诊断。
在 Home 的 Global Routing 选择 Config,请求才按当前配置的 Rule 匹配。用 DOMAIN-SUFFIX 指定域名及其子域名,用 IP-CIDR 指定网段,再用 FINAL 处理前面没有命中的请求。想让某个子域名单独直连,就把那条具体规则放在较宽泛的域名规则前面。改完后先访问一个已知域名,查看实际命中的规则,再用另一个域名确认兜底行为。Proxy 和 Direct 则适合临时对照,不应用这套分流顺序。
查看 Global Routing 的区别 →DOMAIN-SUFFIX,example.com,PROXYIP-CIDR,192.168.0.0/16,DIRECTDOMAIN-KEYWORD,ads,REJECTFINAL,DIRECTOn Demand 控制何时自动发起连接,不决定某个域名走代理还是直连。在 Settings 找到 On Demand,先确定希望在哪类网络上自动连接,再设置触发条件。保存后在 Wi-Fi 与蜂窝网络之间切换一次,回到 Home 看连接状态是否符合预期。如果手动断开后又自动连上,先检查是否仍满足按需条件。要比较手动开关的行为,可以暂时停用 On Demand,只改这一项做对照。
查看 On Demand 设置参考 →从你的服务商处获取服务器信息后,在 Add Server 先选 Type,再填该类型要求的字段。Shadowsocks 的 Method 应与服务器一致;VMess、VLESS、Trojan、Hysteria2 和 WireGuard 也各有参数,不能只改 Type 就沿用整套旧设置。保存前逐一核对地址、端口及协议特有字段,尤其留意复制时带入的空格。如果同一地址上还有别的服务,也不要据此推断这个端口使用哪种协议。
查看代理协议名词 →从你的服务商处获取完整订阅链接,在 Add Server 的 Type 中选 Subscribe,粘贴后保存。回到 Home,确认 SERVER 中出现对应分组和条目,再选择要用的服务器。订阅更新与建立连接是两件事:列表能刷新,不表示其中每个条目都可达。若更新后原条目消失,重新选择一条并验证;若列表仍为空,先核对链接是否完整,避免在截图、日志或求助信息中暴露链接内容。
查看订阅导入步骤 →在 Config 确认正在使用的文件,再进入对应分段编辑。General 放全局参数,Rule 管匹配与策略,Hosts 用于主机映射。修改前保留可恢复的副本,每次只改一组相关设置,以便定位行为变化。使用 iCloud 同步时,先确认两台设备使用预期的账户,再到目标设备核对实际启用的文件;文件已同步不等于已选中,也不等于两台设备选择了同一台服务器。
阅读配置文件分段说明 →[General][Rule][Host]先在 Home 看连接状态,再运行 Connectivity Test,最后用实际访问确认目标是否可用。测试成功只说明该测试能完成,不代表所有域名都走同一策略。只有部分请求失败时,查看 Diagnostics 中与发生时刻相符的信息,区分解析失败、服务器不可达和规则选择问题。Data 可以辅助查看流量变化,但应结合测试时段判断,不能只凭总量推断单次请求经过了哪个策略。
查看连接与排查问答 →02 设备与安装包
iPhone / iPad 通过 App Store 一次性购买($2.99);Mac / Windows / 安卓 / Linux 版免费。电脑和安卓请从对应的平台卡进入本站下载页,安装包由本站 /dl/shadowrocket/ 提供。
先确认设备当前使用的 Apple 账户及商店地区,再核对商店产品页。系统要求以 App Store 页面标注为准;已有购买记录时,可先查看已购项目再决定下一步。
查看商店获取说明 →在「关于本机」查看芯片或处理器:显示 Apple 芯片就选 Apple 芯片版,显示 Intel 处理器就选 Intel 版。两种安装包都是 .dmg,不能只看文件扩展名判断。
在系统的「关于」页面核对系统类型,再选择 64 位 .exe 安装程序。公司或学校管理的电脑若限制安装,先确认管理员许可,不要把管理限制当作安装包故障。
安卓入口提供 arm64 的 .apk。若系统提示软件包与设备不兼容,先核对设备架构;若提示安装来源受限,则先看提示指向的应用和权限,不必更改其他应用的权限。
先看发行版惯用的包格式,再核对架构。使用相应包管理器的系统可选 deb 或 rpm;选择 AppImage 时,下载页另有执行权限说明。三种格式是替代选项,不必依次安装。
比较 Linux 安装格式 →03 首次连接
以下以 iPhone / iPad 的 Home 为例。先完成一次手动连接,确认服务器与策略都正确,再考虑设置自动连接或修改规则。
服务器地址、端口、协议参数或订阅链接从你的服务商处获取。有单个服务器的资料,就按提供的协议选择 Type,并填写该类型要求的字段;有订阅链接,就选择 Subscribe,粘贴完整链接后保存。返回 Home 检查 SERVER,点选希望使用的条目。添加成功只代表资料已写入;如果没有看到预期条目,应先解决导入问题,再继续连接。
要按配置里的规则分流,选择 Config,并核对当前配置;要临时对照代理路径,选择 Proxy;要对照直连结果,选择 Direct。选服务器和选模式是两个动作:即使服务器已选中,Direct 下的请求也不会因此改走代理。测试时保持服务器不变,一次只换一个模式,用同一个目标比较结果,才能判断差异与哪项设置有关。
打开 Home 的连接开关。首次出现系统的 VPN 配置确认时,先确认请求来自刚打开的客户端,再按系统提示操作。连接后运行 Connectivity Test,并访问一个与你的规则匹配的已知目标。如果测试能通过而实际访问失败,先看当前模式和规则是否符合预期;如果两者都失败,再检查设备网络、当前服务器和协议参数,不要同时修改多项设置。
04 正版与购买
先核对产品,再区分应用购买、配置迁移和线路服务。Shadowrocket 是闭源商业应用;手机和平板的商店购买记录与其他平台的安装包分开管理。
打开 App Store 的 Shadowrocket 产品页,核对开发者是否为 Shadow Launch Technology Limited,对照白底、蓝紫描边的应用图标,并确认产品页地址末段为 id932747118。中文里常把 Shadowrocket 称为“小火箭”,但别称、名称相似或图标相似都不能代替这三项核对。若从搜索结果进去,先看产品页信息,再决定是否继续。
已从商店安装的设备,也可从更新记录进入应用详情页核对。商店直接打开产品页时,以详情页内容为准,不以搜索摘要或他人截图显示的资料为准。
App Store 的可见条目取决于 Apple 账户所用的店面。设备的界面语言、当下所在地点和店面地区并不是同一个设置。打开产品页后如果看到当前地区不可用,先检查 App Store 账户里的国家或地区,不要把店面提示当成系统版本不兼容。若能打开产品页,再查看兼容性;iPhone 和 iPad 的系统要求以 App Store 页面标注为准。
从网页看到美区产品页,也不意味着当前登录的账户已切换到美区。若需要更改地区,沿 Apple 账户设置中的官方流程检查余额、订阅等前提,再按商店提示处理。
iPhone / iPad 版在 App Store 一次性购买,美区价格为 $2.99,结算以所在店面显示为准;Mac / Windows / 安卓 / Linux 版免费。在 iPhone 上购买后,使用同一 Apple 账户的 iPad 可从已购项目重新获取,反过来也一样。换机或重装时先核对当前用于商店购买的账户,再找 Shadowrocket 的下载图标,不要只看设备上是否登录了 iCloud。
恢复应用不等于恢复所有设置。迁移前先保留自己的配置,或核对 iCloud 同步是否已启用;到新设备后检查 Config、Global Routing 和当前服务器,验证一条请求之后再继续日常使用。
App Store 的购买记录对应客户端本身。服务器地址、协议参数和订阅链接从你的服务商处获取;本站不提供、不销售、不推荐节点或订阅。安装后看见空的 SERVER 列表,先确认是否已经添加自己的资料。以后若需要更新订阅,也是在客户端里刷新已有链接,服务期限和可用条目仍以你的服务商提供的信息为准。
处理导入失败时,可以记录时间、设备和出错步骤。若要分享截图,请先遮盖完整订阅地址、服务器密码和其他凭据。连接前后也可以对照 名词解释,区分订阅、服务器与配置文件。
Mac、Windows、安卓和 Linux 版从本站下载,不使用 iPhone / iPad 的商店购买记录;iPhone / iPad 版在 App Store 一次性付费 $2.99,这四个平台的客户端免费。Mac 有 Apple 芯片与 Intel 两个 .dmg,其余平台按设备和发行版选择。更新时回到下载页选原来使用的平台、架构和包格式,而不是根据设备名称搜索来路不明的同名文件。
桌面或安卓安装包可能触发系统的来源提示。遇到拦截,先核对下载地址是否在本站 /dl/shadowrocket/ 下,阅读对应系统的安装说明;来源不明、设备受管理,或提示与说明不一致时,先停止安装。
05 技术笔记
如果已经完成首次连接,可以按手头的问题继续读:配置改了没生效、换到 iPad 后怎样恢复购买,或 Linux 应该选哪种安装包。
先分清全局参数、本地映射、请求改写与分流规则各自负责什么,再找出应该改动的那一段。笔记逐段给出示例,也说明为什么同一请求可能先命中一条更靠前的规则。改过多个分段时,可以用备份逐项对照,避免把映射或改写造成的结果误判为服务器故障。
阅读配置分段笔记 →核对用于购买的 Apple 账户,查看已购项目,以及如何在横屏分栏下找到对应选项。文章把购买恢复与配置同步分开说明,方便换机后逐项检查。
阅读 iPad 设置笔记 →从发行版和架构入手确定安装格式,再区分包管理器安装与 AppImage 直接运行。已经下载但打不开时,可按包格式、执行权限和终端提示逐项检查。
阅读 Linux 安装笔记 →