zhangyq/openviking repository overview

# 编辑 docker-compose.yml
vim docker-compose.yml

# API Server (1933) with integrated MCP endpoint (/mcp)
services:
  openviking:
    image: zhangyq/openviking:main
    container_name: openviking
    ports:
      - "1933:1933"
    volumes:
      # 配置文件挂载（包含 embedding 和 vlm 配置）
      - ./ov.conf:/app/ov.conf
      # 数据目录挂载（持久化存储）
      - ./data:/app/data
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:1933/health || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 60s
    restart: unless-stopped
    environment:
      # OpenViking 配置文件路径
      - OPENVIKING_CONFIG_FILE=/app/ov.conf
      # API Server 配置
      - API_HOST=0.0.0.0
      - API_PORT=1933

networks:
  default:
    name: openviking-net
    driver: bridge

# 编辑 ov.conf，填入你的 API 密钥
vim ov.conf

{
  "server": {
    "host": "0.0.0.0",
    "port": 1933,
    "root_api_key": "change-me-to-a-secure-random-key"
  },
  "storage": {
    "workspace": "/app/data"
  },
  "embedding": {
    "dense": {
      "api_base": "https://api.siliconflow.cn/v1",
      "api_key": "your-api-key-here",
      "provider": "openai",
      "dimension": 1024,
      "model": "Qwen/Qwen3-Embedding-8B"
    }
  },
  "vlm": {
    "api_base": "https://api.siliconflow.cn/v1",
    "api_key": "your-api-key-here",
    "provider": "openai",
    "model": "Pro/Qwen/Qwen2.5-7B-Instruct"
  }
}

# 创建空白数据目录（用于持久化存储）
mkdir -p data

# 启动容器
docker compose up -d

# 查看日志
docker compose logs -f

# 检查健康状态
curl http://localhost:1933/health

claude --dangerously-skip-permissions --mcp-config '{
  "mcpServers": {
    "openviking": {
      "type": "http",
      "url": "http://10.10.10.10:1933/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}'

openviking-server/
├── docker-compose.yml      # Docker Compose 配置
├── ov.conf                 # 配置文件（需自行创建）
└── data/                   # 数据目录（持久化存储）

# 启动服务
docker compose up -d

# 停止服务
docker compose down

# 重启服务
docker compose restart

# 查看日志
docker compose logs -f openviking

# 进入容器
docker exec -it openviking bash

# 更新镜像
docker compose pull
docker compose up -d