代理管理

对应页面：左侧菜单里的「代理管理」（ProxyManagement），以及新增/修改代理弹窗。用于集中管理公司或团队使用的所有代理。

📌 这个页面是做什么的？

• 把公司/团队的所有代理统一录入到系统里集中管理。
• 给团队成员一个统一的“代理地址通讯录”，避免每个人自己保存一份。
• 支持快速测试代理是否可用、是否真的换了 IP。
• 支持按类型筛选、导出列表、删除（删除后进入回收站，可在回收站里再处理）。

你可以把“代理管理”理解成：公司代理服务器的通讯录 + 可用性检测工具。

---

🚪 功能入口与页面结构

• 功能入口：左侧导航中的 「代理管理」。
• 顶部：
  • 左侧为 代理类型筛选；
  • 右侧为 新增 和 导出 按钮。
• 中间：
  • 代理列表表格（每一行是一条代理配置）。
• 底部：
  • 分页控件，用于翻页查看更多代理。

列表中一条代理通常包含：代理类型、IP 查询渠道、主机、端口、账号、备注、创建人/时间、更新人/时间等信息。

---

⚡ 快速上手：新增一条代理

新增代理的入口是工具栏右侧的 「新增」 按钮，对应新增/编辑弹窗。

步骤 1｜打开新增弹窗
在「代理管理」页面右上角点击 「新增」，弹出“新增代理管理”窗口。

步骤 2｜选择代理类型
在「代理类型」下拉框中选择公司提供的类型：HTTP / HTTPS / SOCKS5 / SSH 等。

• 不确定时，一般由运维或提供代理的同事告诉你类型。

步骤 3｜选择 IP 查询渠道
在「IP 查询渠道」中选择一个检测 IP 的服务，用于后面的“测试连接”。

• 这一步只是决定“用哪个网站来识别当前出口 IP”，不会影响代理本身。

步骤 4｜填写连接信息

• 代理地址：
  • 只需要填主机或域名，如 proxy.xxx.com 或 1.2.3.4；
  • 前缀 http://、https://、socks5:// 会根据代理类型自动补齐。
• 端口号：
  • 填写代理服务的端口，例如 8080、1080 等。
• 代理账号 / 代理密码：
  • 如代理需要账号密码，这里填你从运维处拿到的账号信息；
  • 不需要认证的代理可以留空。
• 刷新 URL（可选）：
  • 如果供应商支持“刷新 IP”或“重置线路”，可以把对应链接填在这里，便于后续自动刷新。
• 备注：
  • 建议写清楚“国家/地区 + 供应商 + 用途”，例如：
  • US-A 线路 / 某某代理商 / 投放用。

步骤 5｜测试连接
在弹窗底部点击 「测试连接」 按钮：

• 系统会先检查表单必填项是否填写完整；
• 然后通过所选的「IP 查询渠道」实际发起访问；
• 检查是否能够连通、响应是否正常、IP 是否有返回。
  如果测试失败，界面会提示错误信息，按提示检查：
• 代理地址是否写错；
• 端口是否正确；
• 账号密码是否匹配；
• 当前网络/公司防火墙是否允许访问代理。

步骤 6｜保存

• 测试通过后点击 「确定」 保存。
• 新增的代理会出现在列表中，供后续浏览器环境选择使用。

---

🌐 IP 查询渠道说明

在新增/编辑弹窗中，你会看到「IP 查询渠道」的下拉选项，这些选项来自统一的配置文件（ip.test.channels.ts）。
可以简单理解为：“用哪个网站来检测当前代理的出口 IP”。

常见渠道示例：

渠道名称	用途说明
ip.sb	免费 IP 地理位置查询，简单快速查看当前 IP 与地区。
freeipapi	免费 IP 地理位置服务，可返回较详细的国家/城市信息。
ip2location	IP 归属地查询服务，偏向地理位置识别。
ipapi.co	IP 地址 API 服务，返回 IP 位置及网络信息。
ipinfo.io	IP 信息服务，包含地区、组织等信息。

选哪个渠道没有绝对标准，一般建议：

• 只需要简单确认 IP 是否变了：任选一个常用渠道即可；
• 经常做风控验证：可以固定使用一两个你最熟悉的渠道，减少结果差异带来的困惑。

---

📋 列表页：日常管理操作

在「代理管理」主页面，你可以对已配置的代理做日常管理。

• 筛选

  • 顶部「代理类型」筛选框可以快速切换 HTTP / HTTPS / SOCKS5 / SSH 等类型；
  • 清空筛选可以看到所有类型的代理。

• 查看字段

  • 代理类型：将通过标签高亮显示 HTTP / HTTPS / SOCKS5 等。
  • IP 查询渠道：显示你保存时选的检测渠道名称。
  • 主机 / 端口号：代理服务器地址与端口。
  • 代理账号：账号信息（如有）。
  • 代理密码：以 ****** 形式遮挡显示，避免泄露。
  • 刷新 URL / 备注：辅助说明，方便运营和运维沟通。
  • 创建人 / 创建时间：谁录入的这条代理。
  • 更新人 / 更新时间：最近一次修改的操作者与时间。

• 修改

  • 在操作列点击 「修改」，会弹出与新增相同的表单，带出当前数据；
  • 调整后可以再次点击「测试连接」，确认无误再保存。

• 删除

  • 在操作列点击 「删除」，系统会进行二次确认；
  • 确认后，该代理从列表中移除，同时进入回收站；
  • 如需彻底清理，可在「回收站」中进行永久删除。

• 导出

  • 点击工具栏中的 「导出」 按钮；
  • 会根据当前筛选条件导出代理列表，支持做审计、归档或对账使用。

---

💡 使用建议

• 不要自己随便填代理信息

  • 建议由运维或负责对接代理供应商的同事给出“标准填法”，你只负责按要求录入。

• 统一命名规范

  • 建议在备注中统一写法，例如：国家-城市-供应商-用途；
  • 方便后续筛选和导出统计。

• 代理与业务地区保持一致

  • 如果浏览器指纹配置在“美国”，尽量选择美国代理；
  • 代理地区、语言、时区不一致，会增加被网站风控的概率。

• 测试连接要养成习惯

  • 新录入或刚修改完的代理，一定先用「测试连接」确认可用；
  • 避免在生产环境中临时发现“代理连不上”。

• 定期检查和清理

  • 对长期不用或已失效的代理，可以导出记录归档后删除；
  • 删除后会进入回收站，需要时还能查到是谁删除的、什么时候删除的。

---

❓ 常见问题

• Q：不会分 HTTP / HTTPS / SOCKS5，怎么办？
  A：直接问负责提供代理的同事，让 TA 告诉你“类型 + 地址 + 端口 + 账号密码”，你照填即可。

• Q：测试连接失败但同事说代理是好的？
  A：先核对是否抄错了信息（特别是端口和密码），再确认当前电脑网络或公司防火墙有没有拦截；必要时请运维一起看。

• Q：为什么要选“IP 查询渠道”？
  A：这是用来“验 IP”的工具，选谁都可以，只是用不同的网站来告诉你“你现在看上去来自哪儿”。

• Q：代理删除后还能恢复吗？
  A：可以在「回收站」中看到删除记录，根据权限决定是否恢复或永久删除。

---

完成代理集中管理后，建议配合以下页面一起使用：

• 参数说明：让浏览器指纹参数与代理地区保持一致。
• 创建第一个浏览器：在创建环境时选择合适的代理。