vienedusoft/open-webui

Open WebUI 镜像文档

镜像概述

Open WebUI 是一个可扩展的自托管AI界面，旨在为用户提供直观、灵活的方式与各类AI模型进行交互。作为自托管解决方案，它允许用户在本地环境部署，确保数据处理和存储的隐私性与自主性，同时支持功能扩展以满足多样化的AI交互需求。

核心功能与特性

• 可扩展性：支持通过插件或扩展机制扩展功能，适配不同AI模型和使用场景。
• 自托管部署：可在本地服务器或私有环境部署，数据不依赖第三方服务，保障数据安全与隐私。
• 用户友好界面：提供直观的交互界面，降低AI模型使用门槛，适合非技术用户操作。
• 兼容性：兼容主流AI模型接口，支持与各类本地或远程AI服务集成。

使用场景与适用范围

• 个人用户：本地部署AI交互界面，用于日常AI对话、内容生成、信息查询等。
• 企业/团队：内部部署作为AI工具平台，支持团队协作使用AI功能，确保企业数据不外流。
• 开发者：作为AI应用原型开发工具，快速构建和测试AI交互界面。
• 隐私敏感场景：***、***等对数据隐私要求高的领域，通过自托管保障数据合规性。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Open WebUI容器：

bash
docker run -d \
  --name open-webui \
  -p 3000:8080 \
  -v open-webui-data:/app/data \
  --restart always \
  ghcr.io/open-webui/open-webui:main

参数说明：

• -p 3000:8080：将容器内8080端口映射到主机3000端口，通过http://localhost:3000访问界面。
• -v open-webui-data:/app/data：持久化存储数据（如配置、对话历史等），避免容器重启后数据丢失。
• --restart always：容器异常退出时自动重启。

Docker Compose 配置

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui-data:/app/data
    restart: always

volumes:
  open-webui-data:

启动服务：

bash
docker-compose up -d

访问与配置

部署完成后，通过浏览器访问http://localhost:3000进入Open WebUI界面。首次使用需完成初始化配置，包括设置管理员账户、连接AI模型（如本地部署的LLM服务或API密钥配置）等。具体配置步骤可参考界面引导或官方文档。

注意事项

• 确保主机已安装Docker和Docker Compose（如需使用）。
• 根据实际需求调整端口映射（如主机3000端口被占用，可替换为其他空闲端口）。
• 持久化卷open-webui-data建议定期备份，防止数据丢失。
• 如需扩展功能，可通过官方文档了解插件安装或自定义配置方法。