远程开发使用指南

📑 目录

服务总览 — 部署了什么
架构图 — 各服务如何协作
三种远程接入方式
方式一：VS Code Remote SSH（推荐开发）
方式二：VS Code Web（浏览器直接写代码）
方式三：WorkBuddy AI 助手
方式四：OpenClaw AI Gateway
方式五：AList 文件管理
方式六：RDP 远程桌面
快速参考卡
常见问题排查

1. 服务总览

本机（Windows Server）部署了以下 AI 工具和开发服务，全部通过 Nginx 反向代理统一暴露在 80 端口：

🤖

WorkBuddy

端口 8080 · Nginx 代理 /workbuddy/

AI 办公助手，自然语言操作服务器。可在任意浏览器中使用，支持代码编写、文件操作、命令执行等。

💻

VS Code Web

端口 8082 · Nginx 代理 /code/

浏览器版完整 VS Code IDE，支持终端、Git、插件扩展。免密码直接访问。

🦞

OpenClaw AI Gateway

端口 18789 · Nginx 代理 /openclaw/

AI 网关服务，提供 AI Agent 工作区。密码: admin123

📁

AList 文件管理

端口 5244 · Nginx 代理 /files/

网盘聚合管理，支持阿里云盘、百度网盘、OneDrive 等。用户名: admin

🗄️

PostgreSQL

端口 5432

关系型数据库。用户: postgres · 密码: postgres123

⚡

Redis

端口 6379

内存缓存数据库，无密码。

🔐

SSH / RDP

端口 22 / 3389

SSH 远程终端 · RDP 远程桌面。用户: Administrator

🌐

Nginx 反向代理

端口 80

统一入口，将各服务代理到子路径。仪表盘在根路径。

2. 架构图

3. 三种远程接入方式

核心原理：所有服务都绑定到 0.0.0.0（全网卡），无论你用哪种网络接入，都能访问。区别只在于「走哪条网络管道」。

方式	网络	地址	适用场景	需要安装
局域网	同一 WiFi/网段	`192.168.124.133`	在家里/办公室同一网络下	无
Tailscale	虚拟内网 (VPN)	`100.102.7.24`	在任何地方远程访问（咖啡厅、出差）	Tailscale 客户端
RDP	局域网/Tailscale	远程桌面连接	需要图形界面操作服务器	RDP 客户端

4. 方式一：VS Code Remote SSH（推荐开发）

这是最推荐的远程开发方式——在你本地电脑的 VS Code 中直接编辑服务器上的代码，体验和本地开发完全一致。

在客户端电脑安装 VS Code

下载地址：https://code.visualstudio.com/（Windows/Mac/Linux 均可）

安装 Remote - SSH 扩展

打开 VS Code → 左侧扩展面板（Ctrl+Shift+X）→ 搜索 Remote - SSH → 安装

如果是外网访问，先安装 Tailscale

下载 Tailscale → 安装 → 登录与服务器相同的账号（C906YA@）→ 确认能 ping 通 100.102.7.24

连接到服务器

按 F1 → 输入 Remote-SSH: Connect to Host → 输入以下命令之一：

# 局域网（同一网络下）
ssh Administrator@192.168.124.133

# Tailscale（外网/任意网络）
ssh Administrator@100.102.7.24

# 密码就是 Windows 登录密码

打开项目目录开始开发

连接成功后，VS Code 左下角会显示绿色 SSH 标识。点击「打开文件夹」→ 选择服务器上的项目目录（如 D:\Server\www 或 C:\Users\Administrator\WorkBuddy）

💡 提示：可以配置 SSH 密钥免密登录。在客户端执行 ssh-keygen 生成密钥，然后将 ~/.ssh/id_rsa.pub 内容追加到服务器的 C:\Users\Administrator\.ssh\authorized_keys 文件中。

5. 方式二：VS Code Web（浏览器直接写代码）

