快速开始：通过 Nameless Proxy 发送您的第一个请求

代理用户名语法是什么？

用户名包含所有定位信息，顺序为：USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}。只需指定国家或城市即可获得旋转 IP，每次新连接都会更换 IP。若要使用固定 IP，请在城市后添加会话和 TTL。

HTTP 还是 SOCKS5：我应该用哪个端口？

网页流量和浏览器使用端口 7777，SOCKS5 客户端使用端口 7778。HTTP 端口也支持 HTTPS：客户端打开 CONNECT 隧道，代理能看到目标主机和端口，但看不到加密内容（RFC 9110）。

使用 SOCKS5 时，在 curl 中用 --socks5-hostname，或代码中用 socks5h://，这样 DNS 解析在代理端完成，查询也从目标国家出口。SOCKS5 明文发送用户名和密码（RFC 1929），建议优先使用 HTTPS 目标。

# Same request over SOCKS5; --socks5-hostname lets the proxy resolve DNS
curl --socks5-hostname "gw.namelessproxy.com:7778" \
     --proxy-user "USERNAME-country-ae:PASSWORD" \
     https://api.ipify.org

# Many tools read the standard proxy variables
export HTTP_PROXY="http://USERNAME-country-ng:[email protected]:7777"
export HTTPS_PROXY="$HTTP_PROXY"
curl -s https://api.ipify.org

如何保持请求间相同的 IP？

在城市后添加会话 ID 和 TTL。所有带相同会话 ID 的请求在 TTL 结束前都从同一 IP 出口。新 ID 会获得新 IP。住宅代理设备可能在 TTL 结束前离线，因此请让您的代码能接受 IP 变更。

# Sticky session: same session ID = same exit IP while the TTL lasts
PROXY="http://USERNAME-country-ae-city-dubai-session-a1b2c3-ttl-30:[email protected]:7777"
for i in 1 2 3; do
  curl -s -x "$PROXY" https://api.ipify.org; echo
done

# Check where the exit IP is located
curl -s -x "$PROXY" https://ipinfo.io/json

我可以用IP白名单代替密码吗？

可以。在客户端区域添加您服务器的公网 IP：IPv4 地址或 /24 到 /32 的范围，或 IPv6 地址或 /48 到 /128 的范围。私有和保留范围会被拒绝，新条目在网关 60 秒内生效。本指南使用用户名和密码，因为示例定位信息包含在用户名中。

为什么我的请求失败？

大多数首次使用问题来自凭证、端口或目标设置。提交工单前请先查看此表。