企业手里往往已经有一套代理资源：代理商分配的静态住宅、按地区采购的线路、自建的专线出口，或者网络团队统一维护的代理池。自有代理导入要做的，就是把这些已有出口接进无界，让每个环境用上指定线路，而不必再买一份内置代理。
它和「海量代理 IP」解决的不是同一个问题：内置代理解决「有没有可用出口」，自有代理导入解决「怎么把企业自己的出口管起来」。两者可以在同一账号里并存，按环境分别绑定。
支持的代理类型与地址格式
协议必须与代理服务提供的一致。HTTP 代理被填成 SOCKS5，表现通常是连接超时或握手失败，而不是鉴权错误，排查时容易误判成网络不通。
| 协议 | 鉴权方式 | 地址示例 | 说明 |
|---|---|---|---|
| HTTP | IP 白名单或用户名密码 | http://user:pass@host:port | 常规网页业务与后台管理，配置后必须预检 |
| HTTPS | 用户名密码 | https://user:pass@host:port | 协议指代理本身的加密方式，与目标站点无关 |
| SOCKS5 | 用户名密码 | socks5://user:pass@host:port | 通用转发场景，鉴权字段与 HTTP 不同 |
| 无代理 | 无 | — | 仅用于本地调试与内网访问 |
主机字段只填代理服务器地址，不要带 http:// 前缀；如果使用地址串导入，则按上面的完整格式填写。切换协议后，原来的鉴权字段可能不再适用，需要重新核对用户名与密码。
代理库：先入库，再绑定
自有代理统一存放在代理库，环境通过引用使用。同一条代理修改一次，所有引用它的环境同步生效；更换账号密码、调整端口不需要逐个环境重复填写。
单条添加与粘贴识别
添加代理时可以直接粘贴代理商提供的文本，客户端会识别 host:port、IP / 端口 / 账号 / 密码、表格行等常见格式并填好字段。识别结果入库前请逐项核对，尤其是协议类型与端口。
多行批量入库
一次可以粘贴多条，保持一行一条代理，不要把主机、端口与账号密码拆到不同行。入库后先做一次连通检测，确认线路可用，再绑定到环境。
命名与去重
建议按「地区-平台-序号」命名，例如 us-amazon-01。同一条线路重复入库会被拆成多个条目，健康统计与故障排查都会变得分散，导入前先核对清单。
分组与标签
按地区、平台或部门给代理分组，绑定环境时更容易筛选，团队授权也能按组下发。分组是管理手段，不改变出口本身：同一个分组里的线路仍可能位于不同地区，绑定前以预检结果为准。
绑定环境
- 一个环境固定使用一条出口，切换环境不会串用代理；
- 克隆环境时可以选择复制原代理，或为新环境重新绑定；
- 不建议多个环境共用同一出口，尤其是同一平台的多店铺账号；
- 测试线路与正式线路分开分组，避免误绑到生产环境。
需要批量绑定代理时，可以在环境导入的 CSV 中一并填写代理地址，具体字段见下方「批量导入」。
启动前预检
预检在启动环境之前执行，只验证代理与基础配置，不会打开目标业务网站。报告主要包含以下内容：
| 检查项 | 期望结果 | 异常时的处理 |
|---|---|---|
| 连通性 | 连接建立成功 | 核对主机、端口与协议；确认本机能访问该代理 |
| 鉴权 | 用户名密码通过 | 补全或更正凭据，检查是否带入了空格与换行 |
| 出口 IP 地区 | 与业务目标地区一致 | 更换线路，或按出口地区调整环境时区与语言 |
| 延迟 | 处于可用范围且波动不大 | 更换节点，避开高峰时段，检查本机带宽占用 |
| 一致性 | 出口地区、时区、语言相互对应 | 按出口地区重设时区与语言，不要只改其中一项 |
预检通过只代表代理链路与基础配置可用，不代表账号一定安全。运营行为、操作频率与登录习惯仍然需要团队自己控制。
批量导入
环境批量导入支持在 CSV 中一并填写代理信息，适合一次性建设大量环境，单次最多 200 行，超过需要拆分为多次导入。
- 下载 CSV 模板，确认表头字段与当前客户端版本一致；
- 一行填写一个环境，代理地址按代理服务提供的完整格式填写；
- 先导入 5 到 10 行做小批量验证，确认格式与出口都正确；
- 导入完成后统一执行预检，按失败原因逐行修正；
- 修正后可以只导入失败行，不必重新导入整批。
环境名称,分组,代理地址,指纹种子,备注代理地址通常写成 http://用户名:密码@主机:端口 或 socks5://用户名:密码@主机:端口。密码含特殊字符时，优先在代理库中逐字段填写，或确认 CSV 是否需要用引号包裹整列，避免被逗号截断。
团队权限与凭据
- 凭据加密：代理商账号与密码加密保存，列表中不显示明文；
- 按组授权：成员只能使用被授权分组内的代理，修改权限单独控制；
- 变更留痕：代理新增、修改、删除与绑定变更写入审计日志；
- 交接复核：成员离职或服务商更换时，统一更换凭据并复查引用范围。
更换与下线代理
- 先把新线路加入代理库并完成预检；
- 在环境详情切换绑定，或克隆环境后绑定新线路；
- 关闭原环境再重新启动，不要在旧窗口上继续操作；
- 在业务低峰期观察登录与操作是否正常；
- 确认没有环境引用后，再从代理库删除旧线路。
出口变化可能触发业务站点重新验证，属于预期行为。不要用重新生成指纹来掩盖出口变化：指纹是设备特征，出口是网络位置，两者解决的是不同问题。
常见错误与处理
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 导入后连接超时 | 协议、主机或端口填写错误，代理对本机不可达 | 核对服务商提供的字段；用其他工具测试同一代理 |
| 返回 407 | 代理要求鉴权，但凭据未填或填错 | 补全用户名与密码，检查复制时带入的空格 |
| 出口地区不符 | 部分服务按目标站点分配出口，或节点已被替换 | 以预检报告的出口为准，更换稳定线路 |
| 时区语言不一致 | 环境参数与出口地区矛盾 | 按出口地区重设时区与语言，重新预检 |
| 只有部分环境失败 | 个别环境配置错误，或代理并发受限 | 对比失败与正常环境的配置，逐项排查 |
排查顺序建议从连通性开始：先确认能不能连上，再确认鉴权是否通过，最后才看出口与一致性。跳过前两步直接调时区，通常只是白费时间。
常见问题
支持哪些代理协议？
支持 HTTP、HTTPS 与 SOCKS5。带账号密码认证的代理可直接填写用户名与密码，凭据在本机加密保存。
一个代理能给多个环境共用吗？
技术上可以，但不建议。多个环境共用同一出口会削弱隔离效果，尤其是同一平台的多店铺账号。建议一条代理只服务一个环境。
代理工具能连上，客户端预检却失败
先对比协议、端口与鉴权字段是否完全一致，再确认代理服务是否按来源 IP 做了白名单限制或并发限制。同一代理在多个环境都失败时，问题大概率在代理服务侧。
代理密码含特殊字符怎么填？
优先在代理库中逐字段填写，避免地址串解析时被 @、: 等字符截断；使用 CSV 时注意引号与分隔符，必要时先用一行数据验证。
动态代理怎么接入？
在代理库中配置渠道提取链接，客户端可按需自动提取新的出口 IP，无需手动替换。建议固定目标地区，避免每次提取后出口地区变化。
免费版可以导入自有代理吗？
可以。免费版即可导入并预检代理，环境数量、并发与团队功能以当前套餐为准，具体额度见定价页。
相关文档
代理协议、预检与批量导入的完整说明见代理配置与预检；环境与代理的绑定关系见环境管理；代理凭据的加密与引用见账号保险箱；按部门授权见团队成员与部门；代理变更的追溯见操作日志与审计。