Windsurf 怎么设置代理：Http: Proxy 设置与验证

代理不会改变什么

本文讨论网络设置，而非服务可用性。本文所用的 Windsurf 文档页面没有说明其模型的地区可用性和使用条款，请自行阅读服务本身和模型提供商的最新条款。代理只改变你的流量从哪里出去，它不会让服务在原本不可用的地区变得可用，也不会改变服务条款、套餐额度或模型提供商的规则。

在哪里设置代理

Windsurf 的文档现在放在 docs.devin.ai/desktop，把这个编辑器称作 Devin Desktop Editor，旧的 docs.windsurf.com 地址会跳转过去。所以设置里的名称也是这样：你会看到 Devin Settings，而不是 Windsurf Settings。按文档，点右上角的下拉菜单选择 Devin Settings，或者打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）运行 Open Devin User Settings，然后在设置搜索栏输入 proxy。

本地有两个选项。Detect proxy 是一个开关，会沿用系统网络设置或 PAC 文件（一个告诉电脑该走哪个代理的小文件）里已有的代理；打开后重启编辑器，如果出了问题就关掉它，改用手动设置。Http: Proxy 是手动设置：填入带协议和端口的代理地址，例如 http://proxy.company.com:8080。改完后关闭设置页并重启编辑器。

文档只用标签 Http: Proxy 指代这个字段，没有写出它在 settings.json 里的键名；文档里写出键名的只有授权那一项，即 http.proxyAuthorization。由于编辑器基于 VS Code，手动字段很可能存为 http.proxy，但在下面的检查通过之前，请当作未确认。

• 来源：
• Windsurf 文档（现称 Devin Desktop）：Proxy Configuration

在哪里设置代理：示例

http://USERNAME:PASSWORD@HOST:PORT

Http: Proxy 字段填这个地址。把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

用户名和密码

Windsurf 文档说编辑器没有单独的用户名和密码输入框，并给出三种方式。第一种也是文档推荐的：地址里不写账号密码，编辑器询问时在代理登录框里输入；勾选 Remember my credentials 后，会加密保存在你的电脑上。第二种是写进地址，如 http://USERNAME:PASSWORD@HOST:PORT；文档提醒 @、: 或 / 这类字符可能解析不对，所以登录框更稳妥。第三种是 Http: Proxy Authorization 字段：点 Edit in settings.json，填代理提供方给你的请求头内容。

文档还提醒：Http: Proxy 和 Http: Proxy Authorization 里的值会以明文存在 settings.json 中，可能通过备份或共享的设置文件泄露。不要把这个文件提交到代码仓库。

如果你确实把账号密码写进地址，请对特殊字符做百分号编码：@ 变为 %40，: 变为 %3A，/ 变为 %2F，# 变为 %23，% 变为 %25。

• 来源：
• Windsurf 文档（现称 Devin Desktop）：Proxy Configuration

HTTP 还是 SOCKS5

Windsurf 文档没有说明支持哪些代理类型，也没有提到 SOCKS5。VS Code 文档说，带认证的代理支持 Basic、Digest、NTLM 和 Negotiate，而 SOCKS5 的认证尚未实现。所以带用户名和密码的代理，请选 HTTP。

• 来源：
• Windsurf 文档（现称 Devin Desktop）：Proxy Configuration
• Visual Studio Code 文档：Network Connections

远程开发（SSH 和开发容器）

远程开发有自己的字段，与本地的互相独立。在 User → Extensions 里找到 Remote › Devin SSH: Http Proxy 和 Remote › Devin SSH: Https Proxy，填入代理地址，通常带协议和端口。文档说有些环境需要本地和远程两处都填。改完后，关闭远程窗口重新连接，或重启开发容器。

• 来源：
• Windsurf 文档（现称 Devin Desktop）：Proxy Configuration

如何验证代理是否正常工作

