浏览器扩展:导览
扩展是浏览器里的 URnetwork,ur.io 的 Web 应用是它的控制面:一件产品,两个半边。这一页是深度导览:各浏览器里的代理机制、各控制项及其出厂默认值、断网保护承诺什么和不承诺什么,以及出问题时查什么。它背后的网络、提供者是谁、各方能看到什么,读概览。商店链接、登录和首次连接,从浏览器入门开始。
始终要拿稳的框架:这是浏览器代理,不是 VPN。 代理是替浏览器取回网站的中间人,所以网站看到的是它的地址而不是你的。扩展配置的是浏览器自己的代理设置,所以它治理的恰好是这个浏览器发出的东西,不多不少。覆盖:这个浏览器的每个标签页和窗口,无痕窗口也算,Chromium 上始终如此,Firefox 上在你允许隐私窗口后如此。不覆盖:其他浏览器、你的邮件应用、系统更新、其余一切——不受保护,也不受干扰。按浏览器安装;整机覆盖是 URnetwork 应用的工作(Android、iOS、macOS、Windows、Linux):同一个账户、同样的断网保护、往下一层。

设置一览
扩展有意保持小的表面。两个控制项,都在弹窗里:
| 设置 | 默认 | 效果 | 主要代价 |
|---|---|---|---|
| 断网保护(Kill switch) | 关 | 代理断开时阻止浏览器流量,而不是回落到你的直接连接 | 故障期间标签页报错 |
| 地理位置覆盖(Geolocation override) | 关 | 浏览器的地理位置 API 报告你的出口城市,而不是你的真实位置 | 想让站点看到真实位置时得关掉;保持最新需要开着一个 ur.io 标签页 |
随表附送的注意事项:
- 有两个应用里的开关在浏览器里没有对应物,这是设计使然。这里没有后量子加密(Post Quantum Encryption),因为扩展没有可密封的客户端到提供者会话;完整的适用范围说明在下文"数据收集"。也没有强匿名化(Strong Anonymization)开关,因为扩展所依托的托管代理设备上直连模式被强制关闭:任何提供者都永远拿不到你的真实地址。
- 断网保护一旦打开,就会跨浏览器重启保持,所以故障期间你保持被阻断而不是被暴露,直到你断开或路径恢复。
- 流量用完不是故障,也不由这个开关决定:无论开关怎么设,代理都保持设置,弹窗也会说明这一点(见流量用完)。
工作原理
扩展在每个浏览器上都是 Manifest V3。每个安装同一时间只持有一个托管的 URnetwork 代理,首次连接时创建,之后的连接再次套用它,浏览器拿到的就是这唯一的代理。管线不同,因为浏览器的 API 不同:
- Chrome 和 Edge(以及 Chromium 系浏览器)使用代理设置 API:扩展把这个代理设为浏览器唯一的固定代理,并为本地地址和 URnetwork API 设了绕行列表。设置它就占据了浏览器的代理配置,这也是两个代理扩展无法共存的原因(见疑难解答):扩展只在浏览器允许时才设置它;当另一个扩展以更高的优先级持有这项设置,或者政策固定了这项设置时,扩展不会连接,弹窗会说明是哪一种情况。固定代理自己没有回落路径,所以它不应答时,请求就会失败,直到下面的健康检测出手。扩展从不碰操作系统设置,撤销得干干净净:断开就释放占据,浏览器自己的代理设置重新生效(系统代理或公司代理,或者没有代理),卸载就移除占据。
- Firefox 没有对应的设置交接机制,所以它用
proxy.:每个请求都询问扩展,扩展应答的就是这一个代理。断网保护关着时(出厂即是如此),应答里代理后面跟着onRequest direct,所以代理接不住的请求会走直连;开着时,应答只有代理本身,代理挂掉期间请求就会失败。
没有 Safari 版本,因为 Safari 缺这些 API。在 Apple 设备上,应用覆盖一切,包括 Safari。
浏览同时从一小窗提供者出网:主人主动开启共享、参与 UR protocol 的成员设备。"你的出口 IP"是复数的,按站点固定让每个站点停留在一个出口上,所以你的银行看到一个一致的地址。
URnetwork SDK 以 WebAssembly 形式装在扩展包里。配置、位置列表和 API 调用都在本地运行。运行时不下载任何可执行的东西;商店审核的是什么,跑的就是什么。
Web 应用是扩展的控制面;它们是一件产品。 在 ur.io 登录一次,页面和扩展就经一座有文档的桥对话:一套简短的动词协议(SETUP、CONNECT、DISCONNECT、SET_LOCATION、断网保护、地理同步),由 window. 承载,这是在 Chrome、Edge、Brave 和 Firefox 上都通的唯一通道。SETUP 把已登录的会话直接递过去,这就是从应用设置扩展从不向你要授权码的原因。分工是真实的:扩展铸出代理会话并安装浏览器代理,应用持有活的设备。在应用里换位置会直接重路由,浏览器无需重连,而且每个半边都显示你在另一边做了什么。
这座桥刻意做窄。 它只在 ur.io 和 manager. 页面上运行;其他任何站点都无法与扩展对话。另有一个脚本确实加载在每个页面上,即地理位置覆盖,但在你打开它之前(见下文),它保持不活动,原生接口原封不动。
登录需要账户,因为用量按账户计量:邮箱或手机号加密码、ur.io 的某个 SSO 选项、钱包签名,或在已登录设备上生成的授权码。这里的免邮箱路线是钱包和授权码;一键免邮箱的即时账户在手机和桌面应用里创建,扩展像接任何账户一样接上它。免费是每日流量额度;Pro 在此之上再加大额月度额度(每月 $5 或每年 $40;当前数字在 ur.io/products)。
断网保护的语义
它做什么:断网保护开着时如果代理连接断了,扩展会阻止浏览器的流量,而不是让浏览器悄悄回落到你的直接连接、在会话中途暴露你的真实地址。
- 它默认关闭:在弹窗里把它打开,副标题就会从出现故障时流量可能泄漏(Traffic may leak on failure)变成出现故障时阻断流量(Blocks traffic on failure)。
- 执行靠的是浏览器自己的代理规则:上膛后,它没有"不行就直连"的后门,所以请求失败而不是回落。它跨浏览器重启保持。你回来时是被阻断的,不是被暴露的。
- 如果它触发,只有这个浏览器停下(标签页报错;弹窗说明原因)。你电脑的其余部分从来就没走过它。
- 让它保持关闭意味着放行失败:连接断掉会把你还原到浏览器自己的连接(对大多数人来说就是直连),弹窗里看得见,标签页里悄无声息。只有当泄漏只是不便而非伤害时才可接受。
- 流量用完是例外,开关开着关着都一样:代理保持设置,什么都不会回落(见流量用完)。
- 范围局限:它阻止的是浏览器流量,这是扩展所能治理的全部;它不是系统防火墙。本地地址(localhost、打印机)有意绕过,而 WebRTC(浏览器内的语音/视频)可能打开无视代理设置的连接,这是每个代理扩展都有的缺口;浏览器可以限制它。
地理位置覆盖
两个信号:你的 IP 地址现在说阿姆斯特丹,但浏览器的地理位置 API 由附近 Wi-Fi 等系统信号应答,仍然报告你身体所在。比对这两者的站点会看到矛盾。覆盖修正第二个信号,让两个故事一致:
- 默认关闭。 在弹窗里启用之前什么都不变。
- 启用后,它在
document_时在所有 frame 里应答,所以地理位置 API 在任何页面脚本来得及问之前就给出你的出口位置,包括试图抢跑的 iframe。坐标是你连接最久的提供者所在城市,经应用桥到达扩展:扩展自己不持有设备,所以保持位置最新靠的是一个开着的 ur.io 标签页。start - 停用时,它一言不发:页面保留原生地理位置,也没有站点会收到一个"你装了扩展"的新信号。当你想让站点看到真实位置时(地图、外卖),把它关掉。
健康检测与降级状态
连接期间,扩展每分钟经代理抓取一个轻量端点(URnetwork API 上的 my-ip-info),即使对免费额度也可以忽略不计;浏览器一报告代理错误,它还会立刻再抓一次。这证明的是路径端到端可用,而不只是设置生效了。一次抓取失败或超过八秒没有完成,就记为一次失败;一次成功就把计数清零。同一时间只运行一次检测:检测运行期间到达的代理错误共用这一次检测。故障期间,每个页面的请求都会失败,检测自己的抓取也一样,所以失败最多每 45 秒计一次,这段时间里的代理错误也不会启动检测:一阵密集的错误只计一次,而连续三次失败照检测计划要花两分钟。三次之后,由断网保护决定:
- 关着(出厂即是如此):扩展撤下代理,释放浏览器的代理设置,浏览器改为不经 URnetwork 连接。不会自动重连:弹窗显示已断开连接(Disconnected),按钮下方写明原因。重新连接会再次套用这个安装的代理;如果服务器已经没有它了,就新建一个。
- 开着:代理保持设置,浏览器流量停住,直到代理应答。这就是降级状态:弹窗的状态行显示代理无响应(Proxy not answering),按钮下方写明原因。这期间什么都不会重连;下一次成功的检测会把它变回已连接(Connected)。
第三次失败之前,无论开关怎么设,Chromium 浏览器的请求都会卡在不应答的代理上失败,因为固定代理自己没有回落路径。在关着断网保护的 Firefox 上,每个请求会自己回落到直连,所以检测经直连路径通过,代理保持设置;这时的迹象是弹窗里的代理已启用,但无法访问网络。这条提示(见疑难解答)。
降级不是泄漏。你仍然指向代理,死路是阻断而不是暴露。想在它恢复之前上网,就断开:断开会回到浏览器自己的连接。
检测失败时,扩展会先查询账户是否还有剩余流量,而没有流量的账户并不是死路:见下一节。
流量用完
流量用完时,在流量恢复之前代理什么都不会承载,而扩展的做法和 URnetwork 应用一样:保持代理设置,提醒你,并把是否断开交给你决定。无论断网保护怎么设,它都绝不会因此回落到你的直接连接,因为一次并非由你做出的断开可能会泄漏你的流量。在 Firefox 上,只要这种情况持续,按请求回落到直连的做法也一直关闭。
扩展在检测失败时读取你的账户余额,以此把这种情况和不应答的代理区分开:剩余不到 1 MiB 就算流量用完,服务器正是在低于这个界限时拒绝新连接,ur.io 的连接屏幕也是这样判断的。这时弹窗会显示:
- 余额不足(Insufficient balance),显示在状态行里和提醒上方,在 Pro 上则是已达到数据上限(Data limit reached);
- 流量何时回来:免费数据将在 5小时12分钟 后更新。,倒计时到 00:00 UTC,在 Pro 上则说明流量包现在就能增加更多流量;
- 在有可用数据或您断开连接之前,此浏览器中的页面不会加载。;
- 升级为 Pro(Get Pro)和购买数据(Buy data),它们会打开 ur.io(Pro 上从不显示升级为 Pro)。经由扣住流量的代理,ur.io 同样无法加载,所以提醒会写着要升级,请先选择“断开连接”。在此之前,付款无法完成。(在 Pro 上则是要购买数据,…)。断开之后,提醒仍留在打开着的弹窗里,所以它的链接能够加载。
它还会为每一次流量用完发送一条浏览器通知,而且只在浏览器已经允许扩展发送通知时才发:扩展从不请求这项权限。下一次检测通过时(你的流量回来了:免费刷新、升级或流量包),读到的余额重新有流量时,或者你连接或断开时,提醒就会结束。余额读取没有返回时,提醒继续保留。如果流量已经回来而代理仍不应答,失败就从那时起按上文的方式计数。
数据收集:没有
- Firefox 上架条目在 manifest 里以机器可读的方式声明:
data_是 none。那是商店强制执行的陈述,不是隐私页上的承诺。collection_ permissions - 扩展只与 URnetwork API 对话来配置你的代理,和任何客户端相同的调用。没有分析、没有遥测、任何地方都没有浏览历史收集。
- 主机权限按浏览器不同,有其原因。 在 Chrome 上,扩展只请求访问 URnetwork API 主机(
api.、bringyour.com api-v4.bringyour.com);代理设置 API 不需要看见你的请求。在 Firefox 上扩展需要<all_urls>:proxy.会为每个可能路由的请求询问扩展,而 Firefox 要求有主机访问权它才能工作。那里更宽的权限是 Firefox 代理 API 的代价,不是抓数据。onRequest - 没有第三方评估过这个扩展。 URnetwork 的 Android 应用在 2025 年 5 月通过了 Leviathan Security Group 的 MASA AL2 评估(Google 为移动应用定的固定安全清单),2025 年 4–5 月一家独立公司渗透测试了 Web 应用和 API;两者都不覆盖扩展,而且尚无独立审计覆盖协议或运营方的服务器代码。这一页给出的替代是可证伪的:那些权限在你自己安装的副本里就能读到,运行时不下载任何东西,源码是公开的。是你能核查的说法,不是一纸证书。
服务保留什么:你的账户和一份按设备的字节数账本(也就是额度和提供者计量),从不含目的地或 URL;一个以你 IP 地址块的带密钥单向哈希形式保存的客户端地址,而不是地址本身;以及地理查询得出的一个粗略城市。提供者在不知道你真实地址的情况下出网,只看到 ISP 级的元数据(站点名,从不是页面或密码,那些仍被 HTTPS 密封);网站只看到出口。
不过,对中间那一方要说得精确。网络有三种模式,浏览器永远只占其中一种:
| 模式 | 运营方看到 | 提供者看到 | 此处可用 |
|---|---|---|---|
| 中继标准 | 你的账户和来源连接、你在用哪些提供者,以及里面的目的地和数据包字节 | 它出网的目的地和一个设备/合同 id,不含你的真实 IP | 可用:唯一的浏览器模式 |
| 中继密封 | 同上,但目的地换成密文及其时序和数据量 | 同上 | 不可用:应用那种加密到提供者的会话(在应用里是一个出厂关闭的开关)在浏览器没有对应物 |
| 直连 | 更少的中继参与 | 你的真实 IP及它出网的目的地 | 不可用:在扩展所依托的托管代理设备上被强制关闭 |
第一行就是浏览器的位置,与应用的对比是锋利的而不是含糊的:应用可以借一个出厂关闭的开关来密封客户端↔提供者会话,而浏览器在那里没有可密封的会话。它不可能有。浏览器说的是自己的代理协议,跑不了网络的引擎,所以你的客户端设备远程运行在运营方内部,由运营方在两种协议之间转换 — 从那台设备发起的密封会始于运营方,而密封的存在恰恰是为了让运营方失明。这个实现用密封换来了对浏览器的支持。这里的保证是存储层面的,不是加密层面的。任何浏览器代理都会把每个目的地递给它拨号的端点,所以你的目的地在途中经运营方之手;站在这背后的,是一条什么日志都不写、被开源代码里的回归测试钉住的代理数据路径,和一本没有任何字段能放目的地的账本。应用的强匿名化开关同样缺席、同样不需要:直连模式被强制关闭后,任何提供者都永远拿不到你的真实地址。
你的流量流动起来之后网络本身能看到什么、不能看到什么,读概览。威胁模型走得更远,把浏览器路径缺失的密封列为它自己的失败之一。
疑难解答
"连接失败。请检查您的账户。",或服务器给出的原因
连接失败时,原因会显示在按钮下方,旁边有重试。如果是服务器拒绝了代理,原因就是服务器自己的说法,并写明该怎么做:套餐的活跃代理上限已满,那就在 ur.io 的代理(Proxies)页面删掉一个不再用的,或者升级;或者套餐的每分钟新建代理上限已满,那就过一分钟再试(见限制)。没有收到任何原因时,显示的是连接失败。请检查您的账户。:
- 确认你能在 ur.io 登录,查看你的套餐。
- 登出扩展再登录,刷新凭证。
换到另一个位置时连接失败(因套餐上限而失败的除外),浏览器会留在原来的代理上:弹窗保持已连接,仍保留断开连接(Disconnect)按钮,并在显示原因的同时附上浏览器仍连接到之前的位置。
"代理已停止响应,因此扩展已将其关闭。在您重新连接之前,此浏览器的连接不经过 URnetwork。"
断网保护关着时健康检测连续失败了三次,所以扩展撤下了代理,这个浏览器按自己的设置连接,不经过 URnetwork。弹窗会在已断开连接(Disconnected)下方显示这条原因,即使当时它没打开,直到你再次连接。多半是你的底层网络变了(换了网络、笔记本睡眠、不友好的 Wi-Fi)。流量用完不会造成这种情况:它会显示自己的提醒(见流量用完)。从弹窗重新连接;如果在某一个网络上反复出现,那个网络可能在封锁代理端口。
"余额不足"或"已达到数据上限"
你的账户流量已用完,在流量恢复或你断开连接之前,代理会扣住这个浏览器的流量(见流量用完)。要升级到 Pro 或购买流量包,先按断开连接,再按升级为 Pro或购买数据:经由扣住流量的代理,ur.io 加载不出来。或者等待 00:00 UTC 的免费刷新;下一次通过的检测会把弹窗变回已连接,你什么都不用做。
另一个扩展正在控制代理
同一时间只有一个扩展能控制浏览器的代理设置(Chrome 上最近安装的那个赢)。在 Chromium 上,扩展会检查是谁持有这项设置:当另一个扩展以更高的优先级持有它时,状态行显示另一个扩展正在控制代理(Another extension controls the proxy),同时附有另一个扩展正在控制此浏览器的代理设置,因此 URnetwork 无法连接。请关闭该扩展以使用 URnetwork。连接请求在设置任何东西之前就会被拒绝,浏览器启动时也不会覆盖它重新连接。如果另一个扩展接管时 URnetwork 正连着,断开连接会撤掉 URnetwork 压在它下面的那项设置,这样另一个扩展撤走后,这项设置也不会重新生效。chrome:// 会写明当前持有者;停用另一个。当管理员的政策固定了代理设置时,状态行显示代理由政策管理(Proxy managed by policy),扩展在那个浏览器里无法连接。
在 Firefox 上,每个扩展都按请求应答,而 Firefox 不会告诉你还有哪些附加组件在这样做:检查已安装的附加组件里有没有带代理权限的。迹象在弹窗的 IP 行:你的请求不经 URnetwork 出去时,它的圆点会变灰,随后还会出现代理已启用,但无法访问网络。这条提示(见“读懂状态”)。
强制登录门户
酒店和机场 Wi-Fi 要你先经门户页登录,互联网才通,而代理开着时(尤其是上膛状态),门户加载不出来。你不会被卡死:断开是本地动作,不需要网络。断开扩展,完成门户登录,再重连。这是每个代理和 VPN 的固有情况,不是扩展的 bug。
读懂状态
弹窗底部的状态行是最快的诊断。弹窗的标签和消息跟随浏览器的语言;本页按它们在中文界面中的显示引用。在后台应答之前,刚打开的弹窗既不显示状态,也不显示连接(Connect)或断开连接(Disconnect),只显示一个中性的按钮。
- 已断开连接(Disconnected):代理已撤下,浏览器按自己的设置连接。如果连接失败了,或者健康检测撤下了代理,原因会显示在按钮下方,旁边有重试。健康检测撤下代理之后才打开的弹窗也会显示这条原因,直到你再次连接。
- 正在连接…(Connecting…):在套用这个安装的代理,或新建一个。
- 已连接(Connected):浏览器已设置为走代理。
- 代理无响应(Proxy not answering):降级状态。断网保护开着,代理连续三次检测失败,所以这个浏览器被阻断,直到代理应答或你断开。按钮下方的原因写着代理无响应。在代理恢复响应之前,断网保护会让浏览器保持离线。这期间什么都不会重连。故障期间打开的弹窗会立刻按上一次检测显示这些。
- 余额不足(Insufficient balance),在 Pro 上则是已达到数据上限(Data limit reached):账户流量已用完,代理扣住这个浏览器的流量(见流量用完)。
- 另一个扩展正在控制代理(Another extension controls the proxy),或代理由政策管理(Proxy managed by policy):扩展无法设置浏览器的代理(见“另一个扩展正在控制代理”)。
如果对断网保护或位置同步开关的更改无法保存,开关会恢复原状,弹窗会显示无法保存该设置,因此设置未更改。请重试。
按钮下方也可能出现一条提示:代理已启用,但无法访问网络。弹窗自己的 IP 检查在它开着时每 15 秒一次,连续三次发现你的请求没有经 URnetwork 出去。在关着断网保护的 Firefox 上,失效的代理就是这样显露的:请求已经走了直连。
接下来去哪里
- 浏览器入门:商店链接、登录和首次连接,包括隐私窗口那条说明。
- URnetwork 的工作原理:弹窗背后的网络,以及提供者从哪里来。
- FAQ:套餐、额度和账户问题。