Docker容器化是解决大模型本地运行中环境冲突、CUDA不匹配及迁移困难的核心方案，包含Ollama一键部署、自定义镜像构建、docker-compose多服务编排、离线镜像迁移及GPU细粒度分配五种路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地机器上运行大模型，但面临环境依赖冲突、CUDA版本不匹配或跨设备迁移困难等问题，则很可能是由于运行环境未隔离导致。以下是实现Docker容器化一键迁移的多种可行路径：
一、基于官方Ollama镜像直接运行
该方法利用Ollama官方维护的Docker镜像，无需构建过程，适用于快速验证和轻量级部署场景。镜像已预装模型拉取工具、基础推理服务及GPU支持层，开箱即用。
1、确保宿主机已安装NVIDIA Container Toolkit并配置完毕，执行nvidia-smi可正常显示GPU信息。
2、拉取最新Ollama官方镜像：docker pull ollama/ollama:latest。
3、启动容器并挂载模型存储目录：docker run -d -v ollama:/root/.ollama -p 11434:11434 --gpus all --name ollama ollama/ollama。
4、通过curl http://localhost:11434/api/tags确认服务已就绪，随后可用docker exec -it ollama ollama run llama3加载模型。
二、自定义Dockerfile构建专用镜像
该方法适用于需集成特定模型权重、定制API接口或绑定私有依赖（如vLLM、llama.cpp后端）的生产级部署。通过Dockerfile显式声明所有运行时组件，保障环境完全可控与可复现。
1、创建Dockerfile文件，内容以FROM nvidia/cuda:12.1.1-devel-ubuntu22.04为基底镜像。
2、添加系统级依赖安装指令：RUN apt-get update && apt-get install -y python3-pip python3-dev && rm -rf /var/lib/apt/lists/*。
3、复制本地模型文件夹至镜像内指定路径，例如：COPY ./models/phi-3-mini-128k-instruct /app/models/。
4、安装Python依赖并设置启动命令：RUN pip install --no-cache-dir vllm==0.4.3 fastapi uvicorn && CMD ["uvicorn", "server:app", "--host", "0.0.0.0:8000"]。
5、执行构建：docker build -t my-phi3-server .，随后运行：docker run --gpus all -p 8000:8000 my-phi3-server。
三、使用docker-compose统一编排服务栈
该方法适合需要同时运行模型服务、前端WebUI（如Chatbox、Ollama WebUI）、向量数据库（如Chroma）等多组件的完整AI应用系统。docker-compose.yml将各服务依赖关系与网络配置集中管理，提升可维护性。
1、新建docker-compose.yml文件，定义ollama、webui、chroma三个服务块。
2、在ollama服务中指定镜像、GPU访问权限、端口映射及卷挂载：volumes: ["ollama_data:/root/.ollama"]。
3、在webui服务中设置depends_on: [ollama]并配置环境变量OLLAMA_BASE_URL: http://ollama:11434。
4、执行docker-compose up -d启动全部服务，等待约30秒后访问http://localhost:3000即可进入交互界面。
5、如需更新模型，仅需进入ollama容器执行ollama pull qwen2:7b，其余服务自动识别新模型。
四、镜像导出与离线迁移部署
该方法专为无外网连接的生产服务器或安全隔离网络设计，通过保存镜像为tar包实现零依赖迁移。整个过程不涉及远程拉取，所有组件均来自本地可信源。
1、在开发机完成镜像构建后，执行docker save my-phi3-server > phi3-server-v1.2.tar生成离线包。
2、将phi3-server-v1.2.tar文件拷贝至目标服务器（可通过U盘、内网SCP等方式传输）。
3、在目标服务器执行docker load 还原镜像，验证输出中包含<code>Loaded image: my-phi3-server。
4、检查NVIDIA驱动版本是否满足要求：nvidia-driver-version >= 535.54.03，若不满足则需提前升级驱动。
5、运行容器时显式指定GPU设备编号：docker run --gpus device=0,1 -p 8000:8000 my-phi3-server，确保双卡负载均衡。
五、GPU资源细粒度分配与监控
该方法用于多模型共存场景，防止单一容器独占全部GPU显存，造成其他服务OOM。通过nvidia-container-toolkit的device list机制实现显存与计算单元的硬性隔离。
1、编辑/etc/nvidia-container-runtime/config.toml，启用no-cgroups = false并配置ldcache = "/usr/bin/nvidia-ldconfig.real"。
2、在容器启动命令中加入内存限制参数：--gpus '"device=0,capabilities=compute,utility"' --memory=12g --memory-reservation=8g。
3、部署Prometheus+Node Exporter+DCGM Exporter组合，采集dcgm_gpu_utilization、dcgm_fb_used_bytes等指标。
4、设置告警规则：当单卡显存占用持续超过<strong><font color="green">92%</font></strong>达2分钟时触发通知。
5、验证资源隔离效果：启动两个容器分别绑定GPU 0与GPU 1，执行nvidia-smi -L应仅显示对应编号设备。
