指纹浏览器迁移与通用表格导入

整理要迁移的环境和文件

先列出环境与业务账号的对应关系，包括名称、分组、平台、登录网址、代理用途以及是否需要恢复登录。每个原环境保留清楚的名称标记，便于导入后逐项对照。已有文件里缺少的资料，应从自己的业务记录补齐，不要用其他环境的账号或代理临时填充。

通用导入以文件中实际提供的数据为准，不限定原来使用哪款软件，也不代表任何软件都能直接导出相同格式。先查看拿到的文件，再选择整理成 CSV 或扁平 JSON；原软件的专有嵌套配置不能只修改扩展名就当成通用表格。

已有对应来源的文件时，可分别查看比特浏览器迁移和 AdsPower 迁移。这两种来源的字段处理与通用列映射应按各自说明核对。

准备 CSV 或扁平 JSON

CSV 第一行写表头，后面每行表示一个环境。名称、分组、平台、账号、代理、系统模板、语言、时区和 Cookie 都有对应导入字段。名称不能为空；并非每个字段都必须填写，暂时没有的数据可以留空，但留空的代理不会自动取得原环境使用的出口。

扁平 JSON 使用对象数组，每个对象表示一个环境，各列使用直接的字段值。普通业务字段不要再套多层对象；Cookie 可以作为数组提供。表格只是整理入口，不会因为写了原来的环境编号，就从另一款软件中读取其余数据。

在「导入环境」里可以下载模板，按模板整理比临时猜测字段更容易检查。下面只展示 CSV 的表头结构，实际导入时还要在表头下添加自己的环境记录。

名称,分组,平台,账号,登录网址,代理类型,代理主机,代理端口,代理账号,代理密码,系统,语言,时区

核对自动识别与手动列映射

在环境页选择「导入」，点「选择文件」。通用表格会先按表头匹配字段，中文的「环境名称」「平台账号」和英文的 name、username 等都能识别。界面显示「前几行预览」，可以据此判断整列是否对应正确。

自动匹配后仍要逐列核对，尤其是平台账号与代理账号、平台密码与代理密码。来源表格采用内部缩写或自定义表头时，手动选择对应列；不需要的字段选「不导入」。确认后点「下一步：校验」，根据行号处理名称为空、网址错误或代理格式错误。

分组也需要检查。文件没有填写分组的行进入所选「默认分组」；没有管理分组权限时，无法按文件新建的分组也会改用默认分组。分组用于整理环境，团队成员能否使用这些环境还要另行配置权限。

处理整条代理串与拆开的代理列

代理可以放在一列，也可以拆成「代理类型」「代理主机」「代理端口」「代理账号」「代理密码」。拆分导入时，主机和端口分别填写，协议使用 HTTP、HTTPS 或 SOCKS5。代理认证信息要与网站登录信息分开，不能把提取接口链接填进代理主机列。

如果已经映射了整条「代理」列，导入器优先使用这一列，不再拼接拆分列。原表只有拆分信息时，应取消整条代理列的映射，再检查预览中的连接地址。整条代理列也可以引用代理库中已有的名称，但需要确认名称对应的代理正是该环境要使用的记录。

文件能被解析只说明字段格式符合要求。导入后还要检测连接是否有效、认证是否通过，以及实际出口所在地区。具体操作见代理配置教程。

选择设备模板并检查 Cookie

通用表格没有完整指纹配置时，会按设备模板生成指纹。可用模板包括 Windows 10、Windows 11 和 Apple 芯片 Mac。检查原业务需要的系统类型，再选择模板；迁移不能理解为其他内核里的所有指纹数值原样复制。语言、时区也要与之后使用的代理出口核对。

文件包含 Cookie 时，导入预览会显示识别数量。先检查对应的是哪一个网站和账号，再打开目标网站验证登录。账号密码字段已导入，不等于 Cookie 已导入；Cookie 存在，也不等于网站会话仍有效。格式处理可查看Cookie 导入与导出。

通用表格不携带完整本地存储。网站还使用其他存储或要求再次验证时，按网站流程处理。后续在自己的设备之间换电脑，可以使用云同步，但云同步不会替源文件补回未迁移的数据。

确认导入结果和日常使用流程

提交前检查同名环境处理方式、默认分组与剩余可建环境数量。导入后查看实际创建、跳过和失败的结果，尤其留意 Cookie 未导入成功等提示。需要重试时，只处理仍未完成的记录，避免重复建立已经迁入的环境。

1. 先选少量环境，打开后核对平台账号、启动网址、设备模板与实际出口 IP，再检查登录状态。
2. 把迁入环境分配给对应成员，确认团队里谁负责使用和维护，避免旧环境与新环境同时开展重复操作。
3. 已有自动化任务时，更新任务使用的环境标识，按Local API 教程检查连接和调用结果，再逐步恢复批量任务。

常见问题