可采用三种方式启动Minimax Demo：一、拉取并运行官方镜像（docker pull/run）；二、克隆源码构建本地镜像并注入API参数；三、用Docker Compose编排多服务，确保依赖与网络正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Docker 并希望在本地快速启动 Minimax 提供的 Demo 示例，但遇到容器无法构建、服务无法访问或 API 调用失败等问题，则可能是由于环境配置、镜像拉取失败或端口映射不当所致。以下是实现该目标的可行路径：
一、使用官方预编译镜像直接运行
Minimax 官方可能提供已打包的 Docker 镜像（如 minimax/demo:latest），可跳过源码构建环节，显著缩短启动时间。该方式适用于仅需验证基础功能且不修改后端逻辑的场景。
1、打开终端，执行命令拉取镜像：docker pull minimax/demo:latest。
2、运行容器并映射端口：docker run -d -p 8080:8080 --name minimax-demo minimax/demo:latest。
3、等待约 10 秒后，在浏览器中访问 http://localhost:8080 查看 Demo 页面。
二、基于源码构建并运行本地镜像
当需要调试前端交互逻辑、替换模型参数或启用自定义 API 密钥时，应从 Minimax 公开的 GitHub 仓库克隆源码并构建镜像。此方法确保运行环境与开发分支完全一致。
1、执行命令克隆仓库：git clone https://github.com/minimax-inc/demo-web.git。
2、进入项目目录：cd demo-web。
3、确认根目录下存在 Dockerfile 文件，且内容包含 FROM node:18-alpine 及 CMD ["npm", "start"] 等关键指令。
使用 MiniMax Coding Plan API 进行网络搜索和图片理解。使用场景：(1) 用户需要搜索实时信息或新闻，(2) 需要分析图片内容，(3) 做研究或查找资料。无需 API key：用户需自行配置。
4、构建镜像：docker build -t minimax-local-demo .。
5、运行容器并注入环境变量：docker run -d -p 3000:3000 -e API_BASE_URL=https://api.minimax.chat/v1 -e GROUP_ID=your_group_id -e API_KEY=your_api_key --name demo-run minimax-local-demo。
三、通过 Docker Compose 编排多服务依赖
若 Demo 依赖独立的后端代理服务（如 Nginx 转发或本地 mock server），使用 docker-compose.yml 可统一管理容器网络、卷挂载和启动顺序，避免手动配置端口冲突。
1、在项目根目录创建 docker-compose.yml，内容包含 services: 下的 web 和 proxy 两个服务定义。
2、确保 web 服务的 depends_on 字段声明对 proxy 的依赖关系。
3、执行命令启动全部服务：docker-compose up -d。
4、检查容器状态：docker-compose ps，确认所有状态为 Up。
5、通过 docker-compose logs -f web 实时查看前端服务输出，确认无 Failed to fetch 或 Connection refused 错误。
