# Yu9191/wloc

修改 Apple 网络定位（gs-loc）返回坐标 · 支持 Surge / Quantumult X / Loon / Stash · 快捷指令一键设置/恢复定位

Repository: https://github.com/Yu9191/wloc
Canonical: https://ross.abutalabs.com/products/wloc
Homepage: https://wloc-pages.pages.dev/
Language: JavaScript
License: AGPL-3.0
License Family: copyleft
Last push: 2026-08-21T13:25:27+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 84, longevity 5
- inputs: {"age_days": 70, "days_push": 12, "days_rel": 25, "gap_med": 43, "n_releases_24m": 2}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9690, forks 2108 (observed 2026-08-28T04:10:36.734995+00:00)

## What it is
A set of proxy-tool modules (Surge, Quantumult X, Loon, Stash, Shadowrocket) that MITM Apple's network location service (gs-loc.apple.com) to return spoofed coordinates, enabling virtual location on iOS without jailbreak. It includes a web map picker, Cloudflare Worker link parser with GCJ-02/WGS-84 conversion, and iOS Shortcuts for one-tap set/restore.

## Use cases
- spoof iOS location without jailbreak
- fake Apple WiFi-based location on iPhone
- set virtual GPS position via Surge or Quantumult X
- convert GCJ-02 map links to WGS-84 coordinates
- quickly switch and restore device location with iOS Shortcuts
- pick a spoofed location on a map and apply it

## When to choose
- you use Surge, Quantumult X, Loon, Stash, or Shadowrocket and want to override Apple network location on iOS
- you need one-tap location switching via iOS Shortcuts
- you want an open-source, self-deployable link parser with coordinate conversion

## When to avoid
- you need GPS-level spoofing of native apps that use CoreLocation hardware GPS
- you run iOS 27 beta 6 or later, where gs-loc MITM interception is blocked
- you are not using a compatible MITM-capable proxy tool

## Facets
- artifact type: plugin
- maturity: active
- function: proxy, networking, geospatial, security
- domain: privacy, mobile-development, apple-ecosystem, networking
- platform: cloud, browser
- tags: location-spoofing, mitm-scripting, surge-module, quantumult-x, loon, stash, shadowrocket, apple-gs-loc, gcj02-wgs84, cloudflare-worker, ios-shortcuts, virtual-location, maps, ios, javascript

## Member repositories
- Yu9191/wloc (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:36.734995+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:16.423462+00:00, confidence not recorded.
  - readme: https://github.com/Yu9191/wloc (fetched 2026-08-28T04:10:36.734995+00:00, sha a050b2738f44)
  - homepage: https://wloc-pages.pages.dev/ (fetched 2026-08-29T08:21:18.422931+00:00, sha aa7caa6d17ac)
- Data as of 2026-08-30T08:39:29.467469+00:00.
