第3章 代理设置

适用版本 v4.0.1。本章你将学会：在「代理设置」页面选择挂卡使用的代理来源（代理池、皇家代理、第三方 API），导入并检测代理资源，以及从全家桶同步代理配置。

3.0 开始之前

• 已按第1章登录，并能在标题栏看到「代理设置」按钮。
• 挂卡助手需要通过代理线路，让不同账号从不同出口连接 Steam。代理是挂卡助手自己保存的一套资源，与全家桶的代理设置分开；需要时可以用「同步全家桶代理配置」把全家桶的复制过来（见 3.2）。
• 您需要先有可用的代理资源，三种来源任选其一：
  1. 代理池：订阅链接（URL）、YAML 配置文本或 YAML 配置文件。
  2. 皇家代理（IPRoyal）：您已有的 IPRoyal 用户名和密码。
  3. 第三方 API：您已有的代理提取链接（HTTPS）、批量代理文本或文本文件。
• 示例中的代理地址一律是合成数据，例如 192.0.2.10:7890；用户名 demo_account_01、密码 ********。请换成您自己的。

高风险操作

下面几乎所有改动代理的动作（切换来源、导入、检测、删除、同步），都要求先把挂卡账号全部停止。

• 会发生什么：如果还有账号在运行，软件会拒绝并提示，例如「仍有挂卡账号运行，停止全部账号后才能切换挂卡代理。」「仍有挂卡账号运行，停止全部账号后才能修改挂卡代理资源。」「仍有挂卡账号运行，停止全部账号后才能同步主程序代理资源。」。
• 不能撤销：因此不要在账号运行中试图"热切换"代理；先到「挂卡任务」页面点「停止全部」（见第5章），确认账号都停下来，再回来改。
• 何时不要点：账号正在启动或运行；节点检测正在进行时（软件也会提示「挂卡代理资源正在被其它操作占用（例如节点检测），请稍后再试。」）。
• 结果不明确时：先看各来源卡片上的「已配置/未配置」标记和右侧列表核对，不要重复提交。

3.1 进入「代理设置」页面，认识布局

在哪里：窗口最上方标题栏中间，点击「代理设置」按钮（点击后按钮高亮）。

图 3-1 代理设置页面全貌

怎么做：看一看页面：

1. 页面顶部一条横栏：左边是标题「挂卡代理设置」，下面小字「代理来源独立保存；第三方 API 支持 URL、批量文本和文件输入，检测仅在点击后执行。」。右边先是一个文字标签，显示当前选中的来源名称（「代理池」「皇家代理（IPRoyal）」或「第三方 API」），再往右是按钮「同步全家桶代理配置」。
2. 下面分左右两栏。左栏顶部是「挂卡代理来源」（右侧小字「仅三种来源」），里面竖着排三张来源卡片：「代理池」「皇家代理（IPRoyal）」「第三方 API」。
3. 右栏顶部是「××× 配置」（××× 是当前选中的来源名称，右侧小字「挂卡私有资源」），下面是该来源的具体配置内容。

这一步的作用：熟悉页面分区。

你会看到：每张来源卡片右上角有一个状态标记，「已配置」或「未配置」（颜色随皮肤变化，以文字为准），下面还有两个小标签（例如节点数、区域等）。当前选中的来源卡片会高亮。页面刚打开时会短暂显示加载动画。

3.2 选择代理来源

在哪里：左栏三张来源卡片。

怎么做：

1. 将鼠标移到想使用的来源卡片上，点击卡片（点击卡片的标题或说明区域）。
2. 右栏会立即换成该来源的配置内容。

这一步的作用：告诉挂卡助手"以后挂卡走哪一种代理"。点击后设置会立即保存，没有单独的"保存"按钮。

你会看到：成功提示「代理设置已更新」。如果还有账号在运行，会收到 3.0 里提到的拒绝提示，来源不会改变。

注意：三张卡片说明了各自的特点：

• 「代理池」：单进程接管订阅与 YAML，按账号稳定分配线路。标签里有节点数量和当前使用的配置名称。
• 「皇家代理（IPRoyal）」：独立保存用户名、密码与出口参数；不会读取或覆盖主程序凭据。
• 「第三方 API」：可选择 API URL、批量文本或本地文件；仅保存安全摘要。标签里有"可用 / 总节点"数量和刷新方式。

3.3 「同步全家桶代理配置」

在哪里：页面右上角的按钮「同步全家桶代理配置」。

怎么做：

1. 先到「挂卡任务」页面点「停止全部」，确保没有账号在运行。
2. 回到「代理设置」页面，点击「同步全家桶代理配置」。
3. 按钮文字会变成「同步中…」，等待结束。

这一步的作用：把同目录下全家桶里已经配置好的代理资源复制到挂卡助手，省去重新导入的步骤。

