跳到正文

Cursor 用 SOCKS5 还是 HTTP 代理?

代理有用户名和密码时,给 Cursor 填 HTTP 地址(端口 2222),别填 SOCKS5。

结论:用 HTTP

Cursor 基于 VS Code。VS Code 文档把带认证的代理(Basic、Digest、NTLM、Negotiate)列为支持,同时说 SOCKS5 代理认证尚未实现。Cursor 文档对 SOCKS 代理只字未提,所以带登录的 SOCKS5 地址是在赌,HTTP 地址才是有文档依据的做法。

如果你的 IP 只有 SOCKS5,可以在本机跑一个小转发器,不必重新买;末尾有说明。

你手里是什么,就在 Cursor 里填什么

你手里是什么,就在 Cursor 里填什么
项目在 Cursor 里填原因
按 HTTP 买的静态 ISP(按 IP 计)http://LOGIN:PASSWORD@HOST:2222它本来就是 HTTP 资产。
按 SOCKS5 买的静态 ISP(按 IP 计)同一组账号,走 HTTP 端口 22222026-11-04 实测:按 IP 租的 IP 也能用另一种协议的端口连接。
动态住宅同一组账号,走 HTTP 端口 2222HTTP 2222 和 SOCKS5 3333 都能用,Cursor 里填 HTTP。
按流量买的静态 ISP(Fixed ISP)新买的:同一组账号密码,走 HTTP 端口 2222新买的按流量 Fixed ISP,HTTP 2222 和 SOCKS5 3333 都能用。控制台标“仅 HTTP”的老线路,也走 HTTP。

协议和端口来自 Proxy302 产品事实表(HTTP 2222、SOCKS5 3333);测试于 2026-11-04,通过公开入口访问 ipinfo.io。

设置填在哪

在 Cursor 里打开设置,搜索 proxy,把表里的地址填进 HTTP 代理项(即 http.proxy),然后重启 Cursor。VS Code 页面说 http.proxy 是旧版设置,只在它没点名的两种情形下生效,Cursor 也没有文档,所以别默认它生效了:要测。

打开 Cursor Settings > Network,点 Run Diagnostics。检查通过,说明 Cursor 测试的那条连接用上了代理。

Cursor 用户设置(JSON)

{
  "http.proxy": "http://LOGIN:PASSWORD@HOST:2222"
}

仅为示例:HOST、LOGIN、PASSWORD 到“我的资产”里复制;2222 是 HTTP 端口。

在 Cursor 之外测试代理

# HTTP, port 2222
curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json

# SOCKS5, port 3333 (DNS also through the proxy)
curl -x socks5h://LOGIN:PASSWORD@HOST:3333 https://ipinfo.io/json

仅为示例:运行和你手里协议对应的那一行。

五步验证

  1. 第 1 步:看协议

    打开“我的资产”,看这个 IP 是 HTTP 还是 SOCKS5,它决定你在上面表里的哪一行。

  2. 第 2 步:用 curl 测

    运行示例里 HTTP 那一行。返回带出口 IP 的 JSON,说明代理本身是通的。

    预期结果 返回里的国家和你买的一致。

  3. 第 3 步:填 http.proxy

    把 http://LOGIN:PASSWORD@HOST:2222 填进 Cursor 的代理设置,重启 Cursor。

  4. 第 4 步:运行诊断

    Cursor Settings > Network > Run Diagnostics。

  5. 第 5 步:聊天或 Agent 卡住时

    在同一个 Network 设置里把 HTTP Compatibility Mode 设为 HTTP/1.1,重启 Cursor,这是 Cursor 文档对会拦 HTTP/2 的代理给的建议。

不好用时

诊断失败但 curl 是通的

检查 Cursor 是不是真的读到了设置:VS Code 把 http.proxy 当旧版设置。

处理 改用系统代理设置,或按分流教程只让 Cursor 走代理。

停止条件 两种方式都失败而 curl 通:完全重启 Cursor,再查防火墙。

聊天或 Agent 卡住

检查 代理上的 HTTP/2 流式传输。

处理 把 HTTP Compatibility Mode 设成 HTTP/1.1 并重启。

停止条件 仍然卡:运行诊断,把结果连同订单号发给我们。

填了 SOCKS5 地址完全不通

检查 地址带不带账号密码。VS Code 没实现 SOCKS5 登录。

处理 换成上面表格里 HTTP 的那一行。

停止条件 别在 Cursor 里继续试 SOCKS5 地址,改用 HTTP 那一行。

407 或弹出登录框

检查 用户名和密码有没有从“我的资产”完整复制。

处理 重新复制;密码里的 @、: 等字符在网址里可能需要百分号编码。

停止条件 账号密码没错而 curl 也是 407:带订单号提交工单。

代理不改变什么

可用的模型取决于各提供方的条款:Cursor 文档说所在地区不可用的模型不会出现,自带密钥时提供方封锁该地区,调用也可能失败。请在 Cursor 支持的地区使用,并用属于你自己的账号。

一个账号固定用一条 IP,不共用账号,服务要求验证就如实完成。

Cursor 代理常见问题

Cursor 支持 SOCKS5 代理吗?

它的文档没有提 SOCKS。VS Code 文档说 SOCKS5 代理认证尚未实现,所以代理带账号密码时选 HTTP。

Proxy302 的 HTTP 是哪个端口?

HTTP 是 2222,SOCKS5 是 3333。地址和账号到“我的资产”里复制。

从 SOCKS5 换成 HTTP 要重新买 IP 吗?

都不用:按 IP 买的静态 ISP IP 也能走 2222 的 HTTP;动态住宅和新买的按流量 Fixed ISP,同一组账号密码两个端口都能用。

Windsurf 这类 VS Code 衍生编辑器也一样吗?

建议用 HTTP 的原因就是 VS Code 的行为,不过每个编辑器都要用自带诊断或访问 ipinfo.io 实测一次。

有免费试用吗?

没有。最小购买是一个静态 ISP IP 一天(US$0.50)或 1 GB 动态住宅流量。

参考资料

5
  1. Visual Studio Code 文档:网络连接

    官方文档 · 确认日期:

    2026-11-16 读到:支持带认证的代理(Basic、Digest、NTLM、Negotiate);SOCKS5 代理认证尚未实现;http.proxy 相关设置在“旧版”一节,只在页面没有点名的两种情形下生效;其余情况从系统读取代理设置。

    讲的是 VS Code,Cursor 基于它。Cursor 自己的文档没有提 SOCKS5,也没有说明 http.proxy,所以要用“运行诊断”实测。

  2. Cursor 文档:常见问题排查

    官方文档 · 确认日期:

    2026-11-16 读到:Cursor Settings > Network > Run Diagnostics;流式传输用 HTTP/2,部分代理会拦截,需把 HTTP Compatibility Mode 设为 HTTP/1.1 并重启 Cursor。

  3. Cursor 文档:网络配置

    官方文档 · 确认日期:

    2026-11-16 读到:Cursor 默认用 HTTP/2 流式传输,失败时自动回退到 HTTP/1.1 的 Server-Sent Events;页面没有提到 SOCKS 代理。

  4. Cursor 文档:地区

    官方文档 · 确认日期:

    2026-11-16 读到:部分模型提供方有地区限制;所在地区不可用的模型不会出现在 Cursor 里;即使用自己的密钥,提供方封锁该地区时调用也可能失败。

  5. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站内产品事实表,2026-11-16 核对:价格(US$,1 PTC = US$1)、租期、协议与端口(HTTP 2222、SOCKS5 3333)、各产品能用哪种协议连接、国家与城市定向、无免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。