1. 第 1 步

   先看编辑器本身。Windsurf 文档没有给出测试命令；操作失败时，它的做法是重新加载编辑器或 Cascade（它的 AI 对话）再试一次。连接正常的迹象是：编辑器和 Cascade 能加载，Failed to connect 之类的报错不再出现，登录成功。

2. 第 2 步

   在终端里用下面的命令单独测试代理。它会显示网站看到的 IP、国家和网络。ip、country、city 和 org 这几个字段怎么读，见代理 IP 怎么查。

   • 代理 IP 怎么查

3. 第 3 步

   如果防火墙或 VPN 过滤网络，请放行 Windsurf 故障排查页列出的域名。该页列出：.codeiumdata.com、update.windsurf.com、.windsurf.com、.codeium.com、.googleapis.com 和 apis.google.com（用于登录），以及 static.devin.ai。

如何验证代理是否正常工作：示例

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

常见错误

• 407 Proxy Authentication Required。 代理拒绝了用户名或密码。请改用登录框而不是写进地址，从「我的资产」重新复制，如果仍写在地址里，请检查百分号编码。

• 编辑器一直空白或提示 Failed to connect。 代理地址、端口或协议不对，或者 IP 租约已到期。请用上面的 curl 命令测试。

• 保存设置后没有变化。 文档要求关闭设置页并重启编辑器，远程窗口需要重新连接。

• 证书错误。 本文所用的 Windsurf 页面没有讲证书。VS Code 文档把「将代理证书添加到操作系统的受信任证书中」列为首选做法，并称关闭证书校验有危险。

• 来源：
• Windsurf 文档（现称 Devin Desktop）：Proxy Configuration
• Visual Studio Code 文档：Network Connections

用 Proxy302 怎么做

如果需要一个固定地址，静态住宅 ISP 合适：IP 在租期内固定、不会变化，购买时选择 HTTP 即可。下单页上没有 Windsurf 专用预设，下面的链接会打开面向 AI 工具的静态 ISP 页面。Cursor 代理设置一页用同类编辑器讲了同一个产品。

• Cursor 代理设置
• 静态住宅（ISP）代理

用 Proxy302 怎么做：步骤

1. 第 1 步

   打开静态住宅 ISP 页面，选择国家，把「协议」设为 HTTP，再选「租期」和「数量」，然后点击「确认费用并生成」。

2. 第 2 步

   打开「我的资产」并复制 HOST、PORT、USERNAME 和 PASSWORD。「连接工具」页里有填好你自己连接信息的现成示例。HTTP 端口为 2222。

3. 第 3 步

   把 HTTP 地址粘贴到 Http: Proxy 字段（或者只粘贴不带账号密码的地址，再在登录框里输入用户名和密码），然后重启 Windsurf。

4. 第 4 步

   确认编辑器能加载并登录，再用 curl 请求检查出口。

价格与限制

静态住宅 ISP IP 的价格是一天 US$0.50、30 天 US$7.99，约合每天 US$0.27，各国价格一致。各国的库存每天都会变化，以下单页面为准。没有免费试用，最小购买量是 1 个 IP、1 天。

• 来源：
• Proxy302 产品事实与价格表

相关指南

同样基于 VS Code 的设置，另一个编辑器的写法见 Cursor 指南，最基础的 VS Code 步骤见 VS Code 指南。

• Cursor 代理设置
• VS Code 代理设置

常见问题

接着读

Cursor 代理

Cursor 代理设置：固定静态 ISP IP，配好 http.proxy 和 HTTP/1.1 兼容模式，出口固定在美国等模型厂商服务的地区——桌面端按这个地区决定你能看到哪些模型。

查看配置与价格

Cursor 怎么设置代理

在 Cursor 中用 http.proxy 设置代理，处理密码里的特殊字符，流式响应卡住时切换到 HTTP/1.1，并用 Run Diagnostics 验证。

VS Code 怎么设置代理

在 VS Code 中设置代理：编辑器和扩展分别从哪里取代理、http.proxy、用户名和密码、终端，以及验证。

代理 IP 怎么查：IP 地址、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。