# nanobot-docker

**Repository Path**: computerhong/nanobot-docker

## Basic Information

- **Project Name**: nanobot-docker
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-16
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# nanobot-docker

NanoBot Docker 部署项目

## 项目结构

```
nanobot-docker/
├── docker/
│   ├── Dockerfile          # Docker 构建文件
│   ├── config.json        # 后端配置文件
│   └── frontend-config.json  # 前端 UI 配置文件
├── docker-compose.yml    # Docker Compose 配置
├── nanobot-web/       # 后端源码 (git submodule)
└── nanobot-web-ui/   # 前端源码 (git submodule)
```

## 构建与部署

### 前提条件

- Docker
- Docker Compose
- Git

### 克隆项目

```bash
git clone https://gitee.com/computerhong/nanobot-docker.git
cd nanobot-docker

# 初始化 submodules
git submodule update --init --recursive
```

### 构建镜像

```bash
docker-compose build
```

### 导出镜像文件（可选）

```bash
docker save -o nanobot-docker.tar nanobot-docker-nanobot:latest
```

导出的文件可用于其他机器离线部署。

### 运行服务

直接运行：
```bash
docker run -d -p 24312:24312 -p 3001:3001 -p 18793:18793 --name nanobot nanobot-docker-nanobot:latest
```

或使用 docker-compose：
```bash
docker-compose up -d
```

## 端口说明

| 端口 | 用途 |
|------|------|
| 24312 | WebSocket 端口 |
| 3001  | HTTP Web UI 端口 |
| 18793 | 备用 WebSocket 端口 |

## 访问

- Web UI：`http://<服务器IP>:3001`
- WebSocket：`ws://<服务器IP>:18793`

## 离线部署

### 在目标机器上

# 停止并删除旧容器（数据会丢，如果有持久化数据先备份）
docker stop nanobot
docker rm nanobot

# 删除旧镜像（可选，节省空间）
docker rmi nanobot-docker-nanobot:latest

1. 加载镜像：
```bash
docker load -i nanobot-docker.tar
```

2. 运行：
```bash
docker run -d -p 24312:24312 -p 3001:3001 -p 18793:18793 --name nanobot nanobot-docker-nanobot:latest
```

## 配置说明

### frontend-config.json

位置：`docker/frontend-config.json`

配置前端智能体分类和入口：
```json
{
  "knowledgeBase": {
    "url": "http://localhost:8502/sources"
  },
  "agents": {
    "single": [
      {
        "id": "home",
        "name": "家庭",
        "icon": "Home",
        "color": "orange",
        "agents": [
          { "id": "xxx", "name": "xxx", "targetUrl": "http://..." }
        ]
      }
    ]
  }
}
```

### 字段说明

- `targetUrl`：智能体跳转目标 URL
- `launchSteps`：启动步骤（数组）
- `noFrame`：是否在新标签页打开（true/false）

## 修改与更新

### 修改前端配置

直接编辑 `docker/frontend-config.json`，然后重新构建：

```bash
docker-compose build
docker save -o nanobot-docker.tar nanobot-docker-nanobot:latest
```

### 修改后端代码

1. 修改 `nanobot-web/` 下的代码
2. 提交并推送：
```bash
cd nanobot-web
git add .
git commit -m "fix: xxx"
git push
```

3. 更新并重新构建：
```bash
cd ..
git submodule update --recursive --remote
docker-compose build --no-cache
docker save -o nanobot-docker.tar nanobot-docker-nanobot:latest
```

### 修改前端代码

1. 修改 `nanobot-web-ui/` 下的代码
2. 构建：
```bash
cd nanobot-web-ui
npm run build
```

3. 重新构建 Docker：
```bash
cd ..
docker-compose build
docker save -o nanobot-docker.tar nanobot-docker-nanobot:latest
```

## 常用命令

```bash
# 查看日志
docker logs -f nanobot

# 停止服务
docker stop nanobot

# 删除服务
docker rm nanobot

# 查看运行状态
docker ps
```

## 注意事项

1. 每次修改配置或代码后需要重新 `docker-compose build`
2. 导出镜像文件时请确保足够的磁盘空间（约 400MB）
3. 如果 submodules 没有正确初始化，���运行：
   ```bash
   git submodule update --init --recursive
   ```

## 故障排除

### 页面 404

刷新页面，应该已经支持 SPA fallback。

### 配置不生效

可能是浏览器缓存，尝试：
- 按 `Ctrl + Shift + R` 强制刷新
- 或使用无痕模式

### 教育模块显示"待创建"

检查 `frontend-config.json` 中的 `targetUrl` 是否正确配置。

跨域问题：添加 `"noFrame": true` 让它在新标签页打开。

## 项目地址

- nanobot-docker：https://gitee.com/computerhong/nanobot-docker
- nanobot-web：https://gitee.com/computerhong/meta-claw
- nanobot-web-ui：https://gitee.com/computerhong/meta-claw-ui

● 源码方式启动                                                      
                                                                                        
  1. 安装依赖                                                                                                                                                                                     
                                                    
  # 后端依赖（如果没装过）                                                                                                                                                                        
  cd nanobot-web                                                                                                                                                                                  
  uv pip install -e .                                                                                                                                                                             
                                                                                                                                                                                                  
  # 前端依赖                                                                                                                                                                                      
  cd ../nanobot-web-ui
  npm install

  2. 启动后端

  cd nanobot-web

  # 启动 gateway（带 Web UI）
  python -m nanobot gateway --ui --ui-http --ui-http-port 3001

  3. 启动前端（可选）

  如果后端已经用 --ui-http 启动，前端已经包含。

  如果单独启动前端开发服务器：
  cd nanobot-web-ui
  npm run dev

  4. 访问

  - Web UI：http://localhost:3001
  - WebSocket：ws://localhost:18793

  ---
  常用命令

  # 查看帮助
  python -m nanobot --help

  # 只启动后端（不含 Web UI）
  python -m nanobot gateway

  # 只启动 WebSocket 服务
  python -m nanobot gateway --ui --ui-port 18793