纠结 CherryStudio 和 OpenWebUI？我全都要！HaloWebUI开启测试

docker run -d \

  --name open-webui \

  --restart always \

  -p 3000:8080 \

  -v open-webui:/app/backend/data \

  ghcr.io/ztx888/openwebui:latest

• 浏览器访问：http://你的服务器IP:3000


• 数据持久化在 Docker 卷：open-webui（用于重启或者更新的时候不丢配置和对话）

如果你本机没有 Docker 卷习惯，也可以改成本地目录挂载：

mkdir -p ./open-webui-data



docker run -d \

  --name open-webui \

  --restart always \

  -p 3000:8080 \

  -v $(pwd)/open-webui-data:/app/backend/data \

  ghcr.io/ztx888/openwebui:latest

适合：不想用 Docker、不想折腾前端构建、就想稳定跑起来的佬。

优势：步骤少、更新方便、跟管理 Node 项目一样用 PM2 守护

^-^ 注意：本包同时提供 open-webui 和 open-webui-leon 两个命令。

为避免与官方包冲突，建议使用独立 venv 并优先用 open-webui-leon 命令。

1、准备环境

• Python：建议 3.11 或 3.12（不支持 3.13）


• Node：仅用于装 PM2（装过的佬忽略）

2、创建目录 + venv + 安装

mkdir -p /opt/open-webui

cd /opt/open-webui



python3.11 -m venv venv

source venv/bin/activate



# 从 GitHub Release 安装（务必替换版本号！！！）⚠️

pip install https://github.com/ztx888/open-webui/releases/download/v0.7.3-7/open_webui_leon-0.7.3.post7-py3-none-any.whl

3、准备数据目录

mkdir -p /opt/open-webui/data

4、先手动跑一次确认

source /opt/open-webui/venv/bin/activate

export DATA_DIR=/opt/open-webui/data



open-webui-leon serve --host 0.0.0.0 --port 8080

浏览器访问：http://你的服务器IP:8080

确认能访问后按 Ctrl+C 停止，继续下一步

5、用 PM2 守护自动重启 + 日志

# 安装 PM2

npm i -g pm2



# 创建启动脚本（推荐方式）

cat > /opt/open-webui/start.sh << 'EOF'

#!/bin/bash

cd /opt/open-webui

source venv/bin/activate

export DATA_DIR=/opt/open-webui/data

export RAG_EMBEDDING_ENGINE=openai

export ENABLE_MEMORIES=false

exec open-webui-leon serve --host 0.0.0.0 --port 8080

EOF



chmod +x /opt/open-webui/start.sh



# 用 PM2 启动

pm2 start /opt/open-webui/start.sh --name open-webui --interpreter bash



pm2 list

pm2 logs open-webui

pm2 save

pm2 startup

^-^ 环境变量说明：

• RAG_EMBEDDING_ENGINE=openai：节省 200-400MB 内存


• ENABLE_MEMORIES=false：加快启动速度

更新方式（pip 版）

cd /opt/open-webui

source venv/bin/activate

pm2 stop open-webui



# 从 GitHub Release 更新（务必替换版本号！！！）

pip install https://github.com/ztx888/open-webui/releases/download/v0.7.3-7/open_webui_leon-0.7.3.post7-py3-none-any.whl



pm2 restart open-webui

pm2 logs open-webui

常用命令

pm2 status              # 查看状态

pm2 logs open-webui     # 查看日志

pm2 restart open-webui  # 重启服务

pm2 stop open-webui     # 停止服务

本镜像针对 ARM64 架构设备（如 Raspberry Pi 4/5、NVIDIA Jetson、Apple M1/M2/M3、部分 Android 盒子）提供了独立构建版本。

提醒：树莓派请尽量使用 64 位系统（aarch64），否则无法运行 arm64 镜像。

1、拉取镜像

ARM 架构使用独立构建标签，请使用带 -arm64 后缀的镜像标签：

docker pull ghcr.io/ztx888/openwebui:latest-arm64

2、启动容器（Docker CLI）

最简单的启动方式：

docker run -d \

  --name open-webui \

  --restart always \

  -p 3000:8080 \

  -v open-webui:/app/backend/data \

  ghcr.io/ztx888/openwebui:latest-arm64

启动后访问：

http://<你的设备IP>:3000

数据保存在 Docker Volume：

open-webui

3、使用 Docker Compose

如果你习惯用 docker-compose.yml 管理：

services:

  open-webui:

    image: ghcr.io/ztx888/openwebui:latest-arm64

    container_name: open-webui

    ports:

      - "3000:8080"

    volumes:

      - open-webui:/app/backend/data

    restart: always



volumes:

  open-webui:

启动命令：

docker compose up -d

^-^ 常见问题

• 为什么必须加 -arm64：
  
  本项目的 latest 标签仅包含 amd64 架构。ARM 设备（树莓派、Mac M 系列等）必须使用 latest-arm64 标签，否则会出现 no matching manifest for linux/arm64 等错误。


• Apple Silicon (M1/M2/M3) 用户说明：
  
  虽然 Docker Desktop 可能通过 Rosetta 模拟运行 amd64 镜像（通常更慢、占用更高），但建议使用 latest-arm64 以获得更好的原生性能与稳定性。


• 内存要求：
  
  建议至少 4GB RAM。2GB 内存设备可能遇到 OOM导致容器启动失败或运行缓慢


• 更新镜像：
  
  重新拉取并重启即可，命令如下：

docker pull ghcr.io/ztx888/openwebui:latest-arm64

docker restart open-webui