> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Desktop Editor 中的代理配置

> 为企业网络中的 Devin Desktop Editor 配置 HTTP/HTTPS 代理设置。包括自动检测、手动配置和 SSH 远程代理设置。

一些企业或企业级网络会通过 HTTP/HTTPS 代理转发流量。Devin Desktop Editor 需要访问少数外部服务 (用于登录和 AI 功能) ，因此你可能需要先配置代理，相关功能才能稳定运行。

尤其是在以下情况下，可能需要配置代理：

* 你看到 **"连接失败"** 或类似的网络错误

* **编辑器或 Cascade 面板显示空白界面**，且始终无法加载

* Cascade 或其他依赖云端的功能**无法加载或连接**

* 登录或激活流程意外失败

所有代理选项都位于 **Devin Settings** 中。你可以通过 **右上角下拉菜单 → Devin Settings** 打开，或通过 **命令面板 (Ctrl/⌘+Shift+P) → "Open Devin User Settings"** 打开。

***

<div id="1-check-whether-your-network-uses-a-proxy">
  ## **1. 检查你的网络是否使用代理**
</div>

在编辑器中更改任何内容之前：

1. **询问你的 IT / 基础设施 / 网络团队**：

   * 我们的出站流量是否使用 HTTP/HTTPS 代理？

   * 如果使用，是**自动**配置的 (系统设置 / PAC 文件) ，还是需要我在应用中**手动**配置？

2. 如果你的组织**不**使用代理，通常无需更改这些设置。

3. 如果你的组织确实使用代理，请向 IT 团队获取代理的详细信息 (地址、端口以及所需的任何凭据) 。

你可以把 Devin Desktop 代理设置的截图发给他们，这样他们就能准确告诉你该填写哪些内容。

***

<div id="2-use-your-system-proxy-detect-proxy">
  ## **2. 使用你的系统代理 (“Detect proxy”)**
</div>

如果你的代理**已经在设备上配置好** (例如通过系统网络设置或 PAC 文件) ，你可以让 Devin Desktop 检测并重用该代理：

1. 打开 **Devin Settings**。

2. 在设置搜索栏中输入 **"proxy"**。

3. 找到 **Detect proxy** 开关 (见截图) 。

4. 将 **Detect proxy** **打开**。

5. 关闭设置页面并**重启 Devin Desktop Editor**。

6. 再试一次：

   * 重新加载编辑器 / Cascade

   * 重新尝试登录，或重试之前失败的任何操作

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/proxy-detect-proxy-setting.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=9182f70a1e0a23bc2a3640f700082c17" width="1773" height="790" data-path="desktop/assets/windsurf/proxy-detect-proxy-setting.png" />
</Frame>

如果启用后反而无法正常工作，你可以将 **Detect proxy** 重新**关闭**，改为使用手动设置 (见下一节) ，或遵循 IT 团队的指导。

***

<div id="3-manually-configure-a-proxy-in-devin-desktop-editor">
  ## **3. 在 Devin Desktop Editor 中手动配置代理**
</div>

如果你的组织要求你在应用中**手动指定**代理：

1. 向你的 IT / 基础设施团队获取所需信息：

   * **代理协议 + 地址** (例如 `http://proxy.company.com:8080` 或 `https://proxy.company.com:8443`)

   * 代理是否**需要身份验证**

   * 如果需要，你的**代理用户名/密码**或其他凭据

2. 打开 **Devin Settings**。

3. 在设置搜索栏中输入 **"proxy"**，打开代理配置部分 (见截图) 。

4. 填写以下字段：

   * **代理 URL / 地址** – 包含协议和端口 (例如 `http://proxy.company.com:8080`)

   * **身份验证** – 如果你的代理需要身份验证，请在 UI 中显示的用户名和密码字段中输入相应信息

5. (可选，如 IT 建议) 如果你的配置仍需同时依赖系统/PAC 检测和手动设置，请将 **Detect proxy** **设为开启**。

6. 关闭设置页面并**重启 Devin Desktop Editor**，以确保新的代理配置完全生效。

7. 再试一次：

   * 如果你之前看到的是**空白屏幕**，请重新加载编辑器或 Cascade

   * 重新尝试之前因 **"连接失败"** 或类似错误而失败的操作

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/proxy-manual-configuration.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=bfd2b963c6f9c1adb61c77066415be20" width="1418" height="1430" data-path="desktop/assets/windsurf/proxy-manual-configuration.png" />
</Frame>

***

<div id="4-proxy-settings-for-remote-development-ssh-dev-containers">
  ## **4. 远程开发的代理设置 (SSH / 开发容器) **
</div>

如果你使用**远程开发** (例如开发容器或 Devin Desktop SSH 远程连接) ，则需要使用一组单独的代理设置，用于控制本地 Devin Desktop Editor 与**远程**环境之间的流量。

如果出现以下情况，你可能需要调整这些设置：

* 连接**开发容器**或 **SSH 远程连接**失败或超时

* 远程窗口能够打开，但依赖网络的工具无法正常工作

* 你的 IT / 基础设施团队要求**远程主机**也必须通过代理

要为远程环境配置代理：

1. 打开 **Devin Settings**。

2. 在搜索栏中输入 **"proxy"**。

3. 在 **用户 → 扩展** 下找到：

   * **Remote › Devin Remote SSH: Http Proxy**

   * **Remote › Devin Remote SSH: Https Proxy**

4. 输入 IT / 基础设施团队提供的代理地址 (通常包含协议和端口，例如 `http://proxy.company.com:8080`) 。

5. 重启远程会话 (关闭远程窗口并重新连接，或重启开发容器) ，然后重试。

<Note>这些**远程**代理设置独立于上文所述的常规代理 / Detect proxy 选项。在某些环境中，你可能需要同时配置**本地编辑器代理**和 Devin Remote SSH 代理。</Note>

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/proxy-remote-ssh-settings.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=10c4e7af9b439052357659dc230d6f6e" width="1938" height="903" data-path="desktop/assets/windsurf/proxy-remote-ssh-settings.png" />
</Frame>

***

<div id="5-when-to-use-which-option">
  ## **5. 何时使用哪个选项**
</div>

* **仅在以下情况下使用“Detect proxy”**：

  * 你的组织会在你的设备上集中配置代理 (系统网络设置、PAC 文件) ，**并且**

  * IT 告诉你，应用应该“自动读取系统代理设置”。

* **在以下情况下使用手动配置 (可结合“Detect proxy”使用，也可单独使用) **：

  * IT 给了你需要在各个应用中分别输入的具体代理 URL 和凭据，或者

  * 你所在环境中的自动检测不可靠，或不受支持。

如果你不确定自己属于哪种情况，你的 **IT / 基础设施团队才是准确信息来源**——他们可以确认你是否需要配置代理、应填写哪些内容，以及是否应打开或关闭 **“Detect proxy”** 开关。
