Nuwax

Appearance

智能体电脑部署指南 ​

可以在多个不同的服务器部署智能体电脑服务，通过配置实现分布式智能体沙箱能力。

环境要求：每台服务器需要安装 Docker 和 Docker Compose 环境，参考 Docker环境安装

一、快速部署 ​

1. 创建工作目录并下载 ​

bash
# 创建工作目录
mkdir nuwax_computer_deploy
cd nuwax_computer_deploy

# 下载安装文件
wget https://nuwa-packages.oss-rg-china-mainland.aliyuncs.com/docker/20260112234101/docker-computer.zip

# 解压文件,如果没安装,可以根据自己系统,执行: yum install unzip / dnf install unzip / apt install unzip
unzip docker-computer.zip

2. 启动服务 ​

bash
# 进入解压目录
cd docker-computer

# 后台启动服务
docker compose up -d

3. 验证服务 ​

bash
# 查看容器状态
docker compose ps

# 查看服务日志（可选）
docker compose logs -f

服务启动后，会占用以下端口：

  • 9086：主程序服务地址
  • 9088：远程桌面服务地址
  • 60001：文件上传服务地址

确保防火墙已开放上述端口。

二、沙箱服务配置 ​

配置路径：系统管理 → 系统配置 → 站点智能体设置（最右侧标签页）→ 智能体沙箱配置

说明：可以配置多台沙箱服务器，实现负载分担。端口固定，只需配置实际服务器的 IP 地址。

配置示例 ​

json
{
  "sandboxServers": [
    {
      "serverId": "1",
      "serverName": "测试环境沙箱1",
      "serverAgentUrl": "http://192.168.1.100:9086",
      "serverVncUrl": "http://192.168.1.100:9088",
      "serverFileUrl": "http://192.168.1.100:60001",
      "serverApiKey": "",
      "maxUsers": 20
    },
    {
      "serverId": "2",
      "serverName": "测试环境沙箱2",
      "serverAgentUrl": "http://192.168.1.101:9086",
      "serverVncUrl": "http://192.168.1.101:9088",
      "serverFileUrl": "http://192.168.1.101:60001",
      "serverApiKey": "your_api_key",
      "maxUsers": 30
    }
  ],
  "perUserMemoryGB": 4.0,
  "perUserCpuCores": 2
}

参数说明 ​

参数说明注意事项
serverId服务器唯一标识配置后不要变更，否则会导致用户数据映射混乱
serverName服务器描述名称便于识别和管理
serverAgentUrl主程序服务地址格式：http://IP:9086
serverVncUrl远程桌面服务地址格式：http://IP:9088
serverFileUrl文件上传服务地址格式：http://IP:60001
serverApiKeyAPI鉴权密钥默认未开启，详见下方鉴权配置说明
maxUsers最大用户数根据服务器配置设置，默认每用户4G内存/2核CPU
perUserMemoryGB每用户内存配额默认4.0GB
perUserCpuCores每用户CPU核心默认2核

API鉴权配置（可选） ​

如果服务器未进行网络隔离，建议开启 Header 鉴权。

配置文件位置：docker-computer/config/rcoder/config.yml

yaml
api_key_auth:
  enabled: true      # 开启鉴权
  api_key: "your_secure_api_key_here"  # 自定义密钥

配置完成后，将密钥填入上述 serverApiKey 字段。

三、服务管理 ​

常用命令 ​

bash
# 查看服务状态
docker compose ps

# 查看服务日志
docker compose logs -f [service_name]

# 停止服务
docker compose down

# 启动服务
docker compose up -d

# 重启服务
docker compose restart

查看单个服务日志 ​

bash
# 查看主程序日志
docker compose logs -f rcoder

# 查看远程桌面日志
docker compose logs -f novnc

四、升级更新 ​

方式一：全量重新部署（推荐） ​

适合大版本升级或遇到问题时使用。

bash
# 1. 停止服务
docker compose down

# 2. 备份配置文件（重要！）
cp -r docker-computer/config docker-computer/config.backup

# 3. 下载最新部署文件并解压
wget https://nuwa-packages.oss-rg-china-mainland.aliyuncs.com/docker/20260106054846/docker-computer.tar.gz
tar -xzf docker-computer.tar.gz

# 4. 恢复配置文件（如需保留原配置）
cp -r config.backup/* docker-computer/config/

# 5. 启动服务
cd docker-computer
docker compose up -d

重要提示：升级时务必保留 docker-computer/computer-project-workspace 目录，该目录存储用户数据。

方式二：镜像更新 ​

适合小版本更新。

bash
# 进入部署目录
cd docker-computer

# 拉取最新镜像
docker compose pull

# 重启服务
docker compose up -d

五、故障排查 ​

1. 容器启动失败 ​

bash
# 查看容器状态
docker compose ps

# 查看详细日志
docker compose logs

# 检查端口占用
netstat -tlnp | grep -E '9086|9088|60001'

2. 无法访问服务 ​

  • 检查防火墙设置，确保端口已开放
  • 确认服务器 IP 地址配置正确
  • 验证 Docker 服务是否正常运行

3. 数据丢失 ​

检查 computer-project-workspace 目录是否完整，升级前务必备份此目录。

4. 性能问题 ​

根据服务器实际配置调整 maxUsers、perUserMemoryGB 和 perUserCpuCores 参数。

更多性能优化，虚拟电脑并发上不去或会话超时卡死问题参考解决方案