From 66422a43d4c3622f67bcc8371bc4b2816b04243f Mon Sep 17 00:00:00 2001 From: Sam Blade <812101+samblade@user.noreply.gitee.com> Date: Tue, 28 Apr 2026 21:36:03 +0800 Subject: [PATCH 1/2] feat: add Open WebUI container images for OpenCloudOS 9 Add Dockerfiles, READMEs and test scripts for Open WebUI versions: - 0.8.3, 0.8.5, 0.8.6, 0.8.7, 0.8.8, 0.8.9, 0.8.10, 0.8.11, 0.8.12 Each version includes: - Dockerfile based on OpenCloudOS 9 minimalimage - README.md with build and usage instructions - test.sh for basic functionality verification Open WebUI is a user-friendly self-hosted AI interface supporting Ollama and OpenAI-compatible APIs. --- frameworks/open-webui/0.8.10/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.10/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.10/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.11/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.11/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.11/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.12/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.12/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.12/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.3/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.3/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.3/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.5/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.5/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.5/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.6/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.6/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.6/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.7/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.7/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.7/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.8/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.8/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.8/test.sh | 57 ++++++++++++++++ frameworks/open-webui/0.8.9/Dockerfile | 47 ++++++++++++++ frameworks/open-webui/0.8.9/README.md | 86 +++++++++++++++++++++++++ frameworks/open-webui/0.8.9/test.sh | 57 ++++++++++++++++ 27 files changed, 1710 insertions(+) create mode 100644 frameworks/open-webui/0.8.10/Dockerfile create mode 100644 frameworks/open-webui/0.8.10/README.md create mode 100755 frameworks/open-webui/0.8.10/test.sh create mode 100644 frameworks/open-webui/0.8.11/Dockerfile create mode 100644 frameworks/open-webui/0.8.11/README.md create mode 100755 frameworks/open-webui/0.8.11/test.sh create mode 100644 frameworks/open-webui/0.8.12/Dockerfile create mode 100644 frameworks/open-webui/0.8.12/README.md create mode 100755 frameworks/open-webui/0.8.12/test.sh create mode 100644 frameworks/open-webui/0.8.3/Dockerfile create mode 100644 frameworks/open-webui/0.8.3/README.md create mode 100755 frameworks/open-webui/0.8.3/test.sh create mode 100644 frameworks/open-webui/0.8.5/Dockerfile create mode 100644 frameworks/open-webui/0.8.5/README.md create mode 100755 frameworks/open-webui/0.8.5/test.sh create mode 100644 frameworks/open-webui/0.8.6/Dockerfile create mode 100644 frameworks/open-webui/0.8.6/README.md create mode 100755 frameworks/open-webui/0.8.6/test.sh create mode 100644 frameworks/open-webui/0.8.7/Dockerfile create mode 100644 frameworks/open-webui/0.8.7/README.md create mode 100755 frameworks/open-webui/0.8.7/test.sh create mode 100644 frameworks/open-webui/0.8.8/Dockerfile create mode 100644 frameworks/open-webui/0.8.8/README.md create mode 100755 frameworks/open-webui/0.8.8/test.sh create mode 100644 frameworks/open-webui/0.8.9/Dockerfile create mode 100644 frameworks/open-webui/0.8.9/README.md create mode 100755 frameworks/open-webui/0.8.9/test.sh diff --git a/frameworks/open-webui/0.8.10/Dockerfile b/frameworks/open-webui/0.8.10/Dockerfile new file mode 100644 index 0000000..2191fee --- /dev/null +++ b/frameworks/open-webui/0.8.10/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.10 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.10.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.10/* . && \ + rm -rf open-webui-0.8.10 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.10/README.md b/frameworks/open-webui/0.8.10/README.md new file mode 100644 index 0000000..4eac04e --- /dev/null +++ b/frameworks/open-webui/0.8.10/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.10 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.10 +docker build -t oc9-open-webui:0.8.10 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.10 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.10 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.10 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.10 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.10/test.sh b/frameworks/open-webui/0.8.10/test.sh new file mode 100755 index 0000000..853ce4e --- /dev/null +++ b/frameworks/open-webui/0.8.10/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.10 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.11/Dockerfile b/frameworks/open-webui/0.8.11/Dockerfile new file mode 100644 index 0000000..dde5184 --- /dev/null +++ b/frameworks/open-webui/0.8.11/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.11 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.11.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.11/* . && \ + rm -rf open-webui-0.8.11 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.11/README.md b/frameworks/open-webui/0.8.11/README.md new file mode 100644 index 0000000..5c10dd2 --- /dev/null +++ b/frameworks/open-webui/0.8.11/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.11 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.11 +docker build -t oc9-open-webui:0.8.11 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.11 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.11 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.11 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.11 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.11/test.sh b/frameworks/open-webui/0.8.11/test.sh new file mode 100755 index 0000000..36b58c3 --- /dev/null +++ b/frameworks/open-webui/0.8.11/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.11 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.12/Dockerfile b/frameworks/open-webui/0.8.12/Dockerfile new file mode 100644 index 0000000..ac51631 --- /dev/null +++ b/frameworks/open-webui/0.8.12/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.12 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.12.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.12/* . && \ + rm -rf open-webui-0.8.12 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.12/README.md b/frameworks/open-webui/0.8.12/README.md new file mode 100644 index 0000000..8d3208f --- /dev/null +++ b/frameworks/open-webui/0.8.12/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.12 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.12 +docker build -t oc9-open-webui:0.8.12 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.12 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.12 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.12 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.12 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.12/test.sh b/frameworks/open-webui/0.8.12/test.sh new file mode 100755 index 0000000..048e164 --- /dev/null +++ b/frameworks/open-webui/0.8.12/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.12 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.3/Dockerfile b/frameworks/open-webui/0.8.3/Dockerfile new file mode 100644 index 0000000..1da0c1b --- /dev/null +++ b/frameworks/open-webui/0.8.3/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.3 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.3.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.3/* . && \ + rm -rf open-webui-0.8.3 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.3/README.md b/frameworks/open-webui/0.8.3/README.md new file mode 100644 index 0000000..9b62414 --- /dev/null +++ b/frameworks/open-webui/0.8.3/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.3 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.3 +docker build -t oc9-open-webui:0.8.3 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.3 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.3 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.3 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.3 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.3/test.sh b/frameworks/open-webui/0.8.3/test.sh new file mode 100755 index 0000000..0ca1609 --- /dev/null +++ b/frameworks/open-webui/0.8.3/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.3 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.5/Dockerfile b/frameworks/open-webui/0.8.5/Dockerfile new file mode 100644 index 0000000..7bc6c5d --- /dev/null +++ b/frameworks/open-webui/0.8.5/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.5 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.5.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.5/* . && \ + rm -rf open-webui-0.8.5 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.5/README.md b/frameworks/open-webui/0.8.5/README.md new file mode 100644 index 0000000..aa04619 --- /dev/null +++ b/frameworks/open-webui/0.8.5/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.5 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.5 +docker build -t oc9-open-webui:0.8.5 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.5 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.5 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.5 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.5 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.5/test.sh b/frameworks/open-webui/0.8.5/test.sh new file mode 100755 index 0000000..370cdf7 --- /dev/null +++ b/frameworks/open-webui/0.8.5/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.5 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.6/Dockerfile b/frameworks/open-webui/0.8.6/Dockerfile new file mode 100644 index 0000000..445745d --- /dev/null +++ b/frameworks/open-webui/0.8.6/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.6 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.6.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.6/* . && \ + rm -rf open-webui-0.8.6 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.6/README.md b/frameworks/open-webui/0.8.6/README.md new file mode 100644 index 0000000..549751b --- /dev/null +++ b/frameworks/open-webui/0.8.6/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.6 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.6 +docker build -t oc9-open-webui:0.8.6 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.6 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.6 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.6 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.6 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.6/test.sh b/frameworks/open-webui/0.8.6/test.sh new file mode 100755 index 0000000..eda347c --- /dev/null +++ b/frameworks/open-webui/0.8.6/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.6 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.7/Dockerfile b/frameworks/open-webui/0.8.7/Dockerfile new file mode 100644 index 0000000..d7d2927 --- /dev/null +++ b/frameworks/open-webui/0.8.7/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.7 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.7.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.7/* . && \ + rm -rf open-webui-0.8.7 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.7/README.md b/frameworks/open-webui/0.8.7/README.md new file mode 100644 index 0000000..c091fdc --- /dev/null +++ b/frameworks/open-webui/0.8.7/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.7 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.7 +docker build -t oc9-open-webui:0.8.7 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.7 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.7 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.7 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.7 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.7/test.sh b/frameworks/open-webui/0.8.7/test.sh new file mode 100755 index 0000000..236a232 --- /dev/null +++ b/frameworks/open-webui/0.8.7/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.7 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.8/Dockerfile b/frameworks/open-webui/0.8.8/Dockerfile new file mode 100644 index 0000000..849627d --- /dev/null +++ b/frameworks/open-webui/0.8.8/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.8 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.8.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.8/* . && \ + rm -rf open-webui-0.8.8 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.8/README.md b/frameworks/open-webui/0.8.8/README.md new file mode 100644 index 0000000..8f305c0 --- /dev/null +++ b/frameworks/open-webui/0.8.8/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.8 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.8 +docker build -t oc9-open-webui:0.8.8 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.8 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.8 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.8 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.8 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.8/test.sh b/frameworks/open-webui/0.8.8/test.sh new file mode 100755 index 0000000..ecbef7a --- /dev/null +++ b/frameworks/open-webui/0.8.8/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.8 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" diff --git a/frameworks/open-webui/0.8.9/Dockerfile b/frameworks/open-webui/0.8.9/Dockerfile new file mode 100644 index 0000000..cadd80a --- /dev/null +++ b/frameworks/open-webui/0.8.9/Dockerfile @@ -0,0 +1,47 @@ +FROM opencloudos/opencloudos9-minimal:latest + +LABEL maintainer="OpenCloudOS Community" +LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" +LABEL org.opencontainers.image.description="Open WebUI 0.8.9 on OpenCloudOS 9" + +# 设置环境变量 +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 + +# 安装系统依赖 +RUN dnf install -y epol-release && \ + dnf install -y --nogpgcheck \ + python3-pip \ + python3.11 \ + python3.11-pip \ + nodejs \ + npm \ + git \ + curl \ + && dnf clean all \ + && rm -rf /var/cache/yum/* + +# 创建工作目录 +RUN mkdir -p /app +WORKDIR /app + +# 下载Open WebUI指定版本 +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.9.tar.gz -o open-webui.tar.gz && \ + tar -xzf open-webui.tar.gz && \ + rm open-webui.tar.gz && \ + mv open-webui-0.8.9/* . && \ + rm -rf open-webui-0.8.9 + +# 安装Python依赖 +RUN pip3.11 install --no-cache-dir -r backend/requirements.txt + +# 构建前端 +RUN cd frontend && npm install && npm run build && cd .. + +# 设置启动脚本 +RUN echo '#!/bin/bash' > /start.sh && \ + echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ + chmod +x /start.sh + +EXPOSE 8080 + +CMD ["/start.sh"] diff --git a/frameworks/open-webui/0.8.9/README.md b/frameworks/open-webui/0.8.9/README.md new file mode 100644 index 0000000..4321b23 --- /dev/null +++ b/frameworks/open-webui/0.8.9/README.md @@ -0,0 +1,86 @@ +# Open WebUI on OpenCloudOS 9 + +## 基本信息 +- **框架版本**：v0.8.9 +- **基础镜像**：opencloudos/opencloudos9-minimal:latest +- **Python版本**：3.11 +- **Node.js版本**：系统默认 +- **监听端口**：8080 + +## 简介 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 + +## 构建镜像 + +```bash +cd frameworks/open-webui/0.8.9 +docker build -t oc9-open-webui:0.8.9 . +``` + +## 运行容器 + +### 基础运行 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.9 +``` + +### 连接到 Ollama（本地） +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + oc9-open-webui:0.8.9 +``` + +### 使用 OpenAI API +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ + oc9-open-webui:0.8.9 +``` + +### 持久化数据 +```bash +docker run -d \ + --name open-webui \ + -p 8080:8080 \ + -v $(pwd)/data:/app/data \ + -e WEBUI_SECRET_KEY="your-secret-key" \ + oc9-open-webui:0.8.9 +``` + +## 访问服务 + +打开浏览器访问：http://localhost:8080 + +首次访问会引导创建管理员账户。 + +## 测试 + +```bash +# 进入容器测试 +docker exec -it open-webui /bin/bash +cd /app +bash test.sh +``` + +## 已知问题 + +- 首次启动可能需要一些时间来初始化数据库 +- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 +- 连接到 Ollama 时需要确保 Ollama 服务可访问 + +## 更多信息 + +- Open WebUI 官方文档：https://docs.openwebui.com/ +- GitHub仓库：https://github.com/open-webui/open-webui diff --git a/frameworks/open-webui/0.8.9/test.sh b/frameworks/open-webui/0.8.9/test.sh new file mode 100755 index 0000000..7a284de --- /dev/null +++ b/frameworks/open-webui/0.8.9/test.sh @@ -0,0 +1,57 @@ +#!/bin/bash +set -e + +echo "=== Open WebUI v0.8.9 基础功能测试 ===" + +# 1. 验证Python版本 +echo -n "检查Python版本... " +python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 2. 验证依赖安装 +echo -n "检查关键依赖安装... " +python3.11 -c " +import fastapi +import uvicorn +import starlette +print('核心依赖已安装') +" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } + +# 3. 验证后端结构 +echo -n "检查后端目录结构... " +if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 4. 验证前端构建 +echo -n "检查前端构建... " +if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then + echo "✓ 通过" +else + # 说明: 某些版本的构建目录可能不同，不打断测试流程 + echo "⚠ 说明(build过程中可能输出到其他目录)" +fi + +# 5. 验证启动脚本 +echo -n "检查启动脚本... " +if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +# 6. 端口监听测试（容器中不启动服务，仅验证配置） +echo -n "检查端口配置... " +if [ "$PORT" = "8080" ]; then + echo "✓ 通过" +else + echo "✗ 失败" + exit 1 +fi + +echo "=== 所有基础测试通过 ===" +echo "" +echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" -- Gitee From f1015e9e37fe1efe93773791c512b5bed9ab2be4 Mon Sep 17 00:00:00 2001 From: Sam Blade <812101+samblade@user.noreply.gitee.com> Date: Thu, 30 Apr 2026 11:03:11 +0800 Subject: [PATCH 2/2] =?UTF-8?q?feat(open-webui):=20=E5=A4=9A=E9=98=B6?= =?UTF-8?q?=E6=AE=B5=E6=9E=84=E5=BB=BA=E9=87=8D=E6=9E=84=EF=BC=8C=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=E4=BE=9D=E8=B5=96=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 所有9个版本(0.8.3~0.8.12)统一为多阶段构建 - 前端: node:22-alpine 构建阶段 - 运行时: opencloudos9-minimal 基础镜像 - 修复 ddgs==9.11.2 过期问题(0.8.9/0.8.10 sed 替换为 9.11.3) - 使用 uv 替代 pip 安装 Python 依赖 - 添加健康检查(HEALTHCHECK) - 更新 README 和 test.sh - 移除不在 FRAMEWORKS.md 中的版本(0.9.0/0.9.2/0.8.12-optimized) --- frameworks/open-webui/0.8.10/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.10/README.md | 63 ++++++-------- frameworks/open-webui/0.8.10/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.11/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.11/README.md | 63 ++++++-------- frameworks/open-webui/0.8.11/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.12/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.12/README.md | 63 ++++++-------- frameworks/open-webui/0.8.12/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.3/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.3/README.md | 63 ++++++-------- frameworks/open-webui/0.8.3/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.5/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.5/README.md | 63 ++++++-------- frameworks/open-webui/0.8.5/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.6/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.6/README.md | 63 ++++++-------- frameworks/open-webui/0.8.6/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.7/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.7/README.md | 63 ++++++-------- frameworks/open-webui/0.8.7/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.8/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.8/README.md | 63 ++++++-------- frameworks/open-webui/0.8.8/test.sh | 96 ++++++++++++--------- frameworks/open-webui/0.8.9/Dockerfile | 110 ++++++++++++++++++------ frameworks/open-webui/0.8.9/README.md | 63 ++++++-------- frameworks/open-webui/0.8.9/test.sh | 96 ++++++++++++--------- 27 files changed, 1512 insertions(+), 909 deletions(-) diff --git a/frameworks/open-webui/0.8.10/Dockerfile b/frameworks/open-webui/0.8.10/Dockerfile index 2191fee..256424a 100644 --- a/frameworks/open-webui/0.8.10/Dockerfile +++ b/frameworks/open-webui/0.8.10/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.10 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.10/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.10.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.10/* /app/ && \ + cp -r /tmp/open-webui-0.8.10/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.10 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.10 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.10" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.10.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.10/* . && \ - rm -rf open-webui-0.8.10 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.10/README.md b/frameworks/open-webui/0.8.10/README.md index 4eac04e..708cee2 100644 --- a/frameworks/open-webui/0.8.10/README.md +++ b/frameworks/open-webui/0.8.10/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.10 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.10 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.10 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.10 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.10 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.10/test.sh b/frameworks/open-webui/0.8.10/test.sh index 853ce4e..a097ddb 100755 --- a/frameworks/open-webui/0.8.10/test.sh +++ b/frameworks/open-webui/0.8.10/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.10 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.10 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.10" +CONTAINER_NAME="open-webui-test-0.8.10" + +echo "=== Testing Open WebUI 0.8.10 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.11/Dockerfile b/frameworks/open-webui/0.8.11/Dockerfile index dde5184..a6d4f3e 100644 --- a/frameworks/open-webui/0.8.11/Dockerfile +++ b/frameworks/open-webui/0.8.11/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.11 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.11/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.11.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.11/* /app/ && \ + cp -r /tmp/open-webui-0.8.11/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.11 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.11 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.11" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.11.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.11/* . && \ - rm -rf open-webui-0.8.11 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.11/README.md b/frameworks/open-webui/0.8.11/README.md index 5c10dd2..0ebf500 100644 --- a/frameworks/open-webui/0.8.11/README.md +++ b/frameworks/open-webui/0.8.11/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.11 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.11 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.11 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.11 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.11 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.11/test.sh b/frameworks/open-webui/0.8.11/test.sh index 36b58c3..8d91b52 100755 --- a/frameworks/open-webui/0.8.11/test.sh +++ b/frameworks/open-webui/0.8.11/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.11 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.11 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.11" +CONTAINER_NAME="open-webui-test-0.8.11" + +echo "=== Testing Open WebUI 0.8.11 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.12/Dockerfile b/frameworks/open-webui/0.8.12/Dockerfile index ac51631..6e33621 100644 --- a/frameworks/open-webui/0.8.12/Dockerfile +++ b/frameworks/open-webui/0.8.12/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.12 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.12/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.12.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.12/* /app/ && \ + cp -r /tmp/open-webui-0.8.12/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.12 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.12 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.12" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.12.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.12/* . && \ - rm -rf open-webui-0.8.12 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.12/README.md b/frameworks/open-webui/0.8.12/README.md index 8d3208f..194384f 100644 --- a/frameworks/open-webui/0.8.12/README.md +++ b/frameworks/open-webui/0.8.12/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.12 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.12 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.12 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.12 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.12 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.12/test.sh b/frameworks/open-webui/0.8.12/test.sh index 048e164..606b419 100755 --- a/frameworks/open-webui/0.8.12/test.sh +++ b/frameworks/open-webui/0.8.12/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.12 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.12 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.12" +CONTAINER_NAME="open-webui-test-0.8.12" + +echo "=== Testing Open WebUI 0.8.12 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.3/Dockerfile b/frameworks/open-webui/0.8.3/Dockerfile index 1da0c1b..207a70c 100644 --- a/frameworks/open-webui/0.8.3/Dockerfile +++ b/frameworks/open-webui/0.8.3/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.3 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.3/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.3.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.3/* /app/ && \ + cp -r /tmp/open-webui-0.8.3/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.3 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.3 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.3" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.3.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.3/* . && \ - rm -rf open-webui-0.8.3 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.3/README.md b/frameworks/open-webui/0.8.3/README.md index 9b62414..3c286f3 100644 --- a/frameworks/open-webui/0.8.3/README.md +++ b/frameworks/open-webui/0.8.3/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.3 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.3 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.3 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.3 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.3 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.3/test.sh b/frameworks/open-webui/0.8.3/test.sh index 0ca1609..5ee7e64 100755 --- a/frameworks/open-webui/0.8.3/test.sh +++ b/frameworks/open-webui/0.8.3/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.3 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.3 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.3" +CONTAINER_NAME="open-webui-test-0.8.3" + +echo "=== Testing Open WebUI 0.8.3 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.5/Dockerfile b/frameworks/open-webui/0.8.5/Dockerfile index 7bc6c5d..de7b162 100644 --- a/frameworks/open-webui/0.8.5/Dockerfile +++ b/frameworks/open-webui/0.8.5/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.5 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.5/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.5.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.5/* /app/ && \ + cp -r /tmp/open-webui-0.8.5/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.5 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.5 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.5" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.5.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.5/* . && \ - rm -rf open-webui-0.8.5 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.5/README.md b/frameworks/open-webui/0.8.5/README.md index aa04619..a2830d0 100644 --- a/frameworks/open-webui/0.8.5/README.md +++ b/frameworks/open-webui/0.8.5/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.5 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.5 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.5 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.5 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.5 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.5/test.sh b/frameworks/open-webui/0.8.5/test.sh index 370cdf7..ec806c9 100755 --- a/frameworks/open-webui/0.8.5/test.sh +++ b/frameworks/open-webui/0.8.5/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.5 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.5 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.5" +CONTAINER_NAME="open-webui-test-0.8.5" + +echo "=== Testing Open WebUI 0.8.5 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.6/Dockerfile b/frameworks/open-webui/0.8.6/Dockerfile index 445745d..b7ed0f1 100644 --- a/frameworks/open-webui/0.8.6/Dockerfile +++ b/frameworks/open-webui/0.8.6/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.6 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.6/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.6.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.6/* /app/ && \ + cp -r /tmp/open-webui-0.8.6/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.6 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.6 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.6" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.6.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.6/* . && \ - rm -rf open-webui-0.8.6 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.6/README.md b/frameworks/open-webui/0.8.6/README.md index 549751b..63c3871 100644 --- a/frameworks/open-webui/0.8.6/README.md +++ b/frameworks/open-webui/0.8.6/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.6 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.6 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.6 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.6 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.6 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.6/test.sh b/frameworks/open-webui/0.8.6/test.sh index eda347c..d077d9a 100755 --- a/frameworks/open-webui/0.8.6/test.sh +++ b/frameworks/open-webui/0.8.6/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.6 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.6 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.6" +CONTAINER_NAME="open-webui-test-0.8.6" + +echo "=== Testing Open WebUI 0.8.6 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.7/Dockerfile b/frameworks/open-webui/0.8.7/Dockerfile index d7d2927..77fe029 100644 --- a/frameworks/open-webui/0.8.7/Dockerfile +++ b/frameworks/open-webui/0.8.7/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.7 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.7/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.7.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.7/* /app/ && \ + cp -r /tmp/open-webui-0.8.7/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.7 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.7 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.7" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.7.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.7/* . && \ - rm -rf open-webui-0.8.7 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.7/README.md b/frameworks/open-webui/0.8.7/README.md index c091fdc..ec0f475 100644 --- a/frameworks/open-webui/0.8.7/README.md +++ b/frameworks/open-webui/0.8.7/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.7 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.7 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.7 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.7 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.7 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.7/test.sh b/frameworks/open-webui/0.8.7/test.sh index 236a232..8d50c81 100755 --- a/frameworks/open-webui/0.8.7/test.sh +++ b/frameworks/open-webui/0.8.7/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.7 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.7 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.7" +CONTAINER_NAME="open-webui-test-0.8.7" + +echo "=== Testing Open WebUI 0.8.7 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.8/Dockerfile b/frameworks/open-webui/0.8.8/Dockerfile index 849627d..e4590d5 100644 --- a/frameworks/open-webui/0.8.8/Dockerfile +++ b/frameworks/open-webui/0.8.8/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.8 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.8/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.8.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.8/* /app/ && \ + cp -r /tmp/open-webui-0.8.8/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.8 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.8 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.8" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.8.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.8/* . && \ - rm -rf open-webui-0.8.8 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.8/README.md b/frameworks/open-webui/0.8.8/README.md index 8f305c0..fb2de6f 100644 --- a/frameworks/open-webui/0.8.8/README.md +++ b/frameworks/open-webui/0.8.8/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.8 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.8 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.8 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.8 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.8 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.8/test.sh b/frameworks/open-webui/0.8.8/test.sh index ecbef7a..6212595 100755 --- a/frameworks/open-webui/0.8.8/test.sh +++ b/frameworks/open-webui/0.8.8/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.8 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.8 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.8" +CONTAINER_NAME="open-webui-test-0.8.8" + +echo "=== Testing Open WebUI 0.8.8 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" diff --git a/frameworks/open-webui/0.8.9/Dockerfile b/frameworks/open-webui/0.8.9/Dockerfile index cadd80a..15f6424 100644 --- a/frameworks/open-webui/0.8.9/Dockerfile +++ b/frameworks/open-webui/0.8.9/Dockerfile @@ -1,47 +1,107 @@ +# Open WebUI v0.8.9 on OpenCloudOS 9 +# Based on official: https://github.com/open-webui/open-webui/blob/v0.8.9/Dockerfile +# Changes: Multi-stage build adapted for OC9 + +######## Frontend build stage ######## +FROM --platform=$BUILDPLATFORM node:22-alpine AS build + +ARG BUILD_HASH=oc9-build + +WORKDIR /app + +# Install git for version info +RUN apk add --no-cache git curl + +# Download Open WebUI source +RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.9.tar.gz -o /tmp/open-webui.tar.gz && \ + tar -xzf /tmp/open-webui.tar.gz -C /tmp && \ + cp -r /tmp/open-webui-0.8.9/* /app/ && \ + cp -r /tmp/open-webui-0.8.9/.* /app/ 2>/dev/null || true && \ + rm -rf /tmp/open-webui.tar.gz /tmp/open-webui-0.8.9 + +# Install frontend dependencies and build +RUN npm ci --force +ENV APP_BUILD_HASH=${BUILD_HASH} +RUN npm run build + +######## Runtime stage - OpenCloudOS 9 ######## FROM opencloudos/opencloudos9-minimal:latest LABEL maintainer="OpenCloudOS Community" LABEL org.opencontainers.image.source="https://gitee.com/OpenCloudOS/ai-agent-container" LABEL org.opencontainers.image.description="Open WebUI 0.8.9 on OpenCloudOS 9" +LABEL org.opencontainers.image.version="0.8.9" + +# Python & App settings +ENV PYTHONUNBUFFERED=1 +ENV PYTHONDONTWRITEBYTECODE=1 +ENV ENV=prod +ENV PORT=8080 +ENV HOME=/root -# 设置环境变量 -ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 NODE_ENV=production PORT=8080 +# Security & Privacy +ENV SCARF_NO_ANALYTICS=true +ENV DO_NOT_TRACK=true +ENV ANONYMIZED_TELEMETRY=false -# 安装系统依赖 +# API Configuration +ENV WEBUI_SECRET_KEY=*** +ENV OLLAMA_BASE_URL=/ollama +ENV OPENAI_API_BASE_URL="" + +# Embedding Model settings +ENV RAG_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 +ENV RAG_RERANKING_MODEL="" +ENV SENTENCE_TRANSFORMERS_HOME=/app/backend/data/cache/embedding/models +ENV HF_HOME=/app/backend/data/cache/embedding/models + +# Whisper settings +ENV WHISPER_MODEL=base +ENV WHISPER_MODEL_DIR=/app/backend/data/cache/whisper/models + +WORKDIR /app + +# Install system dependencies RUN dnf install -y epol-release && \ dnf install -y --nogpgcheck \ python3-pip \ - python3.11 \ - python3.11-pip \ - nodejs \ - npm \ + python3-devel \ git \ + gcc \ + gcc-c++ \ + make \ curl \ + jq \ + ffmpeg \ + zstd \ && dnf clean all \ && rm -rf /var/cache/yum/* -# 创建工作目录 -RUN mkdir -p /app -WORKDIR /app +# Copy built frontend and full source from build stage +COPY --from=build /app /app -# 下载Open WebUI指定版本 -RUN curl -L https://github.com/open-webui/open-webui/archive/refs/tags/v0.8.9.tar.gz -o open-webui.tar.gz && \ - tar -xzf open-webui.tar.gz && \ - rm open-webui.tar.gz && \ - mv open-webui-0.8.9/* . && \ - rm -rf open-webui-0.8.9 +WORKDIR /app/backend -# 安装Python依赖 -RUN pip3.11 install --no-cache-dir -r backend/requirements.txt +# Fix stale pinned dependencies and install with uv +RUN pip3 install --no-cache-dir uv && \ + sed -i 's/ddgs==9.11.2/ddgs==9.11.3/g' requirements.txt && \ + uv pip install --system --no-cache-dir -r requirements.txt && \ + pip3 install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu && \ + rm -rf /root/.cache/pip/* -# 构建前端 -RUN cd frontend && npm install && npm run build && cd .. +# Pre-download nltk data +RUN python3 -c "import nltk; nltk.download('punkt_tab', quiet=True)" 2>/dev/null || true -# 设置启动脚本 -RUN echo '#!/bin/bash' > /start.sh && \ - echo 'cd /app && python3.11 -m uvicorn main:app --host 0.0.0.0 --port 8080' >> /start.sh && \ - chmod +x /start.sh +# Create data directories +RUN mkdir -p /app/backend/data/cache && \ + mkdir -p /app/backend/data/vector_db EXPOSE 8080 -CMD ["/start.sh"] +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \ + CMD curl --silent --fail http://localhost:${PORT}/health | jq -ne 'input.status == true' || exit 1 + +ENV DOCKER=true + +CMD ["bash", "start.sh"] diff --git a/frameworks/open-webui/0.8.9/README.md b/frameworks/open-webui/0.8.9/README.md index 4321b23..89ebf21 100644 --- a/frameworks/open-webui/0.8.9/README.md +++ b/frameworks/open-webui/0.8.9/README.md @@ -1,14 +1,15 @@ -# Open WebUI on OpenCloudOS 9 +# Open WebUI 0.8.9 on OpenCloudOS 9 -## 基本信息 -- **框架版本**：v0.8.9 -- **基础镜像**：opencloudos/opencloudos9-minimal:latest -- **Python版本**：3.11 -- **Node.js版本**：系统默认 -- **监听端口**：8080 +[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。 -## 简介 -[Open WebUI](https://github.com/open-webui/open-webui) 是一个用户友好的自托管 AI 界面，支持 Ollama 和兼容 OpenAI API 的 LLM。提供直观的聊天界面、文档上传、RAG 支持、多模态交互等功能。 +## 镜像信息 + +| 项目 | 值 | +|------|-----| +| 基础镜像 | `opencloudos/opencloudos9-minimal:latest` | +| 前端构建 | `node:22-alpine`（多阶段构建） | +| Python 版本 | 3.11 (OC9 自带) | +| 监听端口 | 8080 | ## 构建镜像 @@ -35,52 +36,42 @@ docker run -d \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434" \ + --add-host=host.docker.internal:host-gateway \ oc9-open-webui:0.8.9 ``` -### 使用 OpenAI API +### 连接到 OpenAI API ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ -e WEBUI_SECRET_KEY="your-secret-key" \ - -e OPENAI_API_KEY="your-openai-key" \ + -e OPENAI_API_KEY="sk-your-api-key" \ -e OPENAI_API_BASE_URL="https://api.openai.com/v1" \ oc9-open-webui:0.8.9 ``` -### 持久化数据 +## 数据持久化 + ```bash docker run -d \ --name open-webui \ -p 8080:8080 \ - -v $(pwd)/data:/app/data \ - -e WEBUI_SECRET_KEY="your-secret-key" \ + -v open-webui-data:/app/backend/data \ oc9-open-webui:0.8.9 ``` -## 访问服务 - -打开浏览器访问：http://localhost:8080 - -首次访问会引导创建管理员账户。 - -## 测试 - -```bash -# 进入容器测试 -docker exec -it open-webui /bin/bash -cd /app -bash test.sh -``` - -## 已知问题 +## 环境变量 -- 首次启动可能需要一些时间来初始化数据库 -- 建议设置 WEBUI_SECRET_KEY 以保持一致的秘密 -- 连接到 Ollama 时需要确保 Ollama 服务可访问 +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `PORT` | `8080` | 服务监听端口 | +| `OLLAMA_BASE_URL` | `/ollama` | Ollama 服务地址 | +| `OPENAI_API_BASE_URL` | 空 | OpenAI API 地址 | +| `WEBUI_SECRET_KEY` | `***` | WebUI 密钥 | +| `RAG_EMBEDDING_MODEL` | `sentence-transformers/all-MiniLM-L6-v2` | RAG 嵌入模型 | +| `WHISPER_MODEL` | `base` | Whisper 语音模型 | -## 更多信息 +## 健康检查 -- Open WebUI 官方文档：https://docs.openwebui.com/ -- GitHub仓库：https://github.com/open-webui/open-webui +容器内置健康检查，每 30 秒检查一次 `/health` 端点。 diff --git a/frameworks/open-webui/0.8.9/test.sh b/frameworks/open-webui/0.8.9/test.sh index 7a284de..63c036a 100755 --- a/frameworks/open-webui/0.8.9/test.sh +++ b/frameworks/open-webui/0.8.9/test.sh @@ -1,57 +1,73 @@ #!/bin/bash +# Test script for Open WebUI 0.8.9 on OpenCloudOS 9 set -e -echo "=== Open WebUI v0.8.9 基础功能测试 ===" - -# 1. 验证Python版本 -echo -n "检查Python版本... " -python3.11 --version && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 2. 验证依赖安装 -echo -n "检查关键依赖安装... " -python3.11 -c " -import fastapi -import uvicorn -import starlette -print('核心依赖已安装') -" && echo "✓ 通过" || { echo "✗ 失败"; exit 1; } - -# 3. 验证后端结构 -echo -n "检查后端目录结构... " -if [ -d "/app/backend" ] && [ -f "/app/backend/requirements.txt" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +IMAGE_NAME="oc9-open-webui:0.8.9" +CONTAINER_NAME="open-webui-test-0.8.9" + +echo "=== Testing Open WebUI 0.8.9 ===" + +# Clean up any existing container +docker rm -f $CONTAINER_NAME 2>/dev/null || true + +# Step 1: Check image exists +echo "[1/5] Checking image..." +if ! docker image inspect $IMAGE_NAME > /dev/null 2>&1; then + echo "FAIL: Image $IMAGE_NAME not found. Build it first with: docker build -t $IMAGE_NAME ." exit 1 fi +echo "PASS: Image exists" -# 4. 验证前端构建 -echo -n "检查前端构建... " -if [ -d "/app/frontend/dist" ] || [ -d "/app/dist" ]; then - echo "✓ 通过" +# Step 2: Check base image is OpenCloudOS 9 +echo "[2/5] Checking base image..." +OS_INFO=$(docker run --rm $IMAGE_NAME cat /etc/os-release 2>/dev/null) +if echo "$OS_INFO" | grep -q "OpenCloudOS"; then + echo "PASS: Base image is OpenCloudOS" else - # 说明: 某些版本的构建目录可能不同，不打断测试流程 - echo "⚠ 说明(build过程中可能输出到其他目录)" + echo "FAIL: Base image is not OpenCloudOS" + exit 1 fi -# 5. 验证启动脚本 -echo -n "检查启动脚本... " -if [ -f "/start.sh" ] && [ -x "/start.sh" ]; then - echo "✓ 通过" +# Step 3: Check Python 3.11 available +echo "[3/5] Checking Python 3.11..." +PYTHON_VER=$(docker run --rm $IMAGE_NAME python3 --version 2>/dev/null) +if echo "$PYTHON_VER" | grep -q "3.11"; then + echo "PASS: Python 3.11 available ($PYTHON_VER)" else - echo "✗ 失败" + echo "FAIL: Python 3.11 not found" exit 1 fi -# 6. 端口监听测试（容器中不启动服务，仅验证配置） -echo -n "检查端口配置... " -if [ "$PORT" = "8080" ]; then - echo "✓ 通过" -else - echo "✗ 失败" +# Step 4: Start container and check health +echo "[4/5] Starting container and checking health..." +docker run -d --name $CONTAINER_NAME -p 18080:8080 $IMAGE_NAME + +# Wait for startup +echo "Waiting for container to start (40s)..." +sleep 40 + +# Check if container is running +if ! docker ps | grep -q $CONTAINER_NAME; then + echo "FAIL: Container is not running" + docker logs $CONTAINER_NAME 2>&1 | tail -20 + docker rm -f $CONTAINER_NAME 2>/dev/null || true exit 1 fi +echo "PASS: Container is running" + +# Step 5: Check HTTP endpoint +echo "[5/5] Checking HTTP endpoint..." +HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/ || echo "000") +if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "302" ]; then + echo "PASS: HTTP endpoint returned $HTTP_CODE" +else + echo "WARN: HTTP endpoint returned $HTTP_CODE (may need more startup time)" +fi + +# Cleanup +docker rm -f $CONTAINER_NAME 2>/dev/null || true -echo "=== 所有基础测试通过 ===" echo "" -echo "提示: 完整的运行时测试需要在容器启动后执行，访问 http://localhost:8080" +echo "=== Test Summary ===" +echo "Image: $IMAGE_NAME" +echo "All critical checks passed!" -- Gitee