CodeGeeX Dockerfile生成有五种方法：一、用CLI自动推导；二、Ollama多阶段封装；三、CUDA-aware GPU加速；四、Alpine轻量CPU方案；五、安全加固非root运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望为 CodeGeeX 项目自动生成符合生产规范的 Dockerfile，但缺乏手动编写经验或需适配不同运行环境，则可能是由于未明确构建阶段划分、基础镜像选型或资源约束策略。以下是生成 CodeGeeX Dockerfile 的具体方法：
一、使用 CodeGeeX CLI 工具链自动推导
CodeGeeX 提供了内置的容器化配置生成器，可基于项目目录结构与依赖文件（如 requirements.txt、pyproject.toml）自动识别运行时栈并输出标准化 Dockerfile。
1、确保本地已安装 CodeGeeX CLI 并完成模型加载：ollama run codellama:7b-python
2、进入 CodeGeeX 项目根目录，执行命令：codex docker init --framework=pytorch --quant=awq
3、工具将自动检测 CUDA 版本、Python 版本及关键依赖，并在当前目录生成 Dockerfile.auto 与 docker-compose.yml 配套文件。
二、基于 Ollama 模型服务封装的多阶段 Dockerfile
该方法适用于将 CodeGeeX 作为 Ollama 自定义模型部署，通过分阶段构建减少镜像体积并隔离构建与运行时环境。
1、创建名为 Dockerfile.ollama 的文件，内容以 FROM ollama/ollama:latest 为基础镜像。
2、在构建阶段添加模型文件复制指令：COPY ./models/CodeGeeX4.Q4_K_M.gguf /root/.ollama/models/
3、覆盖默认启动命令，指定模型加载参数：CMD ["ollama", "run", "codex-geex4"]
4、构建镜像时启用 BuildKit 以支持高级语法：DOCKER_BUILDKIT=1 docker build -f Dockerfile.ollama -t codegeex4-ollama .
三、适配 GPU 加速的 CUDA-aware Dockerfile
当目标主机配备 NVIDIA GPU 且需启用 CUDA 推理加速时，必须使用 nvidia/cuda 基础镜像并显式声明设备支持。
1、选择与宿主机驱动兼容的 CUDA 运行时版本，例如：FROM nvidia/cuda:12.1.1-runtime-ubuntu22.04
2、安装 Python 及 PyTorch CUDA 版本：RUN pip3 install torch==2.3.0+cu121 torchvision==0.18.0+cu121 --extra-index-url https://download.pytorch.org/whl/cu121
3、复制 CodeGeeX 源码并设置工作目录：COPY . /app && WORKDIR /app
4、声明 GPU 设备挂载要求：ENV NVIDIA_VISIBLE_DEVICES=all
5、启动容器时需使用 --gpus all 参数，否则 CUDA 初始化将失败。
四、轻量级 CPU-only 容器化方案（Alpine 基础）
适用于边缘设备或 CI/CD 构建节点等资源受限场景，通过 Alpine Linux 和 musl libc 实现最小化镜像体积。
1、采用 FROM python:3.10-alpine3.19 作为基础镜像，避免 glibc 依赖膨胀。
2、安装编译依赖前先清理包缓存：RUN apk add --no-cache gcc musl-dev linux-headers
3、禁用 wheel 缓存并强制源码安装关键包：RUN PIP_NO_CACHE_DIR=off pip install --no-binary :all: cpm_kernels
4、构建完成后执行镜像瘦身：RUN apk del gcc musl-dev linux-headers && rm -rf /var/cache/apk/*
五、安全加固型 Dockerfile（非 root 用户 + 最小权限）
遵循最小权限原则，禁止以 root 身份运行容器进程，同时限制文件系统访问范围与能力集。
1、在镜像末尾添加非特权用户声明：RUN addgroup -g 1001 -f codegeex && adduser -S codegeex -u 1001
2、切换用户并限定工作目录所有权：USER codegeex:codegeex && chown -R codegeex:codegeex /app
3、移除危险系统调用能力：STOPSIGNAL SIGTERM && HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD curl -f http://localhost:8080/health || exit 1
4、运行容器时显式丢弃默认能力：docker run --cap-drop=ALL --read-only --tmpfs /run --tmpfs /tmp -it codegeex4-secure
