blob: 548307ffb21b11ab1d1b3aaa43b8fec6a85c1ed6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
---
title: Web
description: 在瀏覽器中使用 opencode。
---
opencode 可以在瀏覽器中作為 Web 應用程式執行，無需終端機即可提供同樣強大的 AI 程式碼體驗。
## 入門
透過執行以下指令啟動 Web 介面：
```bash
opencode web
```
這將在 `127.0.0.1` 上啟動一個具有隨機可用連接埠的本地伺服器，並自動在預設瀏覽器中打開 opencode。
:::caution
如果未設定 `OPENCODE_SERVER_PASSWORD`，伺服器將不安全。這對於本地使用來說很好，但應該針對網路存取進行設定。
:::
:::tip[Windows 使用者]
為了獲得最佳體驗，請從 [WSL](/docs/windows-wsl) 而不是 PowerShell 執行 `opencode web`。這確保了正確的檔案系統存取和終端機整合。
:::
---
## 配置
您可以使用命令列旗標或在 [設定檔](/docs/config) 中配置 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 將顯示本地位址和網路位址：
```
Local access: http://localhost:4096
Network access: http://192.168.1.100:4096
```
### mDNS 探索
啟用 mDNS 以使您的伺服器在本地網路上可探索：
```bash
opencode web --mdns
```
這會自動將主機名稱設定為 `0.0.0.0` 並將伺服器廣播為 `opencode.local`。
您可以自定義 mDNS 網域名稱以在同一網路上執行多個實例：
```bash
opencode web --mdns --mdns-domain myproject.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 工作階段的存取。
### 工作階段
從主頁查看和管理您的工作階段。您可以查看活動工作階段並開始新工作階段。
### 伺服器狀態
單擊「查看伺服器」可查看連接的伺服器及其狀態。
---
## 連接終端機
您可以將終端機 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` 設定檔中配置伺服器設定：
```json
{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}
```
命令列旗標優先於設定檔設定。
|