你会看到：成功提示「已同步全家桶代理配置」（也可能是更详细的同步结果文字）。失败时可能出现：

• 「仍有挂卡账号运行，停止全部账号后才能同步主程序代理资源。」：先停止全部账号。
• 「同步主程序代理资源失败。」：同步没有成功，稍后再试。

注意：

• 同步会写入挂卡助手自己的代理存储，可能改变挂卡助手原有的代理池配置。具体会复制哪些来源、是否覆盖同名配置，请以实机为准。（以实际软件为准）
• 同步之后建议逐一点开各来源核对，并重新检测一次。

3.4 来源一：代理池

在哪里：在左栏点选「代理池」后，右栏出现。右栏分为上下两大块：上面一张卡片「代理池节点资源导入」（右侧小字「最多 5 个配置文件」），下面是「配置文件与节点状态」列表。

图 3-2 代理池导入区域

3.4.1 导入一份代理池配置

怎么做：

1. 卡片里有一行说明：「每份配置独立导入，仅检测本次导入的节点；需要合并使用时再手动聚合。」，下面是一行「当前有 N 份单独配置。已有聚合保持不变，手动聚合时才更新来源。」和右侧按钮「手动聚合全部配置」（后者见 3.4.3）。
2. 再往下是三个切换标签：「订阅 URL」「YAML 文本」「文件导入」。点击其中一个，选择导入方式。
3. 下面的表单里，第一格「配置名称」是可选的（占位提示「可选，默认使用域名或文件名」）。第二格随所选标签变化：
   • 「订阅 URL」：在「订阅 URL」输入框里粘贴订阅链接，灰色示例是 https://example.com/sub.yaml。
   • 「YAML 文本」：在大文本框「YAML 文本」里粘贴配置内容，占位提示「粘贴 mihomo / Clash YAML 内容」。
   • 「文件导入」：点击「配置文件」那个长按钮，在弹出的窗口里选择一个或多个 .yaml / .yml / .txt 文件。选完后按钮上会显示文件名（多个文件时显示"已选择 N 个文件：……"）。
4. 点击下面的按钮「导入并完整检测」。

这一步的作用：把代理配置存进挂卡助手，并立刻检测里面节点的可用性。

你会看到：

• 导入中按钮文字变成「导入完整检测中...」，下方列表里会出现检测进度条（"已检 / 总数 · 可用 N"）。
• 全部完成后提示「内置代理配置已导入并完成检测」。导入的配置会自动设为"当前配置"。
• 选择文件后会提示「已读取 xxx」；一次选了多个文件会提示「已读取 N 个配置文件，将分别导入和检测」。
• 订阅 URL 或 YAML 内容为空时提示「请填写订阅 URL」或「请先提供 YAML 配置内容」。

注意：

• 数量与大小限制：代理池最多保留 5 个配置文件；一次最多选 20 个文件，单个文件不超过 5MB，合计不超过 20MB。超过时会提示：「内置代理配置最多保留 5 个，请先移除不再使用的配置」「单个文件超过 5MB，请确认导入的是 mihomo 配置文件」「所选配置文件总大小超过 20MB」。
• 一次选多个文件时，每个文件会分别导入、分别检测，需要有足够的名额（「分别导入需要 N 个配置名额，最多保留 5 个」）。
• 如果配置已导入、但检测没有完成，提示会写「配置已导入，选择/检测未完成……」，可以稍后在列表里对该配置点「单文件检测」重试。
• 配置里是别人的订阅或节点信息，请自行确认来源可靠；教程里的示例链接 https://example.com/sub.yaml 只是格式示例。

3.4.2 查看与管理已导入的配置

在哪里：右栏下半部分的「配置文件与节点状态」，右上角有小按钮「全量检测」。

怎么做：

1. 每份配置是一行，显示配置名称、来源类型（订阅 URL / YAML 文件 / 聚合配置）和状态，例如「节点 120 · 已检 120 · 可用 85」。当前使用的那份会高亮。
2. 点击配置名称所在的那一块，可以展开/收起节点明细，表头是「节点」「区域」「出口 IP」「状态」，状态列显示延迟（如 120 ms）、「待轮询检测」或失败原因。
3. 每份配置右边有按钮：
   • 「设为当前」：让挂卡使用这份配置。成功提示「当前代理池配置已切换：配置名」。当前已经在用的那份此按钮灰色。
   • 「单文件检测」：重新检测这一份配置的所有节点，完成提示「配置名 检测完成」。
   • 「移除」：从挂卡助手里删除这份配置，会先弹确认框「移除内置代理配置」，内容「确认移除 配置名？」，点「移除」确认。
4. 想一次检测全部配置：点击右上角「全量检测」，按钮会显示进度「全量检测中（1/3）」。