无需安装任何软件，打开浏览器就能用完整 VS Code。适合临时使用或平板/手机操作。

局域网

http://192.168.124.133/code/

Tailscale（外网）

http://100.102.7.24/code/

本机

http://localhost/code/

✅ 特点：免密码直接访问 · 完整终端 · 支持安装扩展 · 支持打开任意目录

6. 方式三：WorkBuddy AI 助手

AI 编程助手，用自然语言描述需求，AI 自动帮你写代码、操作文件、执行命令。

访问 WorkBuddy

在浏览器打开以下地址之一：

# 本机（自动填密码）
http://localhost:8080/?password=hTkrOUYlMfO94sFEXfRAk5oBaAw6MbGVe9lXmI36YSE

# 局域网
http://192.168.124.133:8080/?password=hTkrOUYlMfO94sFEXfRAk5oBaAw6MbGVe9lXmI36YSE

# Tailscale（外网）
http://100.102.7.24:8080/?password=hTkrOUYlMfO94sFEXfRAk5oBaAw6MbGVe9lXmI36YSE

# 通过 Nginx 代理（推荐，走 80 端口）
http://100.102.7.24/workbuddy/

输入密码登录

如果通过 Nginx 代理访问（/workbuddy/），在密码栏输入：

hTkrOUYlMfO94sFEXfRAk5oBaAw6MbGVe9lXmI36YSE

开始使用

可以直接在对话框中描述你的需求，如「在 D:\Server\www 下创建一个 HTML 页面」「查看 Redis 里的所有 key」「执行 git status」等。

⚠️ 注意：WorkBuddy 密码每次重启服务可能会变化。查看最新密码：
type D:\Server\logs\codebuddy-serve.log

7. 方式四：OpenClaw AI Gateway

AI Agent 网关，提供独立的 AI 工作空间。

# 本机
http://localhost/openclaw/

# 局域网
http://192.168.124.133/openclaw/

# Tailscale（外网）
http://100.102.7.24/openclaw/

# 直接访问（不走代理）
http://100.102.7.24:18789/

🔑 密码：admin123

8. 方式五：AList 文件管理

通过浏览器管理服务器文件，还可以挂载网盘（阿里云盘、百度网盘、OneDrive 等）。

# 本机
http://localhost/files/

# Tailscale（外网）
http://100.102.7.24/files/

🔑 登录：用户名 admin · 密码需要查看或重置：
cd D:\Server\alist && .\alist.exe admin random（重置为随机密码）
cd D:\Server\alist && .\alist.exe admin set NEW_PASSWORD（设置指定密码）

9. 方式六：RDP 远程桌面

完整图形化操作服务器桌面，就像坐在服务器前面一样。

打开远程桌面连接

Windows: Win+R → 输入 mstsc → 回车

Mac: 下载 Microsoft Remote Desktop

输入服务器地址

# 局域网
192.168.124.133

# Tailscale（外网）
100.102.7.24

10. 快速参考卡

🔒 HTTPS 访问（解决浏览器「不安全」警告）

服务器已自动签发自签名证书（HTTPS 443 端口已启用）。首次访问 HTTPS 地址时浏览器会提示「您的连接不安全」，这是因为证书不是公共 CA 签发的。三种解决方案：

方案 A：手动信任证书（最常用）
1. 浏览器访问 https://100.102.7.24/（或局域网 IP）
2. 点击「高级」→ 「继续前往 100.102.7.24（不安全）」
3. 之后浏览器会记住这个例外，刷新页面不再提示

方案 B：永久信任证书（推荐，警告彻底消失）
1. 下载证书：http://100.102.7.24/devserver.crt（注意是 HTTP 触发下载）
2. 双击 cert → 安装证书 → 当前用户 → 将所有证书放入下列存储 → 受信任的根证书颁发机构 → 完成
3. Mac/Linux: sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain devserver.crt

