xtreme1

环境要求

• 已安装 Docker 与 Docker Compose（使用 docker compose 命令）
• Git，用于拉取源码
• 如需 GPU 预标注：安装 NVIDIA Container Toolkit 并在 /etc/docker/daemon.json 中配置 nvidia 运行时
• ARM CPU（如 Apple M1）需额外添加 docker-compose.override.yml

安装与启动步骤

1. 1下载项目源码

   README 未给出 clone 命令，仓库地址取自项目 GitHub；后续安装需在含 docker-compose.yml 的根目录执行。

   git clone https://github.com/xtreme1-io/xtreme1.git
   cd xtreme1

   复制

2. 2配置 NVIDIA 运行时

   仅在需要 GPU 预标注时配置；将以下内容写入 daemon.json 并重启 Docker，才能启用 NVIDIA Container Toolkit。

   {
     "runtimes": {
       "nvidia": {
         "path": "nvidia-container-runtime",
         "runtimeArgs": []
       }
     },
     "default-runtime": "nvidia"
   }

   复制

3. 3启动全部服务

   默认从 Docker Hub 拉取前后端镜像并后台启动；去掉 -d 即前台运行，可直接查看日志。

   docker compose up -d

   复制

4. 4ARM 平台适配

   仅 ARM CPU（如 Apple M1）需要：新建 docker-compose.override.yml 写入以下内容，QEMU 模拟可能影响性能。

   services:
     mysql:
       platform: linux/amd64

   复制

5. 5启用 BuildKit

   源码构建前建议开启 BuildKit，以复用 Maven 与 NPM 包缓存；Docker Desktop 默认未开启。

   { "features": { "buildkit": true } }

   复制

6. 6源码构建并运行

   把 docker-compose.yml 复制为 docker-compose.develop.yml，注释 image 行、取消 build 行注释后再执行。

   docker compose -f docker-compose.develop.yml build
   docker compose -f docker-compose.develop.yml up

   复制

关键配置

如何确认成功

docker compose ps 显示各容器 running/healthy 即启动成功；README 未给出访问地址，详见官方文档。

常见问题

注意事项

• docker-compose.yml 默认从 Docker Hub 拉取 backend 与 frontend 应用镜像。
• 不要把开发改动提交到 docker-compose.yml，请使用 docker-compose.develop.yml 并通过 -f 指定。
• ARM 平台走 QEMU 模拟运行 amd64 镜像，性能会受到影响。
• README 只包含安装、构建与运行内容，功能与使用问题请查阅官方文档站点。