IP Geolocation - 掌控浏览器地理位置的 Chrome 扩展

1. 智能的自动定位#

扩展内置了自动化逻辑，能够通过 IP 地理位置 API 根据你当前的出口 IP 地址，自动获取对应的地理位置。这意味着当你切换代理节点时，浏览器的地理位置可以自动跟随变化，实现”身临其境”的伪装。

2. 灵活的手动控制与地图交互#

如果自动定位不够精准，或者你想故意定位到一个虚构的地点，扩展提供了直观的 Leaflet 地图预览。你可以直接在地图上点击选择位置，或者手动输入经纬度坐标。

3. 精细化的白名单/黑名单机制#

并不是所有网站都需要伪装。通过内置的过滤规则，你可以灵活配置：

• 白名单模式：仅在特定网站（如开发测试环境）启用伪装
• 黑名单模式：在特定网站（如需要真实导航的地图服务）禁用伪装

4. 隐私保护与本地化优化#

考虑到特定网络环境，扩展加入了一个贴心的隐私保护逻辑：当检测到当前 IP 位于中国大陆时，为了避免意外暴露精确位置，系统会默认使用北京作为兜底位置，而不是透传真实的精确坐标。

核心原理：API 注入与重写#

如何欺骗网页的定位请求？答案是脚本注入（Script Injection）。

我们利用 chrome.scripting.executeScript 在页面加载的最早期注入一段自定义的 JavaScript 代码。这段代码会劫持并重写原生的 navigator.geolocation 对象。

当网页调用 navigator.geolocation.getCurrentPosition 时，它实际上调用的是我们伪造的函数。这个函数不会去查询底层硬件，而是直接返回存储在 chrome.storage.local 中的伪造经纬度数据。

1
// 伪代码示例：重写 Geolocation API
2
navigator.geolocation.getCurrentPosition = function(success, error, options) {
3
    const mockPosition = {
4
        coords: {
5
            latitude: userSettings.lat,
6
            longitude: userSettings.lng,
7
            accuracy: 100
8
        },
9
        timestamp: Date.now()
10
    };
11
    success(mockPosition);
12
};

定时任务与状态同步#

为了保证位置信息的实时性，扩展使用了 chrome.alarms API 创建定时任务，每分钟自动检查一次 IP 变动并更新地理位置缓存。这种异步更新机制确保了用户在使用过程中不会感觉到明显的延迟。

沙箱化的地图预览#

在 Popup 弹窗中加载复杂的地图库（Leaflet）有时会受到 Chrome 内容安全策略（CSP）的限制。本项目通过 iframe 沙箱模式优雅地解决了这个问题，既保证了地图功能的完整性，又符合 Manifest V3 的安全规范。