OpenHuman Docker 一键部署教程（含 docker-compose.yml）

OpenHuman 目前没有官方 Docker 镜像，但你可以通过 Docker 快速在服务器上部署开发环境。这种方法适合需要在 Linux 服务器上远程使用 OpenHuman、或者想隔离环境的用户。

部署方式对比

Docker 部署 适合开发者和技术爱好者尝鲜。相比于桌面版双击安装，Docker 方式需要一定的命令行基础。如果你只是想快速体验 OpenHuman，建议先试试桌面版安装。

前提条件

• 已安装 Docker（20.10+）和 docker-compose（2.x+）
• 服务器至少 2GB 内存（推荐 4GB+ 如果同时运行本地模型）
• Node.js 24（容器内会安装，但建议主机也有）

第一步：创建项目目录

mkdir openhuman-docker && cd openhuman-docker

第二步：创建 docker-compose.yml

在目录下创建 docker-compose.yml 文件：

version: "3.8"
services:
  openhuman:
    image: node:24-alpine
    container_name: openhuman
    ports:
      - "3000:3000"
    volumes:
      - ./openhuman-data:/app/data
      - ./config.toml:/app/config.toml
    working_dir: /app
    environment:
      - OPENHUMAN_DATA_DIR=/app/data
    command: >
      sh -c "
      apk add --no-cache git curl &&
      git clone https://github.com/tinyhumansai/openhuman.git . &&
      npm install -g pnpm@10.10.0 &&
      pnpm install &&
      pnpm dev
      "
    restart: unless-stopped

第三步：创建 config.toml

[memory]
backend = "sqlite"
sync_interval_minutes = 20
max_token_budget = 3000

[models]
fast = { provider = "openai_compatible", model = "gpt-4o-mini", base_url = "https://api.openai.com/v1", api_key = "YOUR_KEY" }
reasoning = { provider = "openai_compatible", model = "deepseek-reasoner", base_url = "https://api.deepseek.com", api_key = "YOUR_KEY" }

[voice]
stt_engine = "whisper"
tts_engine = "system"

[web]
search_enabled = true
scraper_enabled = true

第四步：启动服务

docker-compose up -d

首次启动会下载 Node.js 镜像并编译 OpenHuman，耗时约 5-10 分钟。

访问 OpenHuman

打开浏览器访问 http://localhost:3000。如果部署在远程服务器，请将 localhost 替换为服务器 IP。

配置本地模型（Ollama）

你可以在服务器上同时运行 Ollama 来使用本地模型。在 docker-compose.yml 中追加：

  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    ports:
      - "11434:11434"
    volumes:
      - ./ollama-data:/root/.ollama
    restart: unless-stopped

常见问题

端口冲突怎么办？

修改 docker-compose.yml 中 ports 字段的左侧端口，如 "3001:3000"。

数据在哪里？

所有数据保存在 ./openhuman-data 目录中，删除容器不会丢失数据。

如何更新？

docker-compose down docker-compose pull docker-compose up -d

总结

Docker 部署 OpenHuman 虽然不是官方方案，但能让你快速在服务器上体验。对大多数用户来说，桌面版安装更简单。Docker 方案适合想折腾技术、或者在无桌面环境的服务器上使用的用户。