首页/AI/大模型部署与运维速查/vLLM 官方 Docker 镜像部署
部署形态与选型43 条

vLLM 官方 Docker 镜像部署

用官方镜像 vllm/vllm-openai 部署可以免去 CUDA 环境配置:挂载模型缓存目录、透传 GPU、共享 IPC,即可启动 OpenAI 兼容服务。

docker run 部署示例

docker run 部署示例
docker run --runtime nvidia --gpus all --ipc=host -p 8000:8000 -v ~/.cache/huggingface:/root/.cache/huggingface vllm/vllm-openai:latest --model <模型名或本地路径> --max-model-len 8192
镜像vllm/vllm-openai(官方)
端口容器内 8000
要点--ipc=host 共享内存、挂载 HF 缓存避免重复下载
镜像 tag 建议固定到具体版本,latest 会在重建时静默升级引擎行为。

易错点

  • 没装 nvidia-container-toolkit 时 --gpus all 直接报错,先在宿主机用自己的自检命令验证 GPU 透传
  • 容器内下载模型会复制一份到卷里,先在宿主机下好再挂载更省时间

数据来源与参考

  • vLLM 官方文档:Deploying with Docker(docs.vllm.ai)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