🖥️ SSH 远程
NeoWeb AI 内置完整的 SSH 工具集，让 AI 可以直接操作你的远程服务器——执行命令、读写文件、上传下载、一键部署，无需你来回切换终端。
添加服务器
方式一：在 UI 中添加
进入 设置 → SSH 服务器 → 添加服务器，填写：
| 字段 | 说明 | 示例 |
|---|---|---|
| 名称 | 服务器别名（用于在对话中引用） | prod-server |
| 主机 | IP 地址或域名 | 192.168.1.100 |
| 端口 | SSH 端口（默认 22） | 22 |
| 用户名 | 登录用户 | ubuntu |
| 认证方式 | 密码或 SSH 私钥 | — |
方式二：通过对话添加
直接在对话中描述，AI 会调用 add_server 工具完成添加：
对话示例
你：帮我添加一台服务器，地址是 192.168.1.100，用户名 ubuntu，使用我的默认私钥
AI：我来帮你添加这台服务器。[调用 add_server]
服务器 "ubuntu@192.168.1.100" 已添加，别名为 "server-1"。SSH 密钥认证（推荐）
建议使用 SSH 密钥而非密码认证，更安全也更便捷：
bash
# 生成 SSH 密钥对（如果还没有）
ssh-keygen -t ed25519 -C "neowebai"
# 将公钥复制到服务器
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@serverSSH 工具详解
ssh_exec — 执行命令
在远程服务器上执行任意 Shell 命令：
对话示例
你：查一下 prod-server 上 nginx 的状态
AI：[调用 ssh_exec，命令: systemctl status nginx]
nginx 服务运行正常，已运行 3 天 2 小时...ssh_read — 读取远程文件
对话示例
你：帮我看看 /etc/nginx/nginx.conf 的内容
AI：[调用 ssh_read，path: /etc/nginx/nginx.conf]
[显示配置文件内容并分析]ssh_write — 写入远程文件
对话示例
你：在 /etc/nginx/conf.d/ 新建一个 myapp.conf，内容是 [...]
AI：[调用 ssh_write，写入配置文件]
已在远程服务器创建 /etc/nginx/conf.d/myapp.confssh_upload / ssh_download — 文件传输
对话示例
# 上传
你：把本地的 dist/ 目录上传到服务器的 /var/www/html/
# 下载
你：帮我下载服务器上 /var/log/app.log 到本地ssh_deploy — 一键部署
最强大的 SSH 工具，串联构建、传输、重启全流程：
对话示例
你：帮我把当前项目部署到 prod-server
AI：好的，我来执行部署流程：
1. [构建项目：npm run build]
2. [上传文件：ssh_upload dist/ → /var/www/app/]
3. [重启服务：ssh_exec systemctl restart app]
4. [健康检查：http_get http://prod-server/health]
部署完成！应用运行正常。find_bug — 远程排障
专为故障排查设计，AI 会自动收集日志、检查进程、分析异常：
对话示例
你：prod-server 上的 app 刚才崩溃了，帮我查一下原因
AI：我来分析一下。[调用 find_bug]
正在检查：
- 应用日志 /var/log/app/error.log
- 系统日志 journalctl
- 内存和 CPU 使用情况
...
发现问题：内存溢出（OOM Kill），建议增加 --max-old-space-size 参数...安全注意事项
- SSH 凭据加密存储在本地，不会上传到云端
- 建议为 NeoWeb AI 创建专用的低权限用户，避免使用 root
- 可以在服务器设置中限制允许执行的命令范围
- 所有 SSH 操作都有详细日志记录，可在 日志 面板查看
🔒 NeoWeb AI 的所有数据 100% 存储在本地，你的 SSH 密钥和服务器信息不会离开你的设备。
多服务器管理
你可以添加多台服务器，在对话中通过名称引用：
对话示例
你：在 dev-server 上跑一下测试，通过后再部署到 prod-server
AI：好的，先在 dev-server 执行测试...
[ssh_exec dev-server: npm test] — 全部通过
现在开始部署到 prod-server...
[ssh_deploy → prod-server] — 部署成功