open-webui 的安装和配置教程

1. 项目基础介绍

open-webui 是一个社区驱动的开源 AI 平台，它是 Open WebUI 的定制分支。该项目为用户提供了一个具有积分管理和充值功能的系统。需要注意的是，此版本与 Open WebUI 官方团队没有任何关联，亦非由其维护。

该项目主要使用以下编程语言开发：

• JavaScript
• Svelte
• Python
• TypeScript
• CSS
• Shell

2. 项目使用的关键技术和框架

open-webui 使用了多种技术和框架，以下是一些关键的部分：

• Svelte：一个渐进式JavaScript框架，用于构建用户界面。
• Python：后端服务的主要编程语言。
• TypeScript：用于编写可维护和可扩展的 JavaScript 代码。
• Docker：容器化技术，用于简化部署和扩展应用。
• Redis：用于缓存的键值存储系统。
• SMTP：用于处理电子邮件发送的协议。

3. 项目安装和配置的准备工作

在开始安装和配置 open-webui 前，请确保您的系统满足以下要求：

• Node.js 和 npm
• Python
• Docker
• Redis 服务器
• SMTP 服务器配置

详细安装步骤

1. 克隆项目仓库

   首先，您需要在本地克隆项目仓库。打开命令行，执行以下命令：

   git clone https://github.com/U8F69/open-webui.git
   cd open-webui
   

2. 安装依赖

   在项目根目录下，使用 npm 安装前端依赖，使用 pip 安装后端依赖。

   npm install
   pip install -r requirements.txt
   

3. 配置环境变量

   在 .env.example 文件中，根据您的服务器配置填写相应的环境变量，如 REDIS_URL、SMTP_HOST 等。

   REDIS_URL=redis://:<password>@<host>:6379/0
   SMTP_HOST=smtp.email.qq.com
   SMTP_PORT=465
   SMTP_USERNAME=[e-mail]
   SMTP_PASSWORD=password
   

4. 构建项目

   构建前端和后端项目。

   npm run build
   python manage.py run
   

5. 运行 Docker 容器

   根据您的需要选择合适的 Docker 配置文件（如 docker-compose.yaml），然后运行容器。

   docker-compose up -d
   

6. 访问项目

   在浏览器中输入您的服务器地址，如 http://localhost:8000，即可访问 open-webui。

请确保每一步操作都正确无误，如果在安装或配置过程中遇到问题，可以参考项目中的 TROUBLESHOOTING.md 文件进行问题排查。