Open WebUI 安装与配置

下面是一篇详细指南,介绍如何在 OpenWrt 上通过 Docker 安装 OpenWebUI。请确保你的 OpenWrt 设备具备足够的硬件资源(如内存和存储)以及支持 Docker 功能(通常要求设备基于 x86 或性能较高的 ARM 平台)。


1 前言

OpenWrt 是一种轻量级、高度可定制的路由器固件。近年来,随着硬件性能的提升,一些高端路由器或嵌入式设备开始支持 Docker 容器化技术。本文介绍如何在 OpenWrt 上安装 Docker,并利用 Docker 部署 OpenWebUI,从而通过网页访问并管理你的设备或服务。


2 步骤 1:安装 Docker

2.1 更新软件包列表

首先,通过 SSH 登录 OpenWrt 设备,并执行以下命令更新 opkg 软件包列表:

opkg update

2.2 安装 Docker 软件包

根据 OpenWrt 版本,Docker 软件包的名称可能略有不同。一般来说,可以尝试安装以下包:

opkg install docker dockerd

如果系统中没有 docker-compose,可以根据需要安装:

opkg install docker-compose

2.3 启动 Docker 服务

安装完成后,启用并启动 Docker 服务:

/etc/init.d/dockerd enable
/etc/init.d/dockerd start

此时,Docker 服务应在默认端口(通常是 2375/2376 或内核支持的 Docker socket)上运行。


3 步骤 2:拉取 OpenWebUI 镜像

假设 OpenWebUI 镜像托管在 Docker Hub 上(镜像名称示例为 openwebui/openwebui:latest),使用以下命令拉取镜像:

docker pull ghcr.io/open-webui/open-webui:main

镜像下载完成后,你就可以使用该镜像创建容器了。


4 步骤 3:运行 OpenWebUI 容器

根据需要将容器内的端口映射到 OpenWrt 的外部端口。下面示例将容器内的 80 端口映射到 OpenWrt 的 8080 端口:

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

这样,容器内存储的数据会保存在 OpenWrt 上的 open-webui 目录中。


5 步骤 4:通过网页访问 OpenWebUI

容器运行成功后,在局域网内的任意设备上,通过浏览器访问:

http://192.168.10.1:8082

你将看到 OpenWebUI 的网页界面,可以按照提示进行配置和使用。


6 注意事项


7 总结

通过以上步骤,你可以在 OpenWrt 上安装 Docker,并使用 Docker 拉取和运行 OpenWebUI 镜像,从而实现通过网页访问该应用。此方案不仅利用了 Docker 的容器化优势,还能让你在轻量级 OpenWrt 环境中享受到现代化的网页管理界面,非常适合需要远程管理或自建私有云平台的场景。