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

一、安装环境

• Windows 用户：安装 WSL2 以及 Docker，需将 WSL2 的网络模式设置为 Mirrored。
• macOS/Linux 用户：安装 Docker。

二、使用 Docker 部署 Miloco 后端

以下命令请在 WSL2 / Linux 终端或 macOS 终端中执行：

mkdir miloco
cd miloco
vim docker-compose.yml

编辑 docker-compose.yml 文件，内容如下：

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 配置文件：

vim .env