方案 C：Tailscale Serve（最干净，证书全自动）
1. Tailscale 管理员访问 https://login.tailscale.com/f/serve?node=nrkyAvggkd11CNTRL 开启 Serve
2. 回到服务器执行：tailscale serve --bg --https=443 http://localhost:80
3. 之后所有 HTTPS 链接都是 Tailscale CA 签发的合法证书，浏览器零警告

📋 所有地址一览

服务	本机	局域网 / Tailscale	凭据
📊 仪表盘	`http://localhost/`	`http://IP/`	无
💻 VS Code Web	`http://localhost/code/`	`http://IP/code/`	免密码
🤖 WorkBuddy	`http://localhost:8080/`	`http://IP:8080/` 或 `http://IP/workbuddy/`	密码见日志
🦞 OpenClaw	`http://localhost/openclaw/`	`http://IP/openclaw/`	admin123
📁 AList	`http://localhost/files/`	`http://IP/files/`	admin
🗄️ PostgreSQL	`localhost:5432`	`IP:5432`	postgres / postgres123
⚡ Redis	`localhost:6379`	`IP:6379`	无密码
🔐 SSH	`ssh Administrator@localhost`	`ssh Administrator@IP`	Windows密码
🖥️ RDP	—	mstsc → IP	Windows密码

📌 IP 替换规则： 局域网用 192.168.124.133 · Tailscale 用 100.102.7.24

🔧 常用管理命令

# 启动所有服务
powershell -ExecutionPolicy Bypass -File D:\Server\start-all.ps1

# 重载 Nginx 配置（修改 nginx.conf 后）
D:\Server\nginx-1.26.2\nginx.exe -s reload

# 停止 Nginx
D:\Server\nginx-1.26.2\nginx.exe -s stop

# 查看 WorkBuddy 密码
type D:\Server\logs\codebuddy-serve.log

# Redis CLI
D:\Server\redis\redis-cli.exe -p 6379

# PostgreSQL CLI
D:\Server\pgsql\bin\psql.exe -U postgres -h localhost

# 重置 AList 密码
cd D:\Server\alist && .\alist.exe admin random

11. 常见问题排查

Q: 外网访问不了怎么办？

排查步骤：
1. 确认服务器和客户端都运行 Tailscale 且登录同一账号
2. 在客户端 ping 100.102.7.24 确认网络通畅
3. 确认服务器上 Tailscale 服务正在运行
4. 如果是新设备，在 Tailscale 管理面板确认设备已授权

Q: WorkBuddy 打不开或密码不对？

排查步骤：
1. 检查服务是否运行：netstat -ano | findstr :8080
2. 查看最新密码：type D:\Server\logs\codebuddy-serve.log
3. 如需重启：运行 start-all.ps1 会自动检测并跳过已运行的服务
4. 手动重启 WorkBuddy：先 taskkill /PID 进程号 /F 再运行启动脚本

Q: VS Code Remote SSH 连接超时？

排查步骤：
1. 确认 SSH 服务运行：Get-Service sshd
2. 确认端口开放：防火墙允许 22 端口
3. Tailscale 模式下确认 VPN 连接正常
4. 尝试在终端手动 SSH：ssh Administrator@100.102.7.24 看报错信息

Q: VS Code Web 加载缓慢？

首次加载需要下载 VS Code 前端资源，属正常现象。后续访问会走浏览器缓存。如果持续缓慢，检查网络带宽。

Q: 如何添加新的 AI 工具？

1. 安装工具并启动服务（绑定 0.0.0.0）
2. 在 D:\Server\nginx-1.26.2\conf\nginx.conf 中添加 location 反向代理
3. 执行 D:\Server\nginx-1.26.2\nginx.exe -s reload 重载配置
4. 在 D:\Server\www\index.html 仪表盘添加入口卡片
5. 更新 start-all.ps1 添加启动逻辑

🚀 远程开发使用指南