Diagnostic fix · Module
The WLOC module is not loaded
WLOC diagnostics can't detect the module. This usually means one of three things: the module URL hasn't been subscribed in your proxy tool, the module file can't be reached, or the module version is incompatible.
Plain English
What this means
The WLOC module is a configuration file that tells your proxy tool how to handle Apple location requests. Without it loaded, your proxy tool doesn't know what to do with traffic to gs-loc.apple.com. Diagnostics will report 'Module not detected', 'Module URL unreachable', or 'Module version mismatch'.
Step 1：Subscribe to the module in your proxy tool
Open your proxy tool and find the module/plugin/subscription section. Add a new subscription with this URL: https://wloc.app/modules/wloc.module. After adding, refresh/update the subscription to download the latest version.
- Module subscription URL: https://wloc.app/modules/wloc.module
- Shadowrocket: Config tab → Modules → Add → paste URL
- Surge: Config → Modules → Add → paste URL
- Quantumult X: Settings → Plugins → Add → paste URL
- Loon: Config → Plugins → Add → paste URL (set certificate path in plugin details)
- Stash: Config → Overrides → Add → paste URL
- Egern: Modules → Add → paste URL
Step 2：Enable the module rules
After subscribing, make sure the module is toggled ON. Some tools show a switch next to the module name. Also confirm the module's MITM host list includes gs-loc.apple.com and gs-loc-cn.apple.com — this is required for location data modification.
- Check the module toggle is ON (not greyed out)
- Verify MITM hosts: gs-loc.apple.com, gs-loc-cn.apple.com are listed
- If version mismatch: delete the old subscription and re-add to get the latest version
Step 3：Rerun diagnostics
Go back to WLOC and run diagnostics again. The 'Module URL', 'Module enabled', and 'Module version' checks should now pass. If the module URL is still unreachable, your proxy may not be routing traffic correctly — try a different proxy node or check your network configuration.
- All module checks should show ✓ after fixing
- If module URL still unreachable: try a different proxy node
- If version still mismatched: delete and re-subscribe
FAQ
What is a WLOC module, exactly?
It's a configuration file (ending in .module, .sgmodule, .conf, .lpx, or .stoverride depending on your tool) that contains rules telling your proxy tool: 'When you see traffic to gs-loc.apple.com, run the WLOC script.' It doesn't contain any code itself — just routing rules and script references.
Can I use the module without a subscription (auto-update)?
You can manually download and import the file once, but we recommend subscribing so you get automatic updates when the module protocol version changes. Manual imports may become outdated and trigger a version mismatch in diagnostics.
WLOC
Module loaded? Now check the next step.
With the module loaded, the next most common issue is HTTPS certificate configuration. Run diagnostics — if you see 'MITM missing', head to the certificate setup guide.