概述

IPRoyal 通过 HTTP(S)、SOCKS5 和 Shadowsocks 式隧道提供住宅、数据中心和 ISP 代理，可按用量付费或按月固定费用计费，背后有 3200 万+ IP 池支持。正是这种协议范围让人们选择它——这也是首次设置失败最常见的原因。将 SOCKS5 端点粘贴到仅支持 HTTP 的字段中，或者反过来，会产生看起来像代理不可用、而不是配置不匹配的错误。

本教程将带你从一个全新的 IPRoyal 账户走到经过验证、可脚本化的连接。你将根据自己的工作负载选择正确的代理类型和协议，构建可用的代理 URL，证明流量确实通过 IPRoyal 出口，并检查 DNS 没有绕开隧道进行解析。每条命令都可在 macOS 或 Linux 终端中运行；代理 URL 在 Windows 上完全相同，只是 shell 变量语法不同。

你需要准备

一个有效的 IPRoyal 套餐（住宅、数据中心或 ISP），并能访问你的仪表板
网关主机、端口、用户名和密码，且须与仪表板显示的完全一致
支持 SOCKS5 的 curl（macOS、Debian 和 Ubuntu 上的标准构建已包含）
可选：Python 3.8+ 以及 requests 库，用于脚本化检查

选择代理类型和协议

代理类型和协议是两个独立的决定。类型决定你以哪个 IP 出现；协议决定你的流量在到达那里的途中如何被封装。先选类型，再选协议。

工作负载	代理类型	协议	为何适合
在单个地区进行浏览器隐私保护	住宅	HTTP(S)	配置最简单；可用于任何浏览器代理字段
不能泄露 DNS 的 CLI 工具和爬虫	住宅	SOCKS5	具备远程 DNS 解析的全隧道行为
仅接受 HTTP 代理的应用程序	ISP	HTTP(S)	稳定的托管式地址，看起来不那么异常
长期会话，每个账户一个 IP	ISP 或住宅	SOCKS5 或 Shadowsocks	连接持续存在，无需强制轮换
普通代理端口被限速或封锁的网络	任意	Shadowsocks	当裸代理端口被过滤时，使用混淆隧道

协议可用性可能因产品和套餐而异，因此在构建任何东西之前，请确认你的具体仪表板暴露了哪些协议。在两者都提供的情况下，HTTP(S) 更容易调试，SOCKS5 能力更强——先从 HTTP(S) 开始，待凭据被证明可用后再转向 SOCKS5。

步骤

从仪表板复制端点和凭据。 不要重新输入它们。使用复制按钮，这样尾随空格和形似字符就不会进入其中。你需要的四个值是网关主机、端口、用户名和密码。
```
export PROXY_USER="dashboard-username"
export PROXY_PASS="dashboard-password"
export PROXY_HOST="gateway-host-from-dashboard"
export PROXY_PORT="gateway-port-from-dashboard"
```
为每种协议构建代理 URL。 URL 格式到处都一样：凭据，然后是主机，然后是端口。
```
http://USERNAME:PASSWORD@HOST:PORT     # HTTP/HTTPS proxy
socks5h://USERNAME:PASSWORD@HOST:PORT  # SOCKS5, DNS resolved at the proxy
```
如果你的密码包含 @、:、/ 或 ?，请对其进行百分号编码（@ 变为 %40，: 变为 %3A）。未编码的特殊字符是导致认证失败最常见的原因。
从终端验证 HTTP(S) 请求。 这可以在你引入浏览器或脚本之前证明凭据、主机和端口都正确。
```
curl -sS \
  --proxy "http://$PROXY_USER:$PROXY_PASS@$PROXY_HOST:$PROXY_PORT" \
  "https://api.ipify.org?format=json"
```
你应该收到一个包含 ip 值的小型 JSON 对象，且该值不是你自己的地址。如果你在这里看到自己的真实 IP，说明该标志被忽略，流量直接出去了。
验证 SOCKS5 请求，并获取远程 DNS。 使用 --socks5-hostname，让代理解析主机名，而不是由你的机器在本地解析。
```
curl -sS \
  --socks5-hostname "$PROXY_USER:$PROXY_PASS@$PROXY_HOST:$PROXY_PORT" \
  "https://api.ipify.org?format=json"
```
这个区别很重要：--socks5 在你的设备上解析 DNS，然后建立隧道连接；而 --socks5-hostname 将主机名发送给代理。对于隐私相关工作，优先使用 --socks5-hostname 以及脚本中等效的 socks5h:// URL 方案。
当情况看起来不对时检查隧道。 详细输出会显示代理是否在接受请求，此时还完全不涉及任何页面内容。
```
curl -v \
  --proxy "http://$PROXY_USER:$PROXY_PASS@$PROXY_HOST:$PROXY_PORT" \
  -o /dev/null "https://example.com"
```
查找一行 CONNECT 以及其后的 HTTP/1.1 200 Connection established。此时出现 407 是认证问题；此时超时是主机或端口问题。

