Web

在浏览器中使用 OpenCode。

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

# 快速开始#

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

bash
复制
opencode web

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

注意： 如果未设置 OPENCODE_SERVER_PASSWORD，服务器将是不安全的。本地使用没问题，但如果需要网络访问，建议进行设置。

---

# 配置#

你可以使用命令行参数或在 配置文件 中配置 Web 服务器。

## 端口#

默认情况下，OpenCode 会自动选择一个可用端口。你可以手动指定端口：

bash
复制
opencode web --port 4096

## 主机名#

默认情况下，服务器绑定到 127.0.0.1（仅限本地访问）。要使 OpenCode 在你的局域网内可访问：

bash
复制
opencode web --hostname 0.0.0.0

使用 0.0.0.0 时，OpenCode 会同时显示本地和网络地址：

• 本地访问：http://localhost:4096
• 网络访问：http://192.168.1.100:4096

## mDNS 服务发现#

启用 mDNS 使你的服务器在本地网络中可被发现：

bash
复制
opencode web --mdns

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

## CORS#

要为 CORS 允许额外的域名（对自定义前端很有用）：

bash
复制
opencode web --cors https://example.com

## 身份验证#

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

bash
复制
OPENCODE_SERVER_PASSWORD=secret opencode web

默认用户名是 opencode，但可以通过 OPENCODE_SERVER_USERNAME 更改。

---

# 使用 Web 界面#

启动后，Web 界面允许你访问 OpenCode 会话。

## 会话#

在主页查看和管理你的会话。你可以看到活动会话并启动新会话。

## 服务器状态#

点击 "See Servers" 查看已连接的服务器及其状态。

---

# 连接到终端#

你可以将终端 TUI 连接到正在运行的 Web 服务器：

bash
复制
1# 启动 Web 服务器
2opencode web --port 4096
3
4# 在另一个终端中，连接 TUI
5opencode attach http://localhost:4096

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

---

# 配置文件#

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

json
复制
1{
2  "server": {
3    "port": 4096,
4    "hostname": "0.0.0.0",
5    "mdns": true,
6    "cors": ["https://example.com"]
7  }
8}

命令行参数的优先级高于配置文件设置。