共计 6045 个字符，预计需要花费 16 分钟才能阅读完成。
写在前面的一点碎碎念
在当前的 iOS 平台，主流的几个代理 App 里面（Shadowrocket、Loon、Quantumult X、Surge，我因为没有 stash，就不写进去了），基本上比较进阶一点的玩法都有可能用得到 BoxJs、Script-Hub、Sub-Store 这三个东西，很多新人开始使用这几个工具的时候，可能因为本身对代理 App 的不熟悉或者对这几个工具的不熟悉，会出现一些问题，然后进群问的时候，因为可能都是一些回答烂了的问题，或者经常回答的问题，没有多少人愿意理睬，在 @xream 的建议下，我写一个通用的前置教程，希望能够有所帮助。
前置条件
本文仅面对正版用户。
在 Shadowrocket、Loon、Quantumult X、Surge 这几款 app 上使用上述工具的时候，需要的前置条件就是基本就是三项：MITM、脚本 、 信任证书，这三项东西，在不同的代理 App 里面可能称呼有一些区别，下面我就上面所列的几个代理 app，分别讲述一下如何设置满足这三个前置条件。
⚠️对于这三个都需要进行添加规则：Domain-suffix,vercel.app proxy
proxy 不一定是这个名字，可以是香港、美国等非直连（Direct）代理策略即可
小火箭（Shadowrocket）
因为小火箭的操作相对比较隐蔽和复杂，先放在前面说
添加规则：Domain-suffix,vercel.app proxy
文字步骤：点开 小火箭的配置 - 点击配置文件后面的 小感叹号 -HTTPS 解密 - 点上开关 - 下面的证书 - 生成证书 - 安装证书，去 手机的设置- 通用 - 关于本机 - 证书信任设置 - 信任 Shadowrocket 证书
参照下图跟着步骤走：
因为小火箭兼容 Surge 的模块，所以 建议 使用 Surge 的模块，标准的 Surge 模块内容中会包含该模块需要的全部内容，而无需进行额外的操作（一些需要本地进行修改内容的除外）。
你可以在下列地址：
Boxjs：
点击👉一键安装
手动安装：
安装路径:
配置 > 模块 > 右上角加号
模块地址：
https://raw.githubusercontent.com/chavyleung/scripts/master/box/rewrite/boxjs.rewrite.surge.sgmodule
安装完成后检查模块名称后面的✓是否已经勾上
打开
显示类似：
Tips：可以把 Boxjs 这个页面 添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示类似页面，见后面的问题排查步骤进行排查
Script-Hub
点击👉一键安装
安装路径：
配置 > 模块 > 右上角加号
模块地址：
https://raw.githubusercontent.com/Script-Hub-Org/Script-Hub/main/modules/script-hub.surge.sgmodule
安装完成后检查模块名称后面的✓是否已经勾上
如何检查是否已经进行了正确的安装：
打开：
显示类似：
Tips：可以把 Script-Hub 这个页面添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示，见后面的问题排查方法
Sub-Store
点击👉一键安装
手动安装：
安装路径：
配置 > 模块 > 右上角加号
模块地址：
https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/Surge.sgmodule
打开：
显示类似：
Tips：可以把 Sub-Store 添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示或有其它报错信息，见后面的问题排查方法
其它的类似模块安装方法与上面相类似，不再赘述。
Loon
其实对于新手我一直是建议使用 Loon 而不是小火箭，仅仅是从 易用性 的角度，Loon 的很多设置都有比较直观完善的 GUI，更方便。当然，很多人使用小火箭的原因是它可以无限进行共享，基本上等于一个朋友有了，他身边的人就都有了，很多机场也拿共享的小火箭账号来吸引用户，而 Surge/Loon/Quantumult X 等限制了一定的设备数量，对此我只能说，请 尽量 支持开发者，毕竟人家也是要吃饭的。
Loon 的 MITM、复写、脚本在 App 的配置页面均有相应的开关进行打开，其中，MITM 部分需要安装证书后方可使用。
到 MitM 的域名设置里面，将 MitM over HTTP/2 开关打开（mitm over HTTP/ 2 这步为可选，但是建议打开)
安装证书并且信任，文字步骤如下：
设置 - 证书管理 -（如果有证书）安装 CA 证书 - 允许描述文件 - 选取设备 iPhone- 设置 - 已下载描述文件 - 安装描述文件 - 输入密码 - 安装 - 通用 - 关于本机 - 拉到底部的证书信任设置 - 点上 Loon 对应证书。
图片步骤见下面的图示：
接下来转到手机的设置那边
设置的关于本机那边
得益于 Loon 的插件商店，安装 Boxjs、Script-Hub、Sub-Store 等相当的容易。
插件商店使用方法：
安装地址：
https://gitlab.com/lodepuly/vpn_tool/-/raw/master/Tool/Loon/Plugin/LoonGallery.plugin
或者通过这里 一键添加插件仓库
配置 - 插件 - 右上角添加 -URL 中粘贴上面地址 - 信任插件安装，点击一下插件名，给它指定一个代理策略（不可选 Direct 及 Reject）
验证是否安装成功：
点击：https://🎈.com，出现了各种开发者的仓库
Tips：可以把 Sub-Store 添加到主屏幕，即可获得类似于 APP 的使用体验
通过插件仓库安装：
Boxjs：CHAVYLEUNG/SCRIPTS
Sub-Store：PENG-YM/SUB-STOR
Script-Hub：未收录最新版，通过此链接 一键安装
手动安装：
方法：见上面安装插件仓库步骤
地址：
Boxjs：
手动地址：
https://raw.githubusercontent.com/chavyleung/scripts/master/box/rewrite/boxjs.rewrite.loon.plugin
Sub-Store：
手动地址：
https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/Loon.plugin
Script-Hub：
手动地址：
https://raw.githubusercontent.com/Script-Hub-Org/Script-Hub/main/modules/script-hub.loon.plugin
安装完成后，如果没有显示或有其它报错信息，见后面的问题排查方法
Quantumult X
Quantumult X（后简称 QX、圈叉）使用重写只需要点击右下角的风车图标，下拉到重写，点上开关即可
使用 MITM 功能，则需要进行根证书的安装，点击 MITM 的生成证书，然后选择配置证书，允许下载描述文件，安装到 iPhone 上
具体过程请参照下面的图片进行
下载完描述文件后，需要到 iPhone 的设置进行后续步骤，到设置页面，进行证书的安装，安装完成后，到通用 - 关于本机里面，拉到底下的证书信任设置里面，点上信任开关，才算安装完毕。（这一部分所有代理 App 都是相同的）
安装完证书后，就可以点上 Quantumult X 设置里面的 MITM 开关了。
Boxjs
在最新的版本，推荐只使用 Rewrite 安装，无特殊需要无必要配置 HTTP Backend
安装方法：
一键安装
如果你使用的是 v1.0.29 (670) 及以上版本: 一键安装
手动安装：
安装路径:
风车 > 重写 > 规则资源
https://raw.githubusercontent.com/chavyleung/scripts/master/box/rewrite/boxjs.rewrite.quanx.conf
Script-Hub
QX 有解析器的存在，还有需要用 Script-Hub 的必要吗？🤣
Sub-Store
手动安装：
安装路径:
风车 > 重写 > 规则资源
https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/QX.snippet
安装完成后，如果没有显示或有其它报错信息，见后面的问题排查方法
Surge
Surge 的 MITM、脚本、Rewrite 均有独立的开关，分别在首页的修改和捕获分页面中，其中 MitM 开关打开需要进行 CA 证书的安装。
证书的生成和安装步骤可参照上面的 App 步骤，基本相同。
对于 Boxjs、Script-Hub、Sub-Store 等建议采用 模块 的方式进行安装。
Boxjs
安装路径：
首页 > 修改 > 模块 > 安装新模块
模块地址：
https://raw.githubusercontent.com/chavyleung/scripts/master/box/rewrite/boxjs.rewrite.surge.sgmodule
打开
显示类似：
Tips：可以把 Boxjs 这个页面 添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示类似页面，见后面的问题排查步骤进行排查
Script-Hub
安装路径：
首页 > 修改 > 模块 > 安装新模块
模块地址：
https://raw.githubusercontent.com/Script-Hub-Org/Script-Hub/main/modules/script-hub.surge.sgmodule
如何检查是否已经进行了正确的安装：
打开：
显示类似：
Tips：可以把 Script-Hub 这个页面添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示，见后面的问题排查方法
Sub-Store
手动安装：
安装路径：
首页 > 修改 > 模块 > 安装新模块
模块地址：
https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/Surge.sgmodule
打开：
显示类似：
Tips：可以把 Sub-Store 添加到主屏幕，即可获得类似于 APP 的使用体验
如果没有显示，见后面的问题排查方法
至此几个主流 App 的安装方法均已经讲述完毕。
问题排查
安装是一个很简单的过程，在安装后总会发现有各种原因导致所安装的没有起到作用，那么，这时候该如何进行排查原因呢？这里简单的讲述一下如果安装后没有起到作用，在各种 app 上如何进行排查。
排查的步骤：
- 添加规则：Domain-suffix,vercel.app proxy 是否正确的配置了
- 证书安装：证书是否正确的安装并信任（见上证书安装信任步骤）
- 小火箭用户：HTTPS 解密开关是否打开（见上面证书安装信任步骤）
- MitM/ 重写 / 复写的开关是否打开（Surge、QX、Loon）
- 模块 / 重写页面中所要使用的模块是否勾选✔（小火箭、QX、Surge 用户）
综上，首先第一步是检查前置条件，各种开关和相应的功能是否已经启用，基本上这一步如果做到位是不会有什么问题的。
如果你很自信自己规则已经添加，各种开关和证书都确定没有错误，可以尝试如下步骤进行：- 删除再安装模块
- 更新外部资源 确保下载好了
- 关闭再开启脚本
- 关闭再开启重写
- 关闭再开启 MitM
- 重新信任证书
- 禁用再启用模块
- 关开代理
- 关代理, 杀 app 后台, 再打开
- 重启设备
如果经过上面各种折腾之后，还是不行且你觉得操作肯定没问题。
带日志找 app 开发者反馈问题。
各 app 的日志查看方法：小火箭：
设置 > 诊断 > 启用日志记录打开后 >VPN 日志
QX
QX 的网络活动和日志都是比较直观的，打开 App 后，将上面的一行大色块往左滑动，即可看到网络活动和日志这两个项目，点击后即可分别查看里面的一些记录情况
在遇到问题时候，要学会查看网络活动和日志，而且如果某个重写、脚本、规则等你添加的东西，没有按照你预想的运行时候，如果你不会自己判断问题，在群组里面进行反馈寻求帮助的时候也最好附上运行的网络活动和日志截图。
Loon
Loon 的首页快捷方式里面默认是没有显示脚本、脚本任务、MitM、复写等板块的，可以在仪表的快捷方式里面进行编辑把他们显示出来，这样平时使用时候更方便查看。如果觉得用的不多的话，直接查看请求记录也足够了。
遇到问题的关键也是检查相应的一些开关和查看请求记录里面的运行情况，如果自己不能确定的时候，进行反馈或者寻求帮助的时候也务必带上请求记录等一些截图便于人家排查。
Surge
Surge 的使用过程和其它的几个代理 App 基本都是相同，也是主要注意证书的安装和各种开关是否打开，不过 Surge 的模块中有一个特别需要注意的地方是：如果你在安装一些远程模块时候，务必注意模块的内容中的 [MITM] 字段（如果有的话）中的 hostname= 后面是否有“%APPEND%”或者“%INSERT%”字段，这两个代表着该模块引入的 j 进行 MitM 主机名接在原有配置的后面或者是插入到原有配置的前面，如果没有的话，代表这不是一个正规的为制作的 Surge 的模块，会导致你的其它 MitM 主机名失效。
其它遇到问题的时候，也是一样通过查看工具页的最近请求和日志来进行排查，其中 Surge 日志中对每个启用了的脚本都有单独的运行记录，在日志页面往下拉即可查看对应脚本名称的运行日志，此处不再进行赘述。
所谓的问题排查，永远只能给一个大致的建议的方向，更多的还是需要大家不要去胡乱添加一些自己不知道用途的东西进去，以及知道出现问题该如何排查：检查开关！查看日志！查看日志！查看日志！
以上的各 App 都有一些官方或非官方的 telegram 群组，欢迎进去友善交流，还是一个宗旨：出现问题时候带上截图！
请注意，以下这些群组仅面对正版用户，且都不支持对其它 App/ 内购的破解交流。
交流群组
小火箭 tg 群：https://t.me/ShadowrocketApp
QX 交流群：https://t.me/QuanXApp
QX 交流宽松群：https://t.me/QuantumultXxx
Loon 官方群：https://t.me/Loon0x00
Loon 社区群：https://t.me/LoonCommunity
Surge 社区群：https://t.me/SurgeCommunity
Script-Hub/Boxjs/Sub-store 的一些问题，可以去当前主要维护者之一 @xream 小一 的折腾啥群：https://t.me/zhetengsha_group
更多资源请 点击这里 关注 TG 频道
