首页/AI/大模型部署与运维速查/vllm serve 常用启动参数
部署形态与选型43 条

vllm serve 常用启动参数

vllm serve 的关键参数集中在显存、并行与量化三组:--tensor-parallel-size 多卡切分、--gpu-memory-utilization 显存预算、--max-model-len 上下文上限、--quantization 指定量化内核。

典型启动命令

典型启动命令
vllm serve <模型路径> --port 8000 --host 0.0.0.0 --tensor-parallel-size 2 --gpu-memory-utilization 0.9 --max-model-len 8192 --served-model-name my-model

常用参数

参数作用
--tensor-parallel-size张量并行卡数,单卡放不下权重时切分
--gpu-memory-utilization显存使用比例(含 KV 缓存预算)
--max-model-len单请求上下文长度上限,直接影响 KV 显存
--quantization量化内核,如 awq / gptq / fp8
--served-model-name对外暴露的模型名(客户端 model 字段)
--enforce-eager禁用 CUDA Graph,便于调试、损失部分性能
调整 --gpu-memory-utilization 过高会挤压 KV 缓存空间,长上下文并发时反而更早 OOM;预留一成左右余量更稳。

易错点

  • --max-model-len 设得比业务需要大很多时,KV 缓存按上限预留会白白吃掉显存
  • 多卡时每张卡都要能放下分片后的权重与 KV,卡型不一致会以短板卡为准

数据来源与参考

  • vLLM 官方文档:Engine Arguments(docs.vllm.ai)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