这一步的作用：切换使用的配置、核对节点是否可用、清理不用的配置。

你会看到：没有配置时显示「尚未导入内置代理配置。可通过订阅 URL、YAML 文本或文件导入。」。检测进行中，各按钮会暂时变灰。

高风险操作

「移除」会删除挂卡助手里的这份代理配置。

• 会发生什么：这份配置里的节点资源从挂卡助手消失，如果它是当前配置，后续挂卡将缺少代理线路。
• 不能撤销：移除后需要重新导入订阅/文件才能恢复。
• 何时不要点：账号正在运行时；您手里没有原始订阅或文件备份时。
• 结果不明确时：先刷新页面核对配置列表，不要重复点击。

3.4.3 「手动聚合全部配置」

在哪里：「代理池节点资源导入」卡片里，说明文字右边的按钮「手动聚合全部配置」。

怎么做：当单独配置不少于 2 份时，按钮才可点击；点击后等待按钮上的「聚合中…」结束。

这一步的作用：把所有单独配置合并成一份聚合配置，方便统一使用。

你会看到：成功提示「全部单独配置已聚合」（或更详细文字）。列表里出现来源类型为「聚合配置」的一行，聚合配置也可以「设为当前」「移除」。

注意：说明文字写得很清楚：已有的聚合保持不变，只有您点「手动聚合全部配置」时才会更新聚合内容。

3.5 来源二：皇家代理（IPRoyal）

在哪里：在左栏点选「皇家代理（IPRoyal）」，右栏出现一张卡片，标题行右边有一个状态标记。

图 3-3 皇家代理配置

怎么做：

1. 将鼠标移到卡片里，依次填写：
   • 「用户名」：占位提示「IPRoyal 用户名」，填您已有的 IPRoyal 用户名。
   • 「密码」：占位提示「请输入 IPRoyal 密码」，输入框右侧有眼睛图标可显示/隐藏。已经保存过密码时，占位提示变成「已保存密码，留空则不修改」。
   • 「出口区域」：占位提示「留空=全球随机出口」。留空时，系统按账号使用全球随机的固定出口。可以输入国家代码；页面如果提供下拉列表则直接选择。
2. 填完不需要点保存：卡片下方小字会显示「配置自动保存中…」，保存完成变成「配置自动保存」。
3. 想检查是否能用：点击输入框下方那一行里的「测试出口」（这一行从左到右是「配置自动保存」小字、「删除配置」「测试出口」两个按钮）。
4. 想删除这套配置：点击「删除配置」，在确认框「删除皇家代理配置」中点「删除」。

这一步的作用：使用皇家代理作为挂卡出口。凭据只保存在挂卡助手，不会影响全家桶。

你会看到：

• 状态标记会显示：「保存中」「保存失败」「生效」（正在使用）、「可用」（已填完整但未选中）或「未配置」。
• 用户名/密码没填完整时，卡片里有提示：「请填写完整用户名与密码，配置将自动保存；凭据不完整时联网操作会被拒绝（不会退化为直连）。」
• 测试结果提示：「皇家代理出口测试通过」或「皇家代理出口测试未通过」；还没填凭据就点测试会提示「请先填写皇家代理用户名与密码，再测试出口」。
• 小字提醒：「密码不会由读取接口回显；留空保存将保留已经保存的密码。」

注意：

• 要真正让它生效，还要在左栏选中「皇家代理（IPRoyal）」这张卡片（见 3.2）。
• 删除前请确认账号都已停止。删除确认框写明「此操作不会影响主程序。」

高风险操作

「删除配置」会清除挂卡助手里保存的皇家代理用户名和密码。

• 会发生什么：保存的用户名、密码被删除，选中该来源时将无法联网挂卡。
• 不能撤销：需要重新输入凭据。请确认自己另有备份。
• 何时不要点：账号正在运行时；忘记了密码时。
• 结果不明确时：重新打开这张卡片，看用户名/状态标记是否还在。

3.6 来源三：第三方 API

在哪里：在左栏点选「第三方 API」，右栏出现。从上到下依次是：标题「新增导入」、「已导入资源」列表、进度条（有操作时才出现）、三个输入方式标签「API URL」「批量文本」「文件导入」、输入区域、「导入」按钮、三项状态信息，以及最下面的操作按钮。

图 3-4 第三方 API 配置

怎么做：

