VLLM auto DL环境配置

1 安装 UV 工具

你现在是 AutoDL 容器(root 用户、base conda 环境),报错 bash: uv: command not found 就是:还没装 uv,或者装了但不在 PATH 里。下面直接给你在这个容器里能一步到位的安装命令

powershell 复制代码
pip install uv # 在 AutoDL 里最快安装(用 pip,最简单)

uv --version # 装完后看一下

1 创建 UV 环境

VLLM 官网安装教程

推荐使用uv这款高性能 Python 环境管理工具来创建和管理 Python 运行环境。请参照官方文档完成 uv 的安装。安装完成后,可通过以下命令新建 Python 环境:

补充说明

uv:当下热门的 Python 环境 / 包管理工具,速度远优于传统的 venv、pip、conda,一般直接保留原名uv即可。

environment:结合语境译为运行环境 / 虚拟环境(Python 领域通用叫法)。

powershell 复制代码
uv venv --python 3.12 --seed --managed-python
source .venv/bin/activate

1:创建一个 Python 3.12 虚拟环境

每个参数含义:

uv venv:用 uv 创建虚拟环境

--python 3.12:指定使用 Python 3.12 版本

--seed:自动在环境里预装 pip(方便兼容老工具)

--managed-python:让 uv 自动下载、管理 Python 解释器(不用你自己装 Python)

2: 激活刚才创建的虚拟环境(进入这个独立环境)

激活后效果:

你用的 python、pip 都来自 .venv

安装的包只会存在这个环境里,不会污染系统

终端前面会出现 (.venv) 标志

2 在虚拟环境里面安装VLLM

建议使用 uv,通过 --torch-backend=auto 参数(或环境变量 UV_TORCH_BACKEND=auto),让工具在运行时检测已安装的 CUDA 驱动版本,自动匹配对应的 PyTorch 镜像源。

powershell 复制代码
uv pip install vllm --torch-backend=auto

如果是在国内:建议使用阿里镜像

powershell 复制代码
uv pip install vllm --torch-backend=auto \
  -i https://mirrors.aliyun.com/pypi/simple/ \
  --trusted-host mirrors.aliyun.com

-i:指定阿里云 PyPI 源

--trusted-host:信任阿里云域名,避免 SSL 报错

3 模型下载 (ModelScope )

AutoDL 国内环境通常 HuggingFace 不通,ModelScope 更稳。先装工具:

powershell 复制代码
source /root/.venv/bin/activate
uv pip install modelscope

下载到数据盘,避免系统盘爆:

powershell 复制代码
mkdir -p /root/autodl-tmp/models

modelscope download \
  --model Qwen/Qwen3-0.6B \
  --local_dir /root/autodl-tmp/models/Qwen3-0.6B

4 启动VLLM

powershell 复制代码
vllm serve /root/autodl-tmp/models/Qwen3-0.6B \
  --served-model-name Qwen/Qwen3-0.6B \
  --host 127.0.0.1 \
  --port 8000 \
  --max-model-len 2048

MODEL=Qwen/Qwen3-0.6B定义要跑的模型(轻量小模型,你的显卡轻松跑)

vllm serve $MODEL启动 vLLM API 服务(兼容 OpenAI 接口格式)

--host 127.0.0.1只允许本机访问(安全)

--port 8000服务端口 8000

--max-model-len 2048最大上下文长度 2048(对 0.6B 模型非常合适)

5 另起terminal 测试

返回模型列表之后

powershell 复制代码
curl http://127.0.0.1:8000/v1/models

curl一个命令行工具,用来发送网络请求、获取服务器返回的数据。

http://127.0.0.1:8000

127.0.0.1 = 本机

8000 = 服务运行的端口

→ 意思是:访问你自己电脑上运行的 AI 服务

/v1/models这是 OpenAI 兼容的 API 接口作用:列出当前可用的 AI 模型(比如 llama3、qwen、gemma 等)

powershell 复制代码
curl http://127.0.0.1:8000/v1/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen3-0.6B",
    "prompt": "Explain paged attention in one paragraph.",
    "max_tokens": 64,
    "temperature": 0
  }'

vLLM 服务完全正常运行,API 也能调用,但是模型生成的内容乱七八糟,全是重复的 - Quora,这是典型的小模型(0.6B)+ 英文提示词 + 温度 = 0 导致的生成崩坏。

问题原因

模型太小:Qwen3-0.6B 是超小参数量模型,英文能力很弱,很容易输出乱码 / 重复内容

温度 = 0:完全确定性生成,错了就一路错到底

用了 completions 接口:这个接口是续写模式,小模型更容易跑偏

方法 1:用中文对话接口(推荐,效果最好)

powershell 复制代码
curl http://127.0.0.1:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen3-0.6B",
    "messages": [{"role": "user", "content": "请解释一下分页注意力"}]
  }'
相关推荐
DevOps老兵15 小时前
AI Infra实战05:用Helm在K8s中部署vLLM,从安装到压测全流程
人工智能·kubernetes·helm·vllm·大模型推理·ai infra
方方洛2 天前
vllm教程-02-核心原理
人工智能·算法·vllm
苏子寒3 天前
Nano-VLLM全代码解析笔记(10)-GemmaRMSNorm和MRoPE
笔记·机器学习·ai·nlp·vllm
缘友一世5 天前
GLM-5.3-NVFP4 部署实战系列[八]启动加速:编译缓存挂载与 CUDA 图捕获裁剪,首启 8 分钟 → 3 分钟
vllm·glm5.3 nvfp4·sm80
方方洛5 天前
vllm教程-00-前言与导读
人工智能·算法·vllm
缘友一世5 天前
GLM-5.3-NVFP4 部署实战系列[二]Docker 镜像选择与补丁镜像构建:纯 Python overlay,不重编一行 CUDA
python·docker·容器·vllm
缘友一世5 天前
GLM-5.3-NVFP4 部署实战系列[七]正确的部署脚本与一键部署:deploy.sh参数拆解
vllm·glm5.3 nvfp4·sm80
JAI科研5 天前
Deepseek Agent Harness教程(七) | Deepseek Harness不是一个内核加一堆插件
开发语言·人工智能·深度学习·算法·自然语言处理·transformer·vllm
缘友一世5 天前
GLM-5.3-NVFP4 部署实战系列[四]问题深拆①:sm80 没有稀疏 MLA 注意力后端怎么办
vllm·glm5.3 nvfp4·sm80