代理格式详解:ip:port:user:pass、user:pass@host 与 URL
同一个代理可以有四五种写法,每个工具要求的格式都不一样。本文介绍每个部分的含义、哪种格式用在哪里,以及如何在不出错的情况下转换整份列表。

代理格式就是代理的地址、端口、用户名和密码的书写顺序。最常见的 ip:port:user:pass 用冒号分隔这四个部分。其他工具可能要求 user:pass@ip:port,或者 socks5://user:pass@ip:port 这样的完整 URL。代理本身没变,变的只是写法。
格式填错是正常可用的代理“连不上”的最常见原因之一。本指南介绍每个部分、常见格式、各工具期望哪种格式,以及如何安全地转换列表。
代理的四个组成部分
| 部分 | 示例 | 含义 |
|---|---|---|
| 主机 | 203.0.113.10 或 gw.example.com | 代理服务器的 IP 地址或主机名 |
| 端口 | 8000 | 代理监听的端口;HTTP 和 SOCKS5 可能使用不同端口 |
| 用户名 | user123 | 您的代理登录名 |
| 密码 | s3cret | 与用户名对应的密码 |
有些代理还需要指定协议——HTTP(S) 或 SOCKS5。协议不包含在简单的冒号格式里,需要在工具设置中单独选择。
要点:每种格式都包含同样的四项信息。如果一个代理在某个工具里能用、在另一个工具里不能用,先检查各部分的顺序和协议。
常见代理格式
| 格式 | 示例 | 常见用途 |
|---|---|---|
| ip:port:user:pass | 203.0.113.10:8000:user123:s3cret | 代理列表、指纹浏览器、批量导入 |
| user:pass@ip:port | user123:s3cret@203.0.113.10:8000 | 脚本、命令行工具、部分机器人 |
| 带协议的 URL | socks5://user123:s3cret@203.0.113.10:8000 | curl、Python requests、浏览器扩展、需要协议的应用 |
| 仅 ip:port | 203.0.113.10:8000 | IP 白名单代理,或登录信息单独填写的工具 |
| 分开填写 | 主机、端口、用户名、密码输入框 | 系统设置、浏览器、Telegram |
您的工具需要哪种格式?
- 指纹浏览器——通常在快速粘贴框中接受
ip:port:user:pass,协议从列表中选择。参见指纹浏览器代理设置指南。 - 浏览器和操作系统——使用分开的输入框;首次连接时浏览器会要求输入用户名和密码。参见如何在浏览器中设置代理。
- curl 和代码——需要 URL 形式,例如
curl -x socks5h://user:pass@ip:port https://example.com。 - Telegram——服务器、端口、用户名和密码分开填写;选择 SOCKS5。
提示:URL 中使用
socks5h:// 时由代理解析域名,DNS 查询也会经过代理;普通的 socks5:// 则在您自己的电脑上解析。如何转换代理列表
如果您的列表是 ip:port:user:pass 格式,而工具要求 user:pass@ip:port,只需调整每行各部分的顺序:
- 按冒号拆分每一行——得到四个部分:主机、端口、用户名、密码。
- 按新顺序重新组合——例如
user:pass@host:port;如需 URL,在前面加上协议。 - 注意特殊字符——如果密码中含有
:或@,在 URL 格式中需要进行百分号编码(@写成%40)。 - 先测试一行——先导入一个代理,确认能连接,再导入其余的。
在电子表格中,把列表放在一列,使用“分列”并以冒号为分隔符,再按需要的顺序把各列合并。许多工具也提供导入功能,可以在菜单中选择格式。
看起来像代理失效的格式错误
- 部分顺序颠倒——工具若把
user:pass:ip:port当作ip:port:user:pass读取,就会尝试连接您的用户名。 - 协议错误——把 SOCKS5 端口当作 HTTP 使用(或反之)会失败或超时。区别见SOCKS5 与 HTTP 代理。
- 多余空格或换行符——复制的列表可能带有隐藏空格或 Windows 换行符,请清理掉。
- 缺少登录信息——对需要用户名和密码的代理只填
ip:port,会返回认证错误(通常是 HTTP 407)。
重要:代理登录信息和密码一样敏感。不要把列表粘贴到公开的转换网站或共享文档中,请在本地用电子表格或文本编辑器调整。仍然连不上?请按代理服务器无响应逐项排查。
mistPROXY 中的代理格式
每个 mistPROXY 订单都会在面板中以 host:port:user:pass 显示登录信息,可直接粘贴。您也可以下载 user:pass@ip 或 URL 格式的列表,无需手动转换。代理支持 HTTP(S) 和 SOCKS5,使用用户名和密码认证。阅读使用方法,在价格中比较套餐,然后免费注册;也可以在 Telegram @mistnetwork 联系我们的团队。
常见问题
ip:port:user:pass 是什么意思?
这是用冒号分隔成四部分的代理写法,依次为服务器地址、端口、用户名和密码。
ip:port:user:pass 和 user:pass@ip:port 有什么区别?
只是顺序不同。两者信息相同;带 @ 的写法把登录信息放在前面,常见于脚本和 URL。
SOCKS5 代理如何写成 URL?
写成 socks5://user:pass@ip:port;如果希望代理同时解析域名,使用 socks5h://。
导入列表后代理为什么不能用?
最常见的原因是各部分顺序错误、协议错误、隐藏空格,或缺少用户名和密码。请先测试单独一行。
如果密码中有 @ 或冒号怎么办?
冒号格式可能会出错;在 URL 格式中该字符必须进行百分号编码,例如 @ 写成 %40。


