Docker 容器化部署

使用 Docker 是生产环境、NAS 设备与私有云服务器上运行 OneASR 的最佳推荐方式。

---

1. 使用 docker run 快速启动

NVIDIA GPU 硬件加速模式

确保宿主机已安装 NVIDIA Container Toolkit：

docker run -d \
  --name oneasr-gateway \
  --gpus all \
  -p 8000:8000 \
  -v $(pwd)/models:/app/models \
  -v $(pwd)/config.yaml:/app/config.yaml \
  --restart unless-stopped \
  codeandxv/oneasr:latest

CPU 模式（无需独立显卡）

docker run -d \
  --name oneasr-gateway \
  -p 8000:8000 \
  -v $(pwd)/models:/app/models \
  -v $(pwd)/config.yaml:/app/config.yaml \
  --restart unless-stopped \
  codeandxv/oneasr:latest

---

2. 使用 Docker Compose（推荐）

在项目工作目录中创建 docker-compose.yml 文件：

version: '3.8'

services:
  oneasr:
    image: codeandxv/oneasr:latest
    container_name: oneasr-gateway
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      - ONEASR_API_KEY=sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u
      - WORKERS=2
    volumes:
      - ./models:/app/models
      - ./config.yaml:/app/config.yaml
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

启动容器服务：

docker compose up -d

查看运行日志：

docker compose logs -f oneasr

---

3. 访问 Web 控制台与 API 文档

服务启动成功后，可在浏览器中直接访问：

• 可视化 Web 仪表盘：http://localhost:8000
• Swagger 交互式 API 文档：http://localhost:8000/docs
• 健康检查接口：http://localhost:8000/api/v1/health