从比特浏览器迁移：环境导入与 Local API 兼容

从比特浏览器迁移到瓦罐指纹浏览器，环境和脚本分开迁：环境导入比特导出的 JSON；脚本接 Local API，默认端口同为 54345，常用路径和返回结构兼容。导入后先检查代理、指纹和登录状态，再接入原有任务。

本页按准备文件、导入预览、接口迁移和结果核对的顺序说明。

更新于 2026-11-01

准备比特浏览器环境 JSON

支持的来源包括比特 /browser/detail 的返回、/browser/list 的返回、单个环境对象和对象数组。导入器识别环境中的指纹、代理和账号等字段，按对应关系转换为新的环境配置。文件中的 cookie 会作为 Cookie 导入，groupName 用作分组名。

导出前先记录需要迁移的环境名称、平台账号和代理对应关系。列表返回与详情返回包含的信息可能不同，文件中没有的数据不会因为导入而补齐。需要保留登录状态时，应检查源文件是否实际包含 Cookie，不要只看文件名或环境数量。

本软件的 .fgbx、JSON 与通用表格属于另外的导入来源。若拿到的是表格，也可以走列映射流程；需要了解文件备份与登录数据的区别，可参阅云同步与环境文件。

导入预览与字段检查

比特指纹字段会按支持范围转换，其中设备模板、语言、时区、WebRTC、定位和噪声等字段有对应处理。未支持的指纹字段会被忽略，并按模板生成相关参数，因此不应把导入理解为所有底层指纹数值逐项原样复制。

在环境页选择「导入」，选中准备好的 JSON 文件，查看来源识别和逐行预览。先核对名称、分组、代理与 Cookie 数量，处理格式错误后再提交。
设置默认分组与同名处理方式。同名环境可以自动改名加序号、跳过或保留原名；首次迁移建议保留清楚的来源标记，便于与旧环境逐一对照。
确认剩余可建环境数量，再执行导入。超出可用数量的行按文件顺序不导入，应根据结果整理剩余文件，避免重复提交已经创建的环境。

兼容的 Local API 路径

在「设置 → Local API」里开启服务。默认端口为 54345，与比特浏览器一致；端口已被其他程序使用时需要改为可用端口。请求使用 JSON，鉴权可以通过 x-api-key 或 Authorization: Bearer 请求头传入新密钥。

常用打开与关闭路径包括 /browser/open、/browser/close、/browser/close/byseqs 和 /browser/close/all。查询路径包括 /browser/list、/browser/detail、/browser/pids、/browser/pids/all、/browser/pids/alive 和 /browser/ports。

新建与修改支持 /browser/add、/browser/modify、/browser/update、/browser/update/partial，以及 /browser/proxy/update、/browser/remark/update、/browser/group/update。Cookie 支持 /browser/cookies/get、/browser/cookies/set 和 /browser/cookies/clear。完整请求与连接示例见Local API 教程。

原有脚本需要检查的差异

导入后的环境有自己的 ID 和编号。把旧脚本里的环境标识替换为新值，更新地址与密钥，先调用列表和详情确认目标，再测试打开与关闭。不要沿用旧软件里的环境 ID，也不要把上次取得的调试端口固定在脚本里。

打开接口返回的 ws 和 http 指向本机 CDP 网关，可以交给 Puppeteer 或 Playwright 连接。网关只暴露网页标签，环境窗口的地址栏和标签栏不会作为页面返回。环境重开后端口可能改变，每次连接都应使用本次返回的地址。

当前不支持无头模式，也不支持在一个环境内部再创建独立浏览器上下文。打开参数中的其他启动参数会被忽略。业务失败可能返回 HTTP 200，同时给出 success: false，脚本应检查业务结果，并处理环境被其他设备占用等错误。

还有几项接口差异需要检查：打开环境返回的 driver 为 null，应通过 CDP 连接；/browser/list 不含密码类字段，需要详情时调用 /browser/detail。browserTag/*、rpa/*、autopaste 和 alldisplays 暂未提供，依赖这些接口的任务需要调整实现，不能只更换连接地址。

迁移后的核对顺序

批量任务应在单个环境验证通过后逐步接入。若要把日常任务改成插件运行，可查看指纹浏览器自动化。

先打开少量环境，确认平台、账号名、启动网址和分组符合预期；打开目标网站，检查实际登录状态，必要时按平台流程重新验证。
检测代理出口 IP，核对国家或地区，再检查时区、语言和定位设置。代理地址导入成功不等于代理仍然有效，具体排查见代理配置教程。
核对设备模板、指纹参数与噪声设置，修改后重启环境。登录状态确认后，再运行原有脚本的一次完整流程，检查页面选择、输入和关闭后的同步。

常见问题

比特浏览器的脚本能直接用吗？

调用常用兼容路径的脚本可以按原有结构接入，但需要更新密钥、环境 ID，并核对端口、返回字段与启动参数。先用一个环境验证打开、网页操作和关闭流程，再扩大运行范围。

比特浏览器导出的 JSON 能保留登录吗？

导入器会读取文件中的 Cookie，但源文件没有的登录数据不会自动补齐。导入后需要打开目标网站检查登录状态；只包含环境配置的文件不能保证网站继续保持登录。

两个浏览器都用 54345 端口怎么办？

同一台电脑上的两个服务不能同时占用同一监听端口。可以关闭暂时不用的 Local API，或在瓦罐指纹浏览器的「设置 → Local API」里更换端口，并同步修改脚本地址。

导入后指纹会和比特浏览器完全一样吗？

不能按所有参数完全一致理解。受支持的比特指纹字段会转换，未支持的字段按设备模板生成。迁移后应检查设备模板、语言、时区、噪声和代理出口，再验证实际使用流程。