Open WebUI Docker 部署完全指南

type

status

date

slug

summary

项目简介

Open WebUI 提供了类似 ChatGPT 的 Web 界面，可以连接各种开源大语言模型，支持私有化部署，保护数据隐私。

主要特性：

🎨 美观的 Web 界面

🔌 支持多种 LLM 后端

🔒 支持离线模式运行

🛠️ 高度可定制化

🐳 Docker 一键部署

部署准备

环境要求

Docker 已安装并运行

至少 2GB 可用内存

足够的磁盘空间用于数据持久化

创建数据目录

Docker 部署

单行命令部署

使用以下命令快速部署 Open WebUI：

参数说明

参数	说明
`--restart unless-stopped`	容器自动重启策略
`--name open-webui`	容器名称
`-p 3000:8080`	端口映射（主机:容器）
`-e TZ=Asia/Shanghai`	设置时区
`-e OFFLINE_MODE=true`	启用离线模式
`-e HF_HUB_OFFLINE=1`	禁用 HuggingFace Hub 连接
`-e WEBUI_SECRET_KEY`	安全密钥（用于加密）
`-e WEBUI_NAME`	Web 界面显示名称
`-v $(pwd)/openwebui:/app/backend/data`	数据持久化目录

⚠️ 安全提示

- WEBUI_SECRET_KEY 请替换为强随机字符串（建议 32 位以上）

- 可使用 openssl rand -base64 32 生成安全密钥

- 首次部署后请勿更改此密钥，否则已加密数据无法解密

访问服务

部署完成后，通过浏览器访问：

首次访问需要创建管理员账号。

容器管理

查看运行状态

查看日志

重启容器

停止容器

删除容器

数据备份

所有用户数据、配置和对话历史都存储在挂载的数据目录中：

升级更新

常见问题

无法访问 3000 端口

检查防火墙设置：

容器频繁重启

查看日志排查问题：

常见原因：

内存不足

配置参数错误

数据迁移

直接复制数据目录即可：

进阶配置

连接外部模型

在 Web 界面的设置中可以配置：

Ollama 后端地址

OpenAI API 端点

其他兼容 OpenAI API 的服务

反向代理

使用 Nginx 配置 HTTPS 访问：

总结

Open WebUI 提供了简单易用的部署方式，通过 Docker 可以快速搭建私有化的 AI 对话服务。配合离线模式和数据持久化，非常适合个人或团队使用。

关键要点：

✅ 使用强随机密钥保护数据安全

✅ 及时更新到最新版本

✅ 根据需要配置反向代理和 HTTPS

最后更新：2025-12-10