Skip to content

docs: polish dashboard port reuse wording #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zhh293 merged 1 commit into from
Jul 8, 2026
Merged

docs: polish dashboard port reuse wording #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion dashboard/BACKEND.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ function addLog(name, line, stream = 'stdout') {

> 关键设计：proxy-local 不注入任何自定义 DNS 参数，始终使用系统默认 DNS。系统代理模式下 `DirectRelayHandler` 通过系统 DNS 解析直连域名；TUN 模式下所有流量（含 Direct）由远端做 DNS 解析，`DirectRelayHandler` 不会被调用。
>
> 端口复用（已修复的冲突）：`startProxyLocal` 在启动前先用 `isPortListening(1080)` 检测，若 1080 已在监听（例如先开了系统代理、或外部 start-tun.sh 起过）则**复用现有监听、跳过启动**（返回 `{ ok:true, reused:true }`），不再无脑 `killProcessOnPort(1080)` 重启，避免瞬断正在服务的连接。
> 端口复用（已修复的冲突）：`startProxyLocal` 在启动前先用 `isPortListening(1080)` 检测，若 1080 已在监听（例如先开了系统代理、或外部 start-tun.sh 起过）则**复用现有监听、跳过启动**（返回 `{ ok:true, reused:true }`），不再直接调用 `killProcessOnPort(1080)` 重启，避免瞬断正在服务的连接。

### 3.4 tun-adapter 生命周期（最复杂）

Expand Down
2 changes: 1 addition & 1 deletion dashboard/FRONTEND.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -243,7 +243,7 @@ function switchSection(name) {
| `quickStartTun()` | 启动 proxy-local → 等 3s → 启动 tun-adapter（若弹授权对话框则等 8s） |
| `quickStopAll()` | 关系统代理 → 停 tun-adapter → 停 proxy-local |

> 端口冲突已修复：后端 `startProxyLocal` 现在检测到 1080 已在监听就复用、跳过启动（不再无脑杀进程重启），因此「先开系统代理、再一键 TUN」不会再瞬断 proxy-local。
> 端口冲突已修复：后端 `startProxyLocal` 现在检测到 1080 已在监听就复用、跳过启动（不再直接杀进程重启），因此「先开系统代理、再一键 TUN」不会再瞬断 proxy-local。

### 7.3 TUN 权限失败的前端提示

Expand Down
Loading