代理格式怎么写:host:port:user:pass、URL 与客户端字段对照

首次接入怎么写代理格式:host:port:user:pass、http(s)/socks5 URL、以及客户端四字段怎么映射;一律以控制台为准;假占位符示例;链 HTTP/SOCKS 与 quickstart。

首次接入怎么写代理格式:host:port:user:pass、http(s)/socks5 URL、以及客户端四字段怎么映射;一律以控制台为准;假占位符示例;链 HTTP/SOCKS 与 quickstart。

本页在解决什么

首次接入卡住的,经常不是「该买动态还是静态」,而是:控制台已经给出主机、端口、用户名、密码,却不知道该写成 `host:port:user:pass`、拼成代理 URL,还是拆进客户端四个输入框。本页把常见代理字符串变体与字段映射写成对照清单。

先分清三件事:

  1. 格式:字符串或字段怎么排(本页重点)。
  2. 协议:HTTP 还是 SOCKS5——见 HTTP / SOCKS5 怎么配。
  3. 产品:动态按 GB 还是静态按 IP·月——见 动态 vs 静态、动态产品、静态产品。

硬规则:主机、端口、凭据、协议一律以控制台 / 订单返回为准。 下文示例全部是明显假占位符,不能当生产值粘贴;不要把真实或可复用的私密凭据写进文档、工单或聊天。

先备齐四个值(再谈格式)

动手前在控制台确认:

字段含义注意
Host / 主机代理入口域名或地址以控制台为准;勿猜、勿抄过期截图
Port / 端口接入端口勿默认「1080/8080 一定对」
Username / 用户名认证用户名可能含地区、会话等后缀——以控制台为准
Password / 密码认证密码勿泄露;轮换后旧值失效

另加一项:协议(HTTP 或 SOCKS5)。协议决定 URL scheme 与客户端下拉项,不等于产品大类。逐步测通见 文档快速开始;API 下单与提取见 API 对接说明。

常见写法一:host:port:user:pass(冒号四段)

很多工具、批量导入框、第三方面板接受冒号分隔的一行字符串。常见顺序是:

```text proxy.example.invalid:10000:USER_EXAMPLE:PASS_EXAMPLE_NOT_REAL ```

对应关系:

  1. `proxy.example.invalid` → Host
  2. `10000` → Port(示例端口,非承诺)
  3. `USER_EXAMPLE` → Username
  4. `PASS_EXAMPLE_NOT_REAL` → Password

易错点

  • 顺序颠倒:少数面板写成 `user:pass@host:port` 或 `host:port@user:pass`——以目标工具文档 + 控制台一键复制为准,不要假设全球统一。
  • 多冒号:若用户名或密码本身含 `:`,冒号四段会歧义;改用分字段或 URL,并对特殊字符做编码(见下节)。
  • 空格与换行:复制时去掉首尾空格;不要把两行粘成一行。
  • 把示例当生产:上表主机是 `*.example.invalid`,连不上真实服务——请换成控制台返回值。

若控制台提供「一键复制代理字符串」,优先用控制台格式,本页仅作对照说明。

常见写法二:代理 URL

HTTP 客户端、部分库与环境变量更习惯 URL:

```text http://USER_EXAMPLE:[email protected]:10000 ```

SOCKS5 时(协议以控制台为准):

```text socks5://USER_EXAMPLE:[email protected]:10000 ```

要点:

  • scheme 与控制台协议一致:常见 `http://` / `https://`(按控制台说明)或 `socks5://`。
  • userinfo 在 `@` 之前:`username:password`。
  • host:port 在 `@` 之后。
  • 用户名或密码含 `@`、`:`、`/`、`%`、空格等时,应对 userinfo 做 百分号编码,再拼 URL;具体以客户端库文档为准,不要手工猜半套编码。
  • 某些工具只要 `host:port`,认证另填——此时不要把整段 URL 塞进 Host 框。

URL 形式不改变计费单位:动态仍主要按流量(GB),静态仍主要按 IP × 月——公开价指针见 定价,以控制台为准。

常见写法三:客户端分字段

浏览器、桌面客户端、指纹浏览器面板、许多 SDK 提供四个(或更多)独立输入框:

客户端字段(常见标签)填入
Proxy type / 协议HTTP 或 SOCKS5(控制台)
Host / Server / 地址控制台 Host
Port / 端口控制台 Port
Username / 用户控制台 Username
Password / 密码控制台 Password

映射原则:拆开填,不要把整串 `host:port:user:pass` 糊进 Host 一栏(除非该 UI 明确写「粘贴完整代理字符串」)。会话 / 地区 / 粘性等可选参数,仅当控制台或 Docs 给出对应字段时再填;粘性 ≠ 静态,见 粘性会话 vs 静态 IP。

格式变体 × 常见使用场景

