使用 Docker Model Runner 和 Open WebUI 本地生成图像

使用 Docker Model Runner 本地生成图像 | Docker

跳至内容

从800多位构建者和领导者那里了解AI代理的现状。下载你的副本

✕

[](http://www.docker.com/)

• AI

AI

• Docker for AI 简化代理开发
• Docker MCP 目录与工具包 连接和管理MCP工具
• Docker Model Runner 轻松实现本地优先的LLM推理
• Docker Sandboxes 为编码代理提供全新的隔离环境

更多开发者资源


• 产品

产品

• Docker 硬化镜像 使用安全、企业就绪的镜像进行部署
• Docker Desktop 容器化你的应用程序
• Docker Hub 发现和分享容器镜像
• Docker Scout 简化软件供应链
• Docker Build Cloud 加速你的镜像构建
• Testcontainers Desktop 使用真实依赖进行本地测试
• Testcontainers Cloud 在云端无限制测试
• Docker MCP 目录与工具包 新功能 连接和管理MCP工具
• Docker Offload 摆脱本地限制


• 开发者

开发者

• 文档 查找Docker产品的使用指南
• 入门 学习Docker基础知识
• 资源 搜索丰富的实用材料库
• 培训 提升你的Docker技能
• Extensions SDK 创建和分享你自己的扩展
• 社区 与其他Docker开发者建立联系
• 开源项目 探索开源项目
• 预览计划 帮助塑造Docker的未来
• 客户案例 获取客户故事的灵感

更多开发者资源


获取最新Docker资讯

• 定价
• 支持
• 博客
• 公司

公司

• 关于我们 让我们自我介绍
• 什么是容器？ 了解容器化
• 为什么选择Docker 发现我们的独特之处
• 信任 查找我们的客户信任资源
• 合作伙伴 成为Docker合作伙伴
• 客户成功 了解如何借助Docker取得成功
• 活动 参加线下和线上聚会
• Docker商店 购买专属周边商品
• 招聘 加入我们的团队
• 联系我们 我们期待你的来信


搜索

登录立即开始

切换菜单

使用 Docker Model Runner 和 Open WebUI 本地生成图像

发布于 2026年5月5日

Ignasi Lopez Luna

我们都经历过这种情况：你需要为项目生成几张图像，于是启动一个AI图像服务，却突然开始担心你的提示词去哪了、还剩多少积分，或者为什么那个“安全内容”过滤器拒绝了你关于“穿西装的龙”的合理请求。如果能跳过这一切，直接在自己的机器上运行整个流程，并配上一个简洁的聊天界面，会怎样？

这正是 Docker Model Runner 现在能够实现的功能。只需几个命令，你就可以拉取一个图像生成模型，将其与 Open WebUI 连接，并直接通过一个完全本地化、完全私有、完全属于你的聊天界面生成图像。

让我们开始构建吧。_你的私人版 DALL-E，无需任何云订阅。_

你需要准备什么

• Docker Desktop（macOS）或 Docker Engine（Linux）
• 约 8 GB 空闲内存（小型模型），内存越多越好
• GPU：可选但强烈推荐，支持 NVIDIA（CUDA）、Apple Silicon（MPS）或 CPU 回退

如果你能无错误地运行 docker model version，那就没问题了。

Docker Model Runner 如何与 Open WebUI 配合工作

在深入之前，先看整体架构：

Docker Model Runner 充当控制平面：它下载模型、管理推理后端的生命周期，并暴露一个100% 兼容 OpenAI 的 API —— 包括 Open WebUI 已知如何调用的 POST /v1/images/generations 端点。

第一步：拉取图像生成模型

Docker Model Runner 使用一种名为 DDUF（Diffusers 统一格式）的紧凑打包格式，通过 Docker Hub 分发图像生成模型，就像分发任何其他 OCI 工件一样。

拉取一个模型开始：

docker model pull stable-diffusion

你可以确认它已就绪：

docker model inspect stable-diffusion

{

}

幕后发生了什么？ 该模型以 DDUF 文件的形式本地存储，这是一种单文件格式，将扩散模型的所有组件（文本编码器、VAE、UNet/DiT、调度器配置）打包成一个可移植的工件。Docker Model Runner 知道如何在运行时解包它。

第二步：启动 Open WebUI

这就像一个魔术。Docker Model Runner 内置了一个启动命令，能精确地将 Open WebUI 连接到本地推理端点：

docker model launch openwebui

仅此而已。后台实际执行的是：

docker run --rm \

`model-runner.docker.internal` 是一个特殊 DNS 条目，Docker Desktop 容器通过它访问主机上运行的 Model Runner，无需任何端口转发的复杂操作。如果你使用 Docker CE，则会看到 `docker/model-runner` 容器地址而非 `model-runner.docker.internal`。

在浏览器中打开 [**http://localhost:3000**](http://localhost:3000/)，创建一个本地账户（保持离线），你将进入聊天界面。

**提示**：想在后台运行？添加 `--detach`：

`docker model launch openwebui --detach`

更喜欢使用 Docker Compose？完整设置请参见：[https://docs.docker.com/ai/model-runner/openwebui-integration/](https://docs.docker.com/ai/model-runner/openwebui-integration/)

## 第三步：配置 Open WebUI 以支持图像生成

Open WebUI 已自动使用 Docker Model Runner 进行文本聊天（它读取 OPENAI_API_BASE 环境变量）。要支持图像生成，你还需要将其指向图像端点，这在设置界面中只需30秒即可完成。

1.   访问 [http://localhost:3000/admin/settings/images](http://localhost:3000/admin/settings/images)
2.   启用 **图像生成**
3.   填写以下字段：
4.   点击 **保存**

| **字段** | **值** |
| --- | --- |
| 字段 **模型** | 值：stable-diffusion |
| 字段 **API 基础 URL** | 值：http://model-runner.docker.internal/engines/diffusers/v1 |
| 字段 **API 密钥** | 值：任意内容 |

**为什么使用虚拟 API 密钥？** Docker Model Runner 不需要身份验证，它是一个本地服务。密钥仅因 Open WebUI 表单要求而存在，任何非空字符串均可。

## 第四步：拉取一个聊天模型

Open WebUI 也是一个功能完整的聊天界面，其最出色的功能之一是让你**在对话中直接让 LLM 生成图像**。为此，你还需要一个语言模型。

`# 轻量级选项 — 几乎可在任何机器上运行`

`docker model pull smollm2`

`# 推荐选项 — 更强大，更擅长理解创意提示`

`docker model pull gpt-oss`

两者都会自动出现在 Open WebUI 的模型选择器中。内存紧张时使用 smollm2；若希望在图像生成前获得更丰富、更具创意的响应，则使用 gpt-oss。

**无需额外配置**，Open WebUI 会自动从已配置的同一 OPENAI_API_BASE 端点获取文本模型。

## 第五步：生成你的第一张图像

返回主聊天界面，你会注意到消息输入栏中有一个小**图像图标**。

![Image 16: 使用 Open WebUI 生成图像 图2](https://www.docker.com/app/uploads/2026/03/Generate-image-with-Open-WebUI-fig-2.pn