越南专属代理：强制更换新的出口IP

本页介绍货架上标注为越南专属轮换住宅代理的产品，提供一天、七天和三十天三种期限。该产品与某些列表和旧版指南中称为VN Exclusive的产品相同。如果您在目录中查找该名称，将找不到，请搜索Vietnam Dedicated。

本页不涵盖越南轮换住宅共享代理，那是另一款产品。下面的接口会拒绝共享账户，因为该账户没有自己的密钥可供轮换。

它本身就会自动更换IP

在编写任何代码之前，这一点值得了解，因为它决定了您是否需要编写代码。专属代理大约每三分钟自动轮换一次出口IP。这就是该产品的特性，列表上也有说明。

下面的请求所做的是提前强制轮换，适用于无法等待完整周期的情况。这不是获取新IP的唯一方式，而是立即获取新IP的方式。

有两项内容始终保持不变。您的主机和端口不变，用户名和密码也不变。您继续使用相同的host:port:username:password，只是流量出口的地址不同。

您需要准备什么

• 订单中的代理用户名和密码，即host:port:username:password中的同一对凭据。
• API基础URL：https://proxy-api.lunaproxy.online。

请求

• 方法： POST
• 路径： /api/v1/proxy/change-ip
• 认证： HTTP Basic，使用您的代理用户名和密码。无需API密钥，也无需先获取令牌。
• 响应： JSON，格式为{"success": true|false, "message"?: string, "error"?: string}

作为单条命令，将占位符替换为您自己的凭据：

curl -X POST "https://proxy-api.lunaproxy.online/api/v1/proxy/change-ip" \
  -u "YOUR_PROXY_USERNAME:YOUR_PROXY_PASSWORD"

请注意，凭据放在Basic认证头中（即-u所构建的内容），而不是放在请求体中。该请求完全没有请求体。

响应含义

结果	HTTP	处理方式
已接受	200	{"success":true,"message":"Change-IP request sent"}。此后通过代理发送的请求将使用新的出口IP。
未认证	401	Basic认证头缺失或凭据不被接受。完全不发送认证头会返回Basic auth required (proxy username:password)。请确认您使用的是代理凭据，而不是网站登录信息。
不符合条件	400	该账户不是越南专属代理，或未分配密钥。共享代理会落在此处。如果您认为自己购买的是专属产品，请联系客服。
订单未找到	404	订单已被删除或从未存在。请联系客服。
请求过于频繁	429	您正处于冷却期内。请读取Retry-After响应头，其中以秒为单位给出等待时间，请以该值为准，而不是凭感觉猜测。原因见下文。
上游繁忙	502	当前没有可用的新IP。请稍后重试。
服务错误	503	上游或内部故障。请读取响应体中的error字段。
服务器错误	500	意外错误。请读取error字段，重试一次，若持续出现请联系客服。

为什么有冷却期

因为底层的轮换周期大约为三分钟，强制更换并不会缩短该周期，只是将您在周期中的位置提前。立即再次请求时，还没有新的IP可供分配，这就是429的含义。

因此，请将等待时间纳入设计，而不是循环重试。429响应中的Retry-After头会告诉您需要等待多久，这是唯一值得信赖的数字；具体数值会变化。忽略该头信息的循环会产生一连串429，而不会更快得到结果。

如果不起作用

1. 每次调用都返回401。请确认您发送的是代理用户名和密码，而不是此处的账户登录信息。这是两组不同的凭据，代理凭据是订单上打印的那组。
2. 每次调用都返回400。请检查您购买的是哪款越南产品。只有专属版才有可轮换的密钥；共享版没有。
3. 返回200，但IP看起来没变。请通过代理检查，而不是在可能保持连接打开的浏览器中查看。已建立的连接不会因轮换而重建。
4. 从第一小时开始就完全无法使用。请当天反馈。这些列表的保修期为交付后十二小时，比大多数人预期的要短，而且无论您是否已进行测试，保修期都会照常计算。