小米智能家居 Miloco 分离式部署指南

一、安装环境

• Windows 用户：安装 WSL2 以及 Docker
• macOS/Linux 用户：安装 Docker 具体步骤可参考官方文档。Windows 用户需将 WSL2 的网络模式设置为 Mirrored。

二、使用 Docker 部署 Miloco 后端

以下均为 bash 命令。请 Windows 用户进入 WSL2 / Linux、macOS 用户进入终端操作：

mkdir miloco
cd miloco
vi docker-compose.yml

以下是 compose 的内容：

services:
  backend:
    container_name: miloco-backend
    image: ghcr.nju.edu.cn/xiaomi/miloco-backend:latest
    network_mode: host
    expose:
      - ${BACKEND_PORT:-8000}
    environment:
      - BACKEND_HOST=${BACKEND_HOST:-0.0.0.0}
      - BACKEND_PORT=${BACKEND_PORT:-8000}
      - AI_ENGINE_HOST=${AI_ENGINE_HOST:-0.0.0.0}
      - AI_ENGINE_PORT=${AI_ENGINE_PORT:-8001}
      - BACKEND_LOG_LEVEL=${BACKEND_LOG_LEVEL:-info}
      - TZ=${TZ:-Asia/Shanghai}
    volumes:
      - ./data:/app/miloco_server/.temp
      - ./log/backend:/app/miloco_server/.temp/log
    restart: unless-stopped
    healthcheck:
      disable: true

再创建 .env 文件：

vi .env