mirror of
https://github.com/xweiba/location-spoofer.git
synced 2026-09-21 22:30:46 +08:00
feat: add third-party proxy mode and improve onboarding
This commit is contained in:
+15
-1
@@ -38,7 +38,21 @@ IPA 始终保持未签名。用 [Impact](https://github.com/claration/Impactor)
|
||||
|
||||
1. `./build.sh` 通过并输出未签名 IPA
|
||||
2. 用 Impact 签名后安装到设备
|
||||
3. 真机安装后,按引导下载 CA → 安装 → 信任,再配置 WiFi HTTP 代理 `127.0.0.1:8888`
|
||||
3. 真机安装后,先配置 WiFi HTTP 代理 `127.0.0.1:8888`,再按检测结果完成 CA 下载、安装和信任
|
||||
4. 环境检测通过后,选点开启虚拟定位
|
||||
5. 打开 Apple 地图验证定位是否变为虚拟位置
|
||||
6. 若失败,查看诊断页的日志信息
|
||||
|
||||
## 发布版本
|
||||
|
||||
发布前先生成版本归档并提交:
|
||||
|
||||
```bash
|
||||
./Scripts/generate-release-notes.sh v1.1.0
|
||||
git add docs/releases/v1.1.0.md
|
||||
git commit -m "docs: archive v1.1.0 release notes"
|
||||
git tag v1.1.0
|
||||
git push origin main v1.1.0
|
||||
```
|
||||
|
||||
归档文件根据“上一个版本标签到当前提交”的 commit subject 生成。GitHub Actions 会校验归档存在,并将文件正文直接作为 GitHub Release 内容;不会发布文档链接或缺失说明的占位 Release。
|
||||
|
||||
@@ -1,36 +0,0 @@
|
||||
# 自签安装指南
|
||||
|
||||
**免费 Apple ID 即可自签安装**,无需付费开发者账号。
|
||||
|
||||
## 原理
|
||||
|
||||
本项目只是一个本地 HTTP 代理配合 WiFi 手动代理,不涉及 VPN / Network Extension / Packet Tunnel Provider。无需特殊权限,个人免费 Apple ID 侧载完全可用。
|
||||
|
||||
## 构建未签名 IPA
|
||||
|
||||
```bash
|
||||
./build.sh
|
||||
```
|
||||
|
||||
输出:`dist/PaopaoLocationSpoofer-unsigned.ipa`
|
||||
|
||||
## 使用 Impact 签名安装
|
||||
|
||||
用 [Impact](https://github.com/claration/Impactor) 打开 IPA 签名并安装到设备。
|
||||
|
||||
关键标识符不可更改:
|
||||
|
||||
| 组件 | Bundle ID |
|
||||
|------|-----------|
|
||||
| 主 App | `com.paopaolabs.location-spoofer` |
|
||||
| App Group | `group.com.paopaolabs.location-spoofer` |
|
||||
|
||||
## 安装后步骤
|
||||
|
||||
1. 首次打开,按引导下载 CA 证书 → 安装描述文件 → 开启完全信任
|
||||
2. 在 WiFi 设置中配置 HTTP 代理为 `127.0.0.1:8888`
|
||||
3. 环境检测通过后即可使用
|
||||
|
||||
## iOS 26+ 注意事项
|
||||
|
||||
开启虚拟定位后需重启设备清除定位缓存,详见 README 中的使用说明。
|
||||
@@ -0,0 +1,31 @@
|
||||
# Third-party proxy module snapshots
|
||||
|
||||
The files under `Resources/ThirdPartyProxyModules/` are bundled configuration
|
||||
snapshots from [Yu9191/wloc](https://github.com/Yu9191/wloc). They are retained
|
||||
in the App bundle for release provenance and offline inspection. The setup UI
|
||||
copies the official subscription URL instead of exporting these files.
|
||||
|
||||
- Upstream commit: `eec07a8dc8de6dbaee8eac1fb376e4d03020154a`
|
||||
- Snapshot date: 2026-08-06
|
||||
- Source directory: `modules/`
|
||||
|
||||
| Bundled file | Client |
|
||||
|---|---|
|
||||
| `wloc.module` | Shadowrocket |
|
||||
| `wloc.sgmodule` | Surge and Egern |
|
||||
| `wloc.conf` | Quantumult X |
|
||||
| `wloc.lpx` | Loon |
|
||||
| `wloc.stoverride` | Stash |
|
||||
|
||||
SHA-256:
|
||||
|
||||
```text
|
||||
bb5e17b60027704971660b0ea2df3560ceff973c27d43e7f2c2c18b48d368ac6 wloc.conf
|
||||
1fb451616fb17242849f72490f016afcdb8aa81a0b086f6dd5f94e1af3d58ee1 wloc.lpx
|
||||
97cab104056428aa0e90521c3bf2646e9739b0b4c83272b31790f99584bca89e wloc.module
|
||||
5d6b82c31316f4a7be65e3b8d2335f4338e01af98e262948118eefe63abf7034 wloc.sgmodule
|
||||
cb06593752db8b223dfa5cd1cbd089115fe3a541f5c8532491615923e83df2cb wloc.stoverride
|
||||
```
|
||||
|
||||
The official subscription URLs are the setup UI's import path. Egern reuses the
|
||||
Surge module. Stash imports `.stoverride` directly.
|
||||
@@ -6,7 +6,7 @@
|
||||
|
||||
- **🗺️ 原生地图体验**:Apple MapKit 蓝点实时定位,搜索地点、点击选点、拖动浏览与 Apple 地图一致
|
||||
- **📍 虚拟定位引擎**:基于本地 HTTP 代理 MITM 方案,无需 VPN、无需越狱,对钉钉、微信及任意系统定位 App 生效
|
||||
- **🧪 完整设置引导**:证书安装 → WiFi 代理配置 → 环境验证,逐步检测代理、CA 信任、坐标写入与响应改写
|
||||
- **🧪 完整设置引导**:WiFi 代理配置 → 证书安装与信任 → 环境验证,逐步检查本地代理、CA 信任和 WiFi 代理链路
|
||||
- **✈️ 飞行模式缓存清除**:一键化操作引导,按步骤刷新飞行模式、WiFi 和定位服务状态
|
||||
- **⭐ 收藏与快速切换**:保存常用坐标,一键跳转
|
||||
- **🧾 诊断日志**:实时查看定位请求和改写状态,每条独立可复制
|
||||
@@ -19,11 +19,11 @@
|
||||
| 安装 | 自行签名(推荐 [Impact](https://github.com/claration/Impactor)) |
|
||||
| 网络 | 可手动配置 HTTP 代理的 WiFi |
|
||||
|
||||
### 安装
|
||||
### 自签安装
|
||||
|
||||
1. 从 [Releases](https://github.com/xweiba/location-spoofer/releases) 下载 `PaopaoLocationSpoofer-unsigned.ipa`
|
||||
2. 使用 [Impact](https://github.com/claration/Impactor) 签名安装
|
||||
3. 按 App 内引导完成证书安装和 WiFi 代理配置
|
||||
3. 签名时保留 Bundle ID `com.paopaolabs.location-spoofer`、App Group `group.com.paopaolabs.location-spoofer` 及原有 entitlements
|
||||
|
||||
### 致谢
|
||||
|
||||
|
||||
Reference in New Issue
Block a user