小米智能家居 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

以下是 docker-compose.yml 的内容（若不会使用 vi，可使用文本编辑器创建文件）：

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