首次接入怎么写代理格式:host:port:user:pass、http(s)/socks5 URL、以及客户端四字段怎么映射;一律以控制台为准;假占位符示例;链 HTTP/SOCKS 与 quickstart。
本页在解决什么
首次接入卡住的,经常不是「该买动态还是静态」,而是:控制台已经给出主机、端口、用户名、密码,却不知道该写成 `host:port:user:pass`、拼成代理 URL,还是拆进客户端四个输入框。本页把常见代理字符串变体与字段映射写成对照清单。
先分清三件事:
- 格式:字符串或字段怎么排(本页重点)。
- 协议:HTTP 还是 SOCKS5——见 HTTP / SOCKS5 怎么配。
- 产品:动态按 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 ```
对应关系:
- `proxy.example.invalid` → Host
- `10000` → Port(示例端口,非承诺)
- `USER_EXAMPLE` → Username
- `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` 全部为假;上线配置必须替换为控制台返回值。
假占位符与安全约定
- 文档、截图、工单、群聊:只用假占位符或打码。
- 不要把可登录的真实密码贴进 Notion、邮件原文或公开仓库。
- 轮换后:旧字符串立即作废;以控制台最新值为准。
- 分享给同事:优先发「去控制台复制」的权限说明,而不是转发明文密码。
- 本站服务仅限合法、经授权用途;不支持在中国大陆地区使用;无养号、无绕登录墙。
和协议、产品、API、Docs 怎么衔接
| 你卡在哪 | 去哪 |
|---|---|
| HTTP 还是 SOCKS5、客户端清单 | HTTP / SOCKS5 怎么配 |
| 动态还是静态、粘性怎么理解 | 动态 vs 静态 · 粘性 vs 静态 · 怎么选购 |
| 程序化下单 / 提取 | API 对接 |
| 逐步命令与测通 | Docs quickstart |
| 买哪类产品、看价 | 动态 · 静态 · 定价 |
本页不复制 API 全文,也不发明 `/products/*format*` 产品 SKU——格式是配置写法,不是单独售卖的 SKU。
测通与排错短清单
- 控制台重新复制 Host / Port / User / Pass / 协议,避免过期截图。
- 确认客户端协议下拉与控制台一致(HTTP vs SOCKS5)。
- 若用 URL:检查 `@` 位置与 userinfo 编码。
- 若用冒号串:确认工具期望的顺序;密码含 `:` 则改分字段。
- 小流量测通;失败时看客户端日志是「认证失败」还是「连不上主机」。
- 细节与命令以 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。
本站所有代理服务产品均不支持在中国大陆地区使用。
下一步
- 打开控制台,复制 Host / Port / User / Pass / 协议(不要用本文假主机)。
- 按工具选择:冒号串、URL 或四字段——对照上表。
- 协议不确定 → HTTP / SOCKS5 怎么配。
- 测通 → Docs quickstart;程序化 → API 对接。
- 产品与价格 → 动态 · 静态 · 定价;总览 → 怎么选购。
先回控制台复制真实字段 → 再选格式变体 → 用 quickstart 测通
还不确定?站内支持或 [email protected]。字段以控制台为准;假占位符 only;无真实凭据样例;不支持中国大陆;住宅 only;价格与库存以后台与控制台为准。