Docker 部署

本文档介绍如何使用 Docker 部署 OpenHuman。

前置要求

• Docker 18.06+
• Docker Compose（可选）

构建镜像

docker build -t openhuman:latest .

运行容器

docker run -d \
  --name openhuman \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -e OPENHUMAN_API_KEY=sk_xxx \
  openhuman:latest

使用 Docker Compose

version: '3.8'

services:
  openhuman:
    image: openhuman:latest
    container_name: openhuman
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./memory_tree:/app/memory_tree
    environment:
      - OPENHUMAN_API_KEY=${OPENHUMAN_API_KEY}
      - OPENHUMAN_BASE_URL=https://api.tinyhumans.ai
    restart: unless-stopped

启动：

docker-compose up -d

数据持久化

路径	说明
/app/data	应用数据
/app/memory_tree	SQLite 数据库
/app/wiki	Obsidian Markdown

环境变量

OPENHUMAN_API_KEY=sk_xxx
OPENHUMAN_BASE_URL=https://api.tinyhumans.ai
LOG_LEVEL=info

健康检查

docker inspect --format='{{.State.Health.Status}}' openhuman

常见问题

端口冲突

# 修改映射端口
docker run -d -p 3001:3000 openhuman:latest

权限问题

# Linux 下可能需要指定用户
docker run -d \
  --user $(id -u):$(id -g) \
  -v $(pwd)/data:/app/data \
  openhuman:latest

下一步

• Cloudflare Pages 部署 - 静态站点部署
• Vercel 部署 - Vercel 部署