Web - OpenCode Docs | OpenCode Tutorial

OpenCode 可以在您的浏览器中作为 Web 应用程序运行，无需终端即可提供同样强大的 AI 编码体验。

OpenCode Web - 新会话

##开始使用

运行以下命令启动 Web 界面：

bash

opencode web

这将在 127.0.0.1 上启动一个本地服务器，并使用一个随机的可用端口，并自动在您的默认浏览器中打开 OpenCode。

:::caution 如果未设置 OPENCODE_SERVER_PASSWORD，则服务器将是不安全的。这对于本地使用来说是可以的，但应该为网络访问进行设置。 :::

您可以使用命令行标志或在您的配置文件中配置 Web 服务器。

默认情况下，OpenCode 会选择一个可用的端口。您可以指定一个端口：

bash

opencode web --port 4096

默认情况下，服务器绑定到 127.0.0.1（仅限 localhost）。要使 OpenCode 在您的网络上可访问：

bash

opencode web --hostname 0.0.0.0

当使用 0.0.0.0 时，OpenCode 将显示本地和网络地址：

bash

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

启用 mDNS 以使您的服务器在本地网络上可被发现：

bash

opencode web --mdns

这会自动将主机名设置为 0.0.0.0 并将服务器广播为 opencode.local。

要允许 CORS 的其他域名（对于自定义前端很有用）：

bash

opencode web --cors https://example.com

要保护访问，请使用 OPENCODE_SERVER_PASSWORD 环境变量设置密码：

bash

OPENCODE_SERVER_PASSWORD=secret opencode web

用户名默认为 opencode，但可以使用 OPENCODE_SERVER_USERNAME 更改。

启动后，Web 界面提供对您的 OpenCode 会话的访问。

从主页查看和管理您的会话。您可以查看活动的会话并启动新的会话。

OpenCode Web - 活动会话

单击“查看服务器”以查看连接的服务器及其状态。

OpenCode Web - 查看服务器

您可以将终端 TUI 附加到正在运行的 Web 服务器：

bash

# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096

这允许您同时使用 Web 界面和终端，共享相同的会话和状态。

您还可以在 opencode.json 配置文件中配置服务器设置：

bash

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

命令行标志优先于配置文件设置。