> ## 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 浏览器预览

> 通过私有链接打开在 Devin 的机器上运行的 Web 应用。了解预览 URL、访问权限、多端口、端口隧道以及休眠中的会话的工作方式。

浏览器预览是一个私有链接，指向在 Devin 的机器上运行的 Web 应用程序。Devin 在会话中启动开发服务器后，可以暴露相应端口，并为你提供一个可在 Web 浏览器中打开的链接。

预览适用于任何技术栈。只要应用在某个端口上提供 HTTP 服务，Devin 就能预览。应用及其数据始终保留在 Devin 的机器上，不会上传到任何第三方服务。

> [!NOTE]
>
> 本页介绍的是 Devin 会话中的预览。如需在 Devin Desktop 中预览本地开发服务器，请参阅 [Devin Desktop 预览](https://docs.devin.ai/zh/desktop/previews.md)。

## 打开预览

当 Devin 启动了需要你查看的应用时，会自动打开预览。你也可以主动要求预览，例如“预览这个应用”。

Devin 会在聊天中发布一张 **Open preview** 卡片。点击该卡片，即可在会话的**预览**选项卡中打开应用。若按住 Cmd 或 Ctrl 点击，或用鼠标中键点击该卡片，则会在新的浏览器选项卡中打开预览。

对于从 Slack 发起的会话，会话线程中会显示 **Open preview** 链接。

## 预览 URL

预览 URL 的格式如下：

```
https://<name>--<id>.preview.devinapps.com
```

名称取自 Devin 为预览设置的名称。id 是随机生成的，因此该 URL 无法被猜测。

该 URL 归属于会话。即使 Devin 重启应用或将其迁移到其他端口，URL 也保持不变。不同会话中的预览会分配到不同的 URL。

预览 URL 还支持另一种语法，可单独访问 devin 在机器上暴露的各个端口：

```
https://<port>--<devin-id>.preview.devinapps.com
```

这些端口必须由 Devin 主动暴露，但一旦暴露，任何人都可以访问。

## 谁可以打开预览

预览是私有的，不会向公共互联网暴露任何内容。

打开预览 URL 的任何人都必须先登录 Devin。登录后，预览的访问权限与其所属会话保持一致：只要你能向该会话发送消息，就能打开它的预览。

默认情况下，您的组织中所有可以使用 Devin 会话的成员都能访问，因此你可以直接把链接发给队友，对方点开即可查看。如果会话仅限其所有者或特定人员访问，则只有这些人能打开该预览，其他人会看到提示预览不可用的页面。

## 预览选项卡的功能

预览选项卡就像一个小型浏览器，提供前进、后退、刷新、缩放和页内查找按钮，以及一个设备尺寸切换器，可在桌面、平板和手机宽度之间切换。

你还可以在页面上添加标注，告诉 Devin 需要修改哪些内容。在会话中使用“选择”按钮时，只需点击某个元素或拖动框选一个区域，添加备注，然后发送到聊天即可。Devin 会同时收到你选中的元素和备注。

## 使用多个端口的应用

一个预览可以涵盖多个端口，例如前端运行在一个端口上，后端 API 运行在另一个端口上。Devin 打开预览时会列出所有端口，预览默认打开第一个端口。你可以通过预览选项卡中的 **Ports** 菜单在这些端口之间切换。

你的前端无需感知预览 URL。如果页面调用 `http://localhost:8000`，预览会将该请求发送到 Devin 的机器上的 8000 端口。预览会安装一个 service worker，由它在你的浏览器中重写这些请求；WebSocket 连接也按同样的方式处理。由于请求始终使用预览自身的地址，你无需更改 CORS 设置。

此功能仅适用于 Devin 已为预览公开的端口。

## 您的应用看到的内容

在您的服务器看来，请求来自 `localhost`。预览会在请求到达您的应用之前，将 `Host` 和 `Origin` 标头设置为 `localhost`，因此会检查主机名的开发服务器无需额外配置即可正常工作。Devin 在运行和测试应用时也同样使用 `localhost`。

与在您自己的计算机上运行应用相比，以下几方面的行为有所不同：

* **Service worker。** 预览使用自己的 service worker，因此您的应用无法再注册 service worker。如果您的应用是 PWA，请在开发环境中关闭 service worker，否则自动端口重写可能无法正常工作。
* **Cookie。** 您的应用在预览选项卡中设置的 Cookie，与在独立浏览器选项卡中打开预览时设置的 Cookie 相互隔离。如果您在其中一处登录了应用，在另一处可能需要重新登录。
* **通过身份提供商登录。** 您的浏览器访问的是预览 URL，而不是 `localhost`。如果只将 `localhost` 注册为重定向 URL，Microsoft Entra ID、Okta 或 Google 等提供商会拒绝登录。请参阅[端口隧道](#tunneling-ports)。
* **HTTPS 开发服务器。** 您的浏览器看到的是 Devin 的证书，而不是您服务器的证书。请参阅 [HTTPS 回环](#https-loopback)。

## 端口隧道

有些服务要求你的浏览器确实运行在 `localhost` 上才能正常工作，最常见的就是通过身份提供商登录。身份提供商只接受你已注册的重定向 URL，而大多数开发环境注册的都是 `http://localhost:<port>`。预览有自己的 URL，因此会被身份提供商拒绝。

遇到这种情况，你可以通过隧道将端口从 Devin 的机器转发到你自己的计算机。这样，应用就会在你的浏览器中以 `http://localhost:<port>` 打开，与在本机运行时完全相同，身份提供商也会接受该地址。

建立端口隧道有两种方式：

* **Devin Desktop。** 在 Devin Desktop 中打开会话，并在其中转发端口。
* **SSH。** 运行 `devin forward <session> 3000`，或者向 `devin ssh` 或普通的 `ssh` 传入 `-L 3000:localhost:3000`。参见[转发端口](https://docs.devin.ai/zh/cli/ssh.md#forward-ports)。

隧道只对运行它的那台计算机有效，因此无法作为链接分享给队友。需要共享时请使用预览，需要 `localhost` 的场景则使用隧道。

如果你更想继续使用预览，可以将会话的预览 URL 添加到身份提供商的重定向 URL 列表中，或者为应用提供一种绕过身份提供商的开发登录方式。Devin 也可以在它自己的浏览器中通过 `localhost` 登录。参见 [Interactive Browser](https://docs.devin.ai/zh/work-with-devin/devin-session-tools.md#interactive-browser)。

## HTTPS 回环

如果开发服务器在其端口上提供 HTTPS 服务，无需额外配置即可在预览中使用。Devin 会检测到该端口使用 HTTPS，并通过 HTTPS 与其建立连接。

你的浏览器不会看到你服务器的证书，因为预览 URL 使用的是 Devin 的证书。与你的开发服务器之间的连接是在 Devin 的机器上建立的，且不会在那里检查你的证书，因此自签名的开发证书可以正常使用，不会出现警告。

这一点仅在少数情况下需要注意，例如某个应用要求浏览器看到一个具体的证书。

## 休眠中的会话

会话空闲时，Devin 的机器会进入休眠状态。你无需手动唤醒它：打开预览即可唤醒机器，应用会在原 URL 上恢复运行。首次加载页面可能需要几秒钟。

预览使用期间，机器会保持唤醒状态，并在最后一次请求约 5 分钟后再次进入休眠。

会话归档或结束后，预览将无法使用。

## 预览与 Devin Apps

预览与单个会话绑定，适合用来查看进行中的工作、审查变更，或向队友展示 Devin 构建的成果。大多数情况下，预览就已足够。

Devin Apps 则面向另一类场景：会话工作结束后，您的团队仍会持续使用的内部工具、仪表板或类似应用。如果你要构建的正是这类应用，可以让 Devin 将预览发布为 [Devin App](https://docs.devin.ai/zh/product-guides/devin-apps.md)。Devin Apps 与预览的运行方式相同，都由 Devin 的机器提供服务，但拥有稳定的 URL 以及一套独立且完善的共享设置。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.