诊断修复 · 模块
WLOC 模块未加载
WLOC 诊断检测不到模块。通常有三种可能：模块地址还没在代理工具里订阅、模块文件无法访问、或者模块版本不兼容。
大白话解释
这是什么意思
WLOC 模块是一个配置文件，告诉你的代理工具如何处理 Apple 的定位请求。如果模块没有加载，代理工具就不知道该对发往 gs-loc.apple.com 的流量做什么。诊断会报告「模块未检测到」「模块地址不可达」或「模块版本不匹配」。
第1步：在代理工具中订阅模块
打开你的代理工具，找到模块/插件/订阅相关设置。添加一个新的订阅，地址填：https://wloc.app/modules/wloc.module。添加后刷新/更新订阅以下载最新版本。
- 模块订阅地址：https://wloc.app/modules/wloc.module
- Shadowrocket：配置页 → 模块 → 添加 → 粘贴 URL
- Surge：配置 → 模块 → 添加 → 粘贴 URL
- Quantumult X：设置 → 插件 → 添加 → 粘贴 URL
- Loon：配置 → 插件 → 添加 → 粘贴 URL（在插件详情里设置证书路径）
- Stash：配置 → 覆写 → 添加 → 粘贴 URL
- Egern：模块 → 添加 → 粘贴 URL
第2步：启用模块规则
订阅后确认模块开关已打开。有些工具会在模块名称旁边显示开关。同时确认模块的 MITM 主机列表包含 gs-loc.apple.com 和 gs-loc-cn.apple.com——这是修改定位数据的前提。
- 确认模块开关是 ON（不是灰色的）
- 检查 MITM 主机：gs-loc.apple.com、gs-loc-cn.apple.com 已在列表中
- 如果版本不匹配：删除旧订阅重新添加以获取最新版本
第3步：重新运行诊断
回到 WLOC 重新运行诊断。「模块地址」「模块已启用」「模块版本」检查应该都通过了。如果模块地址仍然不可达，可能是代理没有正确路由流量——尝试更换代理节点，或者检查网络配置。
- 修复后所有模块检查应显示 ✓
- 模块地址仍不可达：尝试更换代理节点
- 版本仍不匹配：删除订阅后重新添加
FAQ
WLOC 模块到底是什么？
它是一个配置文件（根据你的工具，后缀可能是 .module、.sgmodule、.conf、.lpx 或 .stoverride），里面包含规则告诉你的代理工具：「当看到发往 gs-loc.apple.com 的流量时，执行 WLOC 脚本。」它本身不含代码——只有路由规则和脚本引用。
可以不订阅（自动更新）直接手动导入模块吗？
可以手动下载导入一次，但我们建议订阅以获取自动更新。模块协议版本更新后，手动导入的旧版本可能会触发版本不匹配的诊断警告。
WLOC
模块加载了？继续检查下一步。
模块加载之后，下一个最常见的卡点是 HTTPS 证书配置。运行诊断——如果看到「MITM 缺失」，前往证书设置教程。