用 Python 编写相同的检查脚本。 对于 HTTP 代理，requests 不需要额外包。

import os
import requests

proxy_url = os.environ["IPROYAL_PROXY_URL"]  # http://user:pass@host:port
proxies = {"http": proxy_url, "https": proxy_url}

response = requests.get(
    "https://api.ipify.org?format=json",
    proxies=proxies,
    timeout=30,
)
response.raise_for_status()
print(response.json())

对于 SOCKS5，先安装可选依赖，然后使用 socks5h:// URL，以便 DNS 在代理端解析。

pip install "requests[socks]"

import os
import requests

socks_url = os.environ["IPROYAL_SOCKS_URL"]  # socks5h://user:pass@host:port
proxies = {"http": socks_url, "https": socks_url}

session = requests.Session()
print(session.get("https://api.ipify.org", proxies=proxies, timeout=30).text)

在轮换和粘性会话之间做出决定。 使用相同的凭据运行第 3 步两次，并比较两个地址。如果 IP 未变，则你的套餐保持的是粘性会话，这正是登录和多步表单所需要的。如果你需要新地址，请使用仪表板提供的会话或轮换控件来请求一个，而不是手动编辑 URL 参数——生成的凭据已经格式正确。
确认出口地区并检查 DNS 泄露。 Cloudflare trace 请求会同时显示出口 IP 及其注册国家/地区，这是捕获路由错误套餐的最快方式。
```
curl -sS \
  --proxy "http://$PROXY_USER:$PROXY_PASS@$PROXY_HOST:$PROXY_PORT" \
  "https://1.1.1.1/cdn-cgi/trace"
```
读取 ip= 和 loc= 行：loc= 应与你打算使用的地区匹配。然后在你配置好的浏览器中运行公共 DNS 泄露测试；如果显示的解析器是你的本地 ISP，而不是代理网络，请将该浏览器切换为 SOCKS5 配置，或改用支持 socks5h 式远程 DNS 的客户端。

故障排除

407 Proxy Authentication Required — 凭据错误、已被撤销，或包含未编码的特殊字符。对密码进行百分号编码，并重新复制这两个值。
curl: (7) Failed to connect 或超时 — 主机或端口错误，或者协议与端口不匹配（将 HTTP 端口与 SOCKS5 URL 一起使用）。检查仪表板中的协议列。
curl: (97) Can't complete SOCKS5 connection — curl 连接到了不是 SOCKS5 端点的东西。确认你使用的是 SOCKS5 端口，而不是 HTTP 端口。
在 curl 中可用，在浏览器中失败 — 大多数浏览器代理字段只接受 HTTP(S)。要么使用 HTTP 端点，要么在操作系统或客户端级别配置 SOCKS5。
目标网站反复返回 403 或 429 — 该网站在对地址或会话进行限速。降低请求速率，或者为一个更长的序列保持同一个会话，而不是每个请求都轮换。
出口 IP 从不改变 — 粘性会话处于活动状态，或者所选池的地理范围很窄。使用仪表板的会话控件请求不同的出口。
HTTPS 可用，但页面仍显示你所在的本地地区 — DNS 正在本地解析。切换到 socks5h/--socks5-hostname，或将客户端改为全隧道配置。
Shadowsocks 客户端无法启动 — 通常是加密方式或密钥输入错误。粘贴生成的配置，而不是手动转录，并确保你选择的本地监听端口未被占用。
费用意外上升 — 按量付费套餐会计量使用量，因此爬虫中的失控循环或后台同步的浏览器可能会快速消耗配额。在首次验证运行后检查用量。

总结

代理类型（住宅、数据中心、ISP）选择你以哪个 IP 出现；协议（HTTP、SOCKS5、Shadowsocks）选择流量如何被封装。两者都要有意识地决定。
从仪表板复制主机、端口、用户名和密码，对特殊字符进行百分号编码，并为每种协议构建一种 URL 格式。
在接触浏览器或脚本之前，先通过对 IP echo 服务发出单个 curl 请求进行验证——这可以将凭据错误与应用程序错误隔离开来。
只要 DNS 隐私重要，就使用 socks5h:// 或 --socks5-hostname，并通过 trace 请求确认出口地区。
尽早测试轮换与粘性会话，因为该选择决定了你的工具应如何处理重试和登录。

一旦单个经过验证的请求成功，相同的凭据就可以直接用于浏览器、抓取库或代理链工具。鉴于其协议范围和计费选项，IPRoyal 是此工作流中一个合理的选择；上述验证步骤适用于你拿来对比的任何提供商。