通义千问1.5-1.8B-Chat-GPTQ-Int4 WebUI部署详解：Windows系统下的Docker与网络配置

本文介绍了如何在星图GPU平台上自动化部署通义千问1.5-1.8B-Chat-GPTQ-Int4 WebUI镜像，快速搭建轻量级AI对话应用。用户通过简单的配置，即可在本地运行该模型，轻松应用于日常的文本理解、创意写作及代码辅助等场景，体验便捷的AI交互服务。

Kimgoeunlaogong

28人浏览 · 2026-03-29 06:18:10

Kimgoeunlaogong · 2026-03-29 06:18:10 发布

通义千问1.5-1.8B-Chat-GPTQ-Int4 WebUI部署详解：Windows系统下的Docker与网络配置

想在自己的Windows电脑上快速体验通义千问大模型，又不想折腾复杂的Python环境？Docker部署是目前最省心、最干净的方法。但很多朋友在Windows上跑Docker时，总会遇到网络不通、端口访问不了、文件共享失败这些烦人的问题。

这篇文章，我就以一个过来人的身份，手把手带你走一遍完整的部署流程。咱们不聊那些虚的，就聚焦在Windows系统下，如何把通义千问1.5-1.8B-Chat-GPTQ-Int4这个轻量又好用的模型，通过WebUI的形式跑起来。我会把每一步的操作、可能遇到的坑，以及怎么填坑，都给你讲得明明白白。

1. 准备工作：理清思路与检查清单

在开始动手之前，咱们先花两分钟，搞清楚我们要做什么，以及你的电脑需要满足什么条件。这能帮你避免做到一半才发现基础条件不满足的尴尬。

简单来说，我们的目标是在Windows电脑上，用一个叫Docker的“集装箱”技术，把已经打包好的通义千问WebUI应用跑起来。你不需要自己安装Python、PyTorch这些复杂的依赖，因为Docker镜像里全都准备好了。

你的电脑需要满足以下几点：

操作系统：Windows 10 版本 2004 及更高（内部版本 19041 及更高）或 Windows 11。这是使用WSL 2（Windows Subsystem for Linux 2）的前提。
虚拟化支持：你的电脑CPU需要支持并已在BIOS/UEFI中开启虚拟化技术（如Intel VT-x或AMD-V）。这个我们后面会检查。
磁盘空间：建议至少预留10GB的可用空间，用于安装Docker和拉取镜像。
网络环境：需要一个稳定的网络连接来下载Docker和镜像文件。

2. 搭建基石：安装与配置Docker Desktop

Docker Desktop是我们在Windows上使用Docker的官方工具。这一步是关键，配置好了后面就一帆风顺。

2.1 启用系统功能与安装Docker

首先，我们需要确保Windows的虚拟化和Linux子系统功能是打开的。

开启WSL和虚拟化平台：
- 在Windows搜索框输入“启用或关闭Windows功能”，打开它。
- 在弹窗中，找到并勾选“适用于Linux的Windows子系统”和“虚拟机平台”这两个选项。点击“确定”，系统会提示你重启电脑，先点“稍后重新启动”。
下载并安装Docker Desktop：
- 访问Docker官网，下载适用于Windows的Docker Desktop安装程序。
- 运行下载好的安装包，安装过程中基本一直点“Next”就行。安装完成后，它会要求你重启电脑，这次就选择重启。

2.2 首次启动与关键配置

电脑重启后，在开始菜单找到Docker Desktop并运行它。第一次启动可能会花点时间。

选择使用WSL 2后端：
- 启动后，Docker通常会提示你选择使用WSL 2还是传统的Hyper-V。强烈建议选择WSL 2，它在性能和资源集成上表现更好。如果没弹出提示，可以在Docker Desktop设置（Settings）的“General”里确认“Use the WSL 2 based engine”被勾选。
配置国内镜像加速器（重要！）：
- 由于网络原因，从Docker官方仓库拉取镜像可能会非常慢甚至失败。我们需要配置一个国内的镜像地址。
- 点击Docker Desktop右上角的齿轮图标进入设置（Settings）。
- 找到“Docker Engine”选项。你会看到一段JSON格式的配置代码。
- 在 "registry-mirrors": [] 这个中括号里，添加国内的镜像地址。你可以添加多个，这里推荐一个常用的：
```
"registry-mirrors": [
  "https://docker.mirrors.ustc.edu.cn",
  "https://hub-mirror.c.163.com"
]
```
- 点击右下角的“Apply & Restart”应用并重启Docker服务。
验证安装：
- 重启完成后，打开Windows终端（PowerShell或CMD）。
- 输入命令 docker --version 和 docker run hello-world。
- 如果能看到Docker版本信息，并且 hello-world 镜像能成功运行并输出欢迎信息，恭喜你，Docker基础环境已经就绪了！

3. 核心部署：拉取并运行通义千问镜像

环境准备好了，现在让我们把主角——通义千问的WebUI镜像跑起来。

3.1 获取镜像运行命令

我们这里使用的是已经集成好的星图平台镜像，它包含了模型、WebUI界面和所有依赖。

