BoxJs 是一款功能强大的工具，专注于为用户提供脚本管理、自动化任务和网络请求优化等功能。在使用 BoxJs 的过程中，了解和掌握一些基础模块和功能，如 Script Hub、Sub Store 等，将有助于你更好地利用这款工具。本文将介绍这些常用模块的基本前置教程，帮助你快速上手。
1. BoxJs 是什么
BoxJs 是一款支持多平台的脚本管理工具，通过其强大的功能，你可以管理和执行各种脚本，自动化日常任务，提高工作效率。BoxJs 支持自定义脚本、插件扩展和网络请求优化，是一款非常适合技术爱好者和开发者的工具。
2. Script Hub 是什么
Script Hub 是 BoxJs 中的一个重要模块，用于管理和执行脚本。它提供了一个集中的平台，你可以在这里添加、删除和编辑脚本，支持脚本的导入、导出和共享功能。
安装和使用 Script Hub：
- 打开 BoxJs：启动 BoxJs 应用，并进入主界面。
- 访问 Script Hub：在 BoxJs 的模块列表中找到并点击“Script Hub”。
- 添加脚本：点击“添加脚本”按钮，选择本地脚本文件或输入脚本 URL，导入你的脚本。
- 管理脚本：在 Script Hub 中，你可以对已添加的脚本进行编辑、删除或查看运行日志。
3. Sub Store 是什么
Sub Store 是 BoxJs 提供的一个模块，专注于管理和使用订阅资源（例如，代理订阅）。它允许用户将订阅链接导入并管理，有助于实现网络流量的分流和优化。
使用 Sub Store 的步骤：
- 打开 BoxJs：启动 BoxJs 应用，并进入主界面。
- 访问 Sub Store：在模块列表中找到“Sub Store”并点击进入。
- 导入订阅链接：点击“导入订阅”按钮，粘贴你的订阅链接，或者从本地文件中导入订阅数据。
- 管理订阅：在 Sub Store 中，你可以查看和编辑订阅内容，更新订阅链接，或删除不再需要的订阅。
4. 配置和管理
配置 Script Hub 和 Sub Store：
- 设置默认脚本或订阅：在设置页面中，你可以配置默认的脚本或订阅，以便 BoxJs 启动时自动加载。
- 调整模块参数：根据需要调整 Script Hub 和 Sub Store 的参数设置，例如更新频率、通知设置等，以满足个人需求。
脚本和订阅的管理：
- 定期更新：确保脚本和订阅定期更新，以获取最新的功能和内容。你可以设置自动更新或手动更新。
- 备份数据：定期备份你的脚本和订阅数据，以防止数据丢失或损坏。
5. 常见问题和解决方法
- 脚本无法运行：检查脚本的语法和兼容性，确保脚本符合 BoxJs 的要求。如果问题仍然存在，可以查阅 BoxJs 的官方文档或社区论坛获取帮助。
- 订阅链接无效：确认订阅链接的格式正确且有效，尝试重新导入或联系订阅提供商获取新的链接。
- 模块无法加载：检查 BoxJs 的更新日志，确保你使用的是最新版本。如果问题持续存在，可以尝试重装 BoxJs 或联系技术支持。
掌握 BoxJs 中的 Script Hub、Sub Store 等模块的基础使用和管理方法，将帮助你更高效地利用这款工具。通过合理配置和管理脚本与订阅资源，你可以实现自动化操作、优化网络流量，提升工作和生活的效率。确保定期更新和备份数据，以保持最佳的使用体验。
在 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：
点击👉一键安装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://xn--ck8h.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 群组，欢迎进去友善交流，还是一个宗旨：出现问题时候带上截图！
推荐阅读：
