WLOC 自建选点版 1.0.0

这是配合小火箭 WLOC 模块使用的网页，不是独立修改 iPhone 定位的 App。

一、完整部署（推荐独立子域名，例如 wloc.你的域名）
运行环境：Linux + Node.js 22 或更高版本；也提供 Docker 方式。
不需要 npm install，没有 npm 运行依赖，不需要数据库。

方式 A：服务器面板 / Node 项目
1. 上传并解压本目录，整个目录作为项目目录。
2. Node 版本选择 22 或更高；启动文件 server.mjs；端口 8080。
3. 环境变量 PUBLIC_ORIGIN 设置成 https://你的域名（末尾不加斜杠）。
4. 用面板把域名反向代理到 http://127.0.0.1:8080，申请并开启 HTTPS。
5. 设置进程守护 / 开机启动。命令行手动测试可运行：
   PUBLIC_ORIGIN=https://你的域名 node server.mjs
6. nginx-location.conf 提供反向代理片段，不要替换服务器已有的完整配置。

方式 B：Docker
1. 修改 compose.yaml 中 PUBLIC_ORIGIN 为你的 HTTPS 域名。
2. 在目录里运行 docker compose up -d --build。
3. 域名反向代理到 http://127.0.0.1:8080，开启 HTTPS。
仅本机监听 8080；不要为了访问而将端口直接开放到公网。

二、只有静态网站空间
将 public 文件夹里面的内容上传到网站根目录即可。
选点、收藏、坐标输入、储存/查询/清除小火箭数据可以使用。
分享链接解析依赖本包 Node 服务，纯静态部署不支持短链接解析。
搜索仍直接使用外部搜索服务；不是所有中文或国外地址都能搜到。

三、手机使用
1. 小火箭保持连接，WLOC 模块开启，HTTPS 解密开启，CA 证书已完全信任。
2. Safari 打开自己的 HTTPS 域名。
3. 点击地图选点 / 输入坐标，点击“储存到设备”。
4. “模块已保存坐标”只代表小火箭保存成功，实际是否生效到苹果地图核对。
5. 为排除尾插干扰，测试无外设方案时先拔下尾插。
6. 查询失败优先检查模块、证书信任、解密和连接，重新部署网页不能替代这些配置。
7. WLOC 修改网络定位响应，不能保证覆盖卫星定位；不同系统缓存和环境会影响结果。

四、把脚本也换成自己服务器
现有模块仍可继续用，不必为了打开这个网页改模块。
如要减少 GitHub 依赖：完整部署后打开 https://你的域名/WLOC-SelfHost.module。
它会根据 PUBLIC_ORIGIN 生成你自己的脚本地址。小火箭添加此模块后关闭旧 WLOC 模块，避免重复规则。
也可以手动编辑 WLOC-SelfHost.module.template，把 https://YOUR_DOMAIN 全部替换为自己的 HTTPS 域名，然后导入。
只添加 gs-loc.apple.com、gs-loc-cn.apple.com 两个解密域名；不要改为 *。
不提供或分发 CA 私钥、证书或密码，仍使用你手机自己生成的证书。

五、速度与功能边界
Leaflet JS/CSS/图标已放在本地，不需要打开网页时访问 unpkg。
默认使用高德图层，并沿用 WGS84 / GCJ-02 双向转换；可切换全球底图。
地图图片仍来自地图服务商，搜索仍来自 Nominatim，受网络和服务可用性影响。
服务器自身不会记录或持久化查询坐标，但 Nginx/面板可能默认记录 URL 访问日志；自行按需要调整。
收藏存在浏览器本地，更换域名或清理 Safari 网站数据后不会自动迁移。
坐标输入顺序为“纬度, 经度”，例如 40.712800, -74.006000。
当前链接解析主要支持苹果、高德地图。Google/百度链接不保证可解析，解析失败可直接输入 WGS84 坐标。
本包没有账号系统，请仅供自己使用；可以给整个站点添加面板访问密码。

六、恢复
网页“清除数据”清除模块保存的目标，然后关闭 WLOC 模块并重连小火箭。
如系统仍保留旧位置，再重启手机、打开苹果地图核对。清除数据本身不保证立刻恢复。

七、验证与来源
本地验证：HTTP 服务、静态资源、链接解析、坐标转换、模块生成；尚未在你的服务器和手机上验证。
来源、版本和改动见 来源说明.txt。上游源码保留在 upstream-source 中便于查看。