格式变体示例结构(假占位符)常见用在哪注意
冒号四段`host:port:user:pass`批量导入、部分面板「一行一条」密码含冒号时易歧义
冒号三段 + 另填认证`host:port` + 用户/密码框只要地址端口、认证分栏的 UI勿把用户名写进 Host
HTTP(S) URL`http://user:pass@host:port`curl、请求库、部分环境变量特殊字符需编码
SOCKS5 URL`socks5://user:pass@host:port`明确要求 SOCKS 的工具scheme 须匹配协议
四字段分栏协议 / Host / Port / User / Pass浏览器、桌面客户端、多数 antidetect 面板逐字段对齐控制台
仅 Host:Port`host:port`IP 白名单或无用户名场景(若控制台如此返回)勿臆造「无认证」

表中示例主机 `proxy.example.invalid`、端口 `10000`、用户 `USER_EXAMPLE`、密码 `PASS_EXAMPLE_NOT_REAL` 全部为假;上线配置必须替换为控制台返回值。

假占位符与安全约定

  1. 文档、截图、工单、群聊:只用假占位符或打码。
  2. 不要把可登录的真实密码贴进 Notion、邮件原文或公开仓库。
  3. 轮换后:旧字符串立即作废;以控制台最新值为准。
  4. 分享给同事:优先发「去控制台复制」的权限说明,而不是转发明文密码。
  5. 本站服务仅限合法、经授权用途;不支持在中国大陆地区使用;无养号、无绕登录墙。

和协议、产品、API、Docs 怎么衔接

你卡在哪去哪
HTTP 还是 SOCKS5、客户端清单HTTP / SOCKS5 怎么配
动态还是静态、粘性怎么理解动态 vs 静态 · 粘性 vs 静态 · 怎么选购
程序化下单 / 提取API 对接
逐步命令与测通Docs quickstart
买哪类产品、看价动态 · 静态 · 定价

本页不复制 API 全文,也不发明 `/products/*format*` 产品 SKU——格式是配置写法,不是单独售卖的 SKU。

测通与排错短清单

  1. 控制台重新复制 Host / Port / User / Pass / 协议,避免过期截图。
  2. 确认客户端协议下拉与控制台一致(HTTP vs SOCKS5)。
  3. 若用 URL:检查 `@` 位置与 userinfo 编码。
  4. 若用冒号串:确认工具期望的顺序;密码含 `:` 则改分字段。
  5. 小流量测通;失败时看客户端日志是「认证失败」还是「连不上主机」。
  6. 细节与命令以 quickstart 为准;协议排错见 zt-07。

公开标价指针(以控制台为准):约 $0.40/GB;100 TB 整包约 $0.20/GB(不可拆);共享约 $1.50;独享约 $5/IP/月——见 价格方案。

常见问题

代理格式到底指什么?

通常指如何把 Host、Port、Username、Password(以及协议)写成一行字符串,或填进客户端多个字段。常见有冒号四段、代理 URL、分字段三种;以你的工具支持情况与控制台返回为准。

host:port:user:pass 的顺序固定吗?

业界常见是 Host → Port → User → Pass,但不是全球法律。以目标工具说明与控制台「一键复制」为准;填错顺序会导致认证失败或连错入口。

什么时候用 URL,什么时候用冒号串?

工具文档写「proxy URL / 环境变量」时用 `http://` 或 `socks5://` URL;写「一行 host:port:user:pass」或批量导入时用冒号串;有四个独立输入框时用分字段。不要混用(例如把整段 URL 塞进 Host)。

用户名或密码含特殊字符怎么办?

冒号串可能歧义;优先改用分字段。若必须用 URL,对 userinfo 做百分号编码。不要在未编码情况下把 `@`、`:`、空格直接塞进 URL。

字段值可以从营销页或本文示例复制吗?

不可以。本文 `proxy.example.invalid`、`10000`、`USER_EXAMPLE`、`PASS_EXAMPLE_NOT_REAL` 均为假占位符。生产值必须来自控制台 / 订单返回。

这和 HTTP / SOCKS5、动态 / 静态是一回事吗?

不是。格式是「怎么写」;协议是「用哪种连接方式」;动态/静态是「买哪种产品」。协议见 zt-07;产品见 zt-01 与产品页。

能不能把真实密码贴在工单里方便排查?

不建议。请打码或让支持侧在已授权前提下走安全通道核对;文档与聊天保持假占位符习惯,降低泄露面。

中国大陆可以使用吗?API 文档在哪?

不可以。本站所有代理服务产品均不支持在中国大陆地区使用。程序化接入见 API 对接;逐步命令见 quickstart。更多指南见 Guides。

本站所有代理服务产品均不支持在中国大陆地区使用。

下一步

  1. 打开控制台,复制 Host / Port / User / Pass / 协议(不要用本文假主机)。
  2. 按工具选择:冒号串、URL 或四字段——对照上表。
  3. 协议不确定 → HTTP / SOCKS5 怎么配。
  4. 测通 → Docs quickstart;程序化 → API 对接。
  5. 产品与价格 → 动态 · 静态 · 定价;总览 → 怎么选购。

先回控制台复制真实字段 → 再选格式变体 → 用 quickstart 测通

还不确定?站内支持或 [email protected]。字段以控制台为准;假占位符 only;无真实凭据样例;不支持中国大陆;住宅 only;价格与库存以后台与控制台为准。