运行Docker命令：
- 打开你的终端（PowerShell或CMD）。
- 复制并运行下面的命令。这条命令做了几件事：从镜像仓库拉取镜像，创建一个容器，映射端口，并给它起个名字叫 qwen-webui。
```
docker run -d --name qwen-webui -p 7860:7860 -p 8000:8000 csdnstarhub/ai.qwen:1.5-1.8b-chat-gptq-int4-webui-latest
```
- 参数解释：
  - -d：让容器在后台运行。
  - --name qwen-webui：给容器起个名字，方便管理。
  - -p 7860:7860：将容器内部的7860端口映射到你电脑的7860端口。WebUI界面通常通过这个端口访问。
  - -p 8000:8000：再映射一个8000端口，有时API服务会用到。
  - 最后一段就是镜像地址。
等待镜像拉取与启动：
- 第一次运行需要下载镜像，时间取决于你的网速。配置了镜像加速后通常会快很多。
- 你可以通过 docker logs -f qwen-webui 命令来实时查看容器的启动日志。当你看到类似“Running on local URL: http://0.0.0.0:7860”这样的信息时，说明服务已经启动成功了。

3.2 访问WebUI界面

服务启动后，打开你电脑上的浏览器（比如Chrome或Edge）。

在地址栏输入：http://localhost:7860
如果一切正常，你应该能看到通义千问的Web聊天界面了！现在你就可以在输入框里和模型对话了。

4. 避坑指南：解决网络与访问问题

如果上一步你没能成功访问 localhost:7860，别急，大概率是网络配置或防火墙的问题。我们来逐一排查。

4.1 检查容器状态与端口映射

首先，确认容器是不是真的在运行，以及端口映射是否正确。

查看容器状态：
- 在终端运行 docker ps。你应该能看到一个名为 qwen-webui 的容器，状态（STATUS）显示为“Up”（运行中）。如果状态是“Exited”（已退出），说明容器启动失败了，可以用 docker logs qwen-webui 查看具体的错误日志。
确认端口映射：
- 运行 docker port qwen-webui。这个命令会列出该容器所有映射的端口。确认输出中包含 7860/tcp -> 0.0.0.0:7860。

4.2 应对Windows防火墙拦截

这是Windows环境下最常见的问题。Docker容器内部的服务，需要通过Windows主机的网络栈暴露出来，防火墙可能会阻止这个访问。

添加防火墙入站规则（推荐）：
- 打开“Windows Defender 防火墙”，选择“高级设置”。
- 在左侧点击“入站规则”，然后在右侧点击“新建规则...”。
- 规则类型选择“端口”，下一步。
- 选择“TCP”，并在“特定本地端口”中输入 7860,8000（两个端口用逗号隔开），下一步。
- 选择“允许连接”，下一步。
- 配置文件全选（域、专用、公用），下一步。
- 给规则起个名字，比如“Docker Qwen WebUI Ports”，完成。
- 完成后，再次尝试在浏览器访问 http://localhost:7860。
临时关闭防火墙（仅用于测试）：
- 如果不确定是否是防火墙问题，可以临时关闭防火墙来测试。在防火墙设置中，暂时关闭“专用网络”和“公用网络”的防火墙（不推荐长期关闭）。
- 如果关闭后能访问，那就证实是防火墙的问题，请采用上面“添加入站规则”的永久解决方案。

4.3 处理“端口已被占用”错误

如果在运行 docker run 命令时，提示类似“端口 7860 已被占用”的错误，说明你电脑上已经有其他程序在使用这个端口了。

解决方案有两种：

方案A：停止占用端口的程序。使用 netstat -ano | findstr :7860 命令找出占用7860端口的进程ID（PID），然后在任务管理器中结束它。
方案B：修改映射端口。将Docker命令中的端口映射改一下，比如 -p 8899:7860，这意味着将容器的7860端口映射到你电脑的8899端口。之后你需要通过 http://localhost:8899 来访问。

5. 进阶配置：文件共享与容器管理

基础功能搞定后，我们再来看看如何更高效地使用这个容器。

5.1 挂载本地目录（持久化数据）

默认情况下，容器内部产生的数据（如下载的模型、聊天记录等）会随着容器的删除而消失。我们可以通过“挂载”功能，将容器内的目录链接到Windows的某个文件夹，实现数据持久化。

在Windows上创建一个文件夹，例如 D:\qwen_data。
使用带 -v 参数的命令重新运行容器（先停止并删除旧的）：
```
# 先停止并删除旧容器
docker stop qwen-webui
docker rm qwen-webui

# 使用-v参数挂载目录，重新运行
docker run -d --name qwen-webui -p 7860:7860 -p 8000:8000 -v D:\qwen_data:/app/data csdnstarhub/ai.qwen:1.5-1.8b-chat-gptq-int4-webui-latest
```
- -v D:\qwen_data:/app/data：将Windows的 D:\qwen_data 文件夹，映射到容器内的 /app/data 目录。这样，容器内 /app/data 下的所有文件都会实际保存在你的D盘，即使容器重置也不会丢失。