WLOC

Quantumult X · WLOC 配置教程

在 Quantumult X 上配置 WLOC——rewrite 规则、MitM 和证书信任

Quantumult X 有一个几乎所有新人都会踩的坑:导入 WLOC 配置后,必须手动刷新脚本资源。跳过这一步,模块加载了但脚本不会运行。另外,它的设置桥接说的是 HTTP/1.1 状态字符串,不是 JSON——这是正常的,不要慌。

开始前准备

  • WLOC 已安装。
  • Quantumult X 已安装(独立购买)。
  • 测试设备。
  • 稳定 Wi-Fi。

第 1 步:导入 WLOC 配置

复制模块地址:https://wloc.app/modules/wloc.conf。QX 中进入设置→Rewrite & 过滤器→点右上角下载图标→粘贴地址→下载。确认两个复选框(rewrite 规则和 MitM 主机名)都选中。

  • .conf 文件包含 [rewrite_local] 规则和 [mitm] 主机名——两部分都需要。
  • 如果只导入了其中一部分,删除后重新导入。

第 2 步:刷新脚本资源——不要跳过

导入后 QX 会缓存旧版脚本。设置→Rewrite & 过滤器→找到 WLOC 条目→点刷新图标(小圆形箭头)。两秒钟的事。现在就做。

  • 每次导入后和 WLOC 更新后都要刷新。
  • 我数不清有多少人说 QX 坏了,结果只是没刷新。

第 3 步:生成并信任 CA 证书

QX 设置→MitM→生成 CA。安装描述文件。然后设置→通用→关于本机→证书信任设置→打开 QX CA。两步都必须完成。

  • CA 生成:QX 设置→MitM→生成 CA。
  • iOS 信任:设置→通用→关于本机→证书信任设置。

第 4 步:用 WLOC 诊断验证

保存测试目标,运行诊断。QX 设置桥接返回 HTTP/1.1 状态字符串——这是正常的。查看 patch 计数 > 0。

  • HTTP/1.1 状态字符串是 QX 的正常行为。
  • patch 计数 > 0 确认响应脚本正常。

第 5 步:恢复与清理

WLOC:清除目标,确认 passthrough。QX:关闭 rewrite 规则,关闭 MitM。iOS:移除 CA 描述文件。

  • 先关闭 rewrite 规则以停止脚本执行。
  • 移除 CA 描述文件——QX 不会自动移除。

常见卡点

导入后脚本未运行

刷新脚本资源。QX 会积极缓存。点 WLOC rewrite 条目旁边的刷新图标。两秒钟。

FAQ

为什么 QX 需要刷新资源?

QX 在首次导入时缓存脚本资源。刷新确保你拥有当前版本的 WLOC 脚本。

WLOC

配置完成后,用诊断确认每一步

回到 WLOC 运行诊断,先处理第一个未通过项目;测试完成后清除目标并验证正常定位已经恢复。