1. 先看右上角状态标记：「未配置」「已配置」或「已选择」。
2. 点选一种输入方式标签：
   • 「API URL」：在「API URL」输入框填您已有的 HTTPS 提取链接（占位提示「请输入 HTTPS API 地址」）。还有一个「刷新间隔（秒）」数字框，默认 300，可填 30 到 86400。软件只接受 HTTPS 地址。
   • 「批量文本」：在文本框粘贴代理文本（占位提示「请输入代理文本（最多 5 MiB）」）。支持 host:port:user:pass、URI、Clash、sing-box 或 Base64 文本；没有写协议的 host:port 按 HTTP 处理，SOCKS5 请保留显式协议。示例：192.0.2.10:7890:demo_account_01:********。
   • 「文件导入」：点击「选择文件」，选择 UTF-8 文本文件（最多 5 MiB，支持 .txt、.list、.yaml、.yml、.conf、.json）。文件只在本机读取，不会上传文件路径或文件名。
3. 点击「导入」按钮（导入中显示「导入中…」）。每次导入都会同步并完整检测。
4. 导入后，可在下方按钮继续操作：
   • 「检测全部」：重新检测全部已导入资源。
   • 「重新加载」：重新读取 API URL 等资源。
   • 「清空全部」：清空全部第三方 API 导入资源（见后面的风险框）。
   • 「已导入资源」列表里每一批右边有「移除」，只移除这一批。

这一步的作用：把第三方代理资源导入挂卡助手，并确认有多少节点可用。

你会看到：

• 「已导入资源」列表按「URL导入1」「文本导入2」「文件导入3」命名，每批显示"总节点 N · 可用 N · 上次导入或检测时间"；最多 5 批，当前批数显示在右上角（「N 批」）。
• 导入或检测期间会出现进度条和阶段文字；完成后提示「第三方 API 导入已完成」「第三方 API 检测已完成」等。
• 下面三项状态：「可用 / 总节点」（统计未出来时显示「待统计」）、「上次导入或检测」、「最近错误」。出现「上次结果」字样表示显示的是上一次的读取结果，不代表实时状态。
• 之后还会出现「最近××结果」小面板：完成时间、当前阶段、节点结果、耗时，以及失败类别。
• 常见提示：
  • 「刷新间隔需为 30 到 86400 秒之间的整数」：改正数字。
  • 「检测到代理文本格式，已切换到批量文本；请确认后再次导入。」：您在「API URL」里填的不是 HTTPS 链接，而是代理文本；软件已把内容移到「批量文本」，确认无误后再点「导入」。
  • 「输入已修改，请先导入后再检测全部」「输入已修改，请先导入后再重新加载」：输入框里还有没导入的内容，先点「导入」。
  • 「请先导入第三方 API 资源」：还没导入过任何资源。

注意：

• 「检测全部」「重新加载」「清空全部」在没有导入资源或输入框里有未导入内容时是灰色的。
• 导入成功后，输入框会被清空，避免敏感链接留在页面上。
• 这类提取链接往往含有您的套餐凭据，请不要把它发给别人，也不要贴到截图里。

高风险操作

「清空全部」和某批「移除」会删除已导入的第三方 API 资源。

• 会发生什么：确认框「清空全部导入资源」写明「确认清空全部第三方 API 导入资源？此操作不会影响其他代理来源。」；单批「移除已导入资源」写明「确认移除URL导入1？此操作不会影响其他已导入资源。」。
• 不能撤销：需要重新导入链接/文本/文件。
• 何时不要点：账号正在运行时；没有原链接、原文本的备份时。
• 结果不明确时：看右上角"N 批"和列表是否变化，不要重复点击。

3.7 设置完成后怎么确认

在哪里：回到「挂卡任务」页面，状态栏右侧。

怎么做：

1. 点击标题栏的「挂卡任务」。
2. 看状态栏右侧的「代理线路 N」：N 在启动账号后才会出现数字，没启动前显示「-」。
3. 启动少量账号（见第5章），观察"连接/Persona"一列是否变成在线，以及账号的代理线路是否分配成功。

这一步的作用：用实际启动验证代理设置。

你会看到：启动时提示「已接收 N 个账号，正在后台准入；已准备 N 条代理线路，并发容量 N」。

注意：真实代理出口（例如住宅代理出口）的长时间稳定性，需要在受保护的正式包里用小批量真实账号复测。（以实际软件为准）

3.8 常见问题

Q：三种来源可以同时用吗？ 页面写的是「仅三种来源」，同一时间只选中一种来源。选哪张卡片，挂卡就用哪一种。

Q：我在全家桶里配过代理，这里为什么是空的？ 两边是分开保存的。用「同步全家桶代理配置」复制过来，或在这里重新导入。

Q：提示「仍有挂卡账号运行」怎么办？ 到「挂卡任务」页面点「停止全部」，等所有账号都变成已停止后，再回来改代理。

Q：节点检测到一半，我能离开页面吗？ 检测进行期间，页面上相关按钮会变灰。建议等检测结束再操作；中途改动会被拒绝或提示资源被占用。

Q：检测显示可用数量很少？ 先「单文件检测」重试一次；仍然很少，多半是订阅本身节点失效或网络环境不通，请联系代理提供方。