ubuntu docker拉取open webui

### 如何在 Ubuntu 上通过 Docker 拉取 Open WebUI 镜像 要在 Ubuntu 系统上通过 Docker 拉取 Open WebUI 的镜像，可以按照以下方法操作： #### 1. 更新系统包列表 为了确保系统的软件包是最新的，在执行任何其他命令之前，建议先更新系统的包列表。可以通过以下命令完成此操作： ```bash sudo apt-get update && sudo apt upgrade -y ``` 这一步有助于避免因依赖项版本不匹配而导致的问题[^1]。 #### 2. 安装并启动 Docker 如果尚未安装 Docker，则需要先安装它。以下是安装 Docker 的简单步骤： ```bash curl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER newgrp docker ``` 完成后，验证 Docker 是否正常工作： ```bash docker --version ``` #### 3. 拉取 Open WebUI 镜像 要拉取 Open WebUI 的官方镜像，可以直接使用 `docker pull` 命令指定镜像名称和标签。对于 Open WebUI 和 Ollama 的集成版，通常使用的镜像是 `ghcr.io/open-webui/open-webui:ollama` 或者 CUDA 加速版本的镜像 `ghcr.io/open-webui/open-webui:cuda`[^3]。 具体命令如下： ```bash docker pull ghcr.io/open-webui/open-webui:ollama ``` 或者如果你希望使用支持 GPU 的 CUDA 版本： ```bash docker pull ghcr.io/open-webui/open-webui:cuda ``` #### 4. 启动容器 成功拉取镜像后，可以通过 `docker run` 命令来启动容器。下面是一个典型的运行参数示例，适用于大多数场景： ```bash docker run -d \ -p 3000:8080 \ --gpus all \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:ollama ``` 解释各参数的作用： - `-d`: 表示以后台模式运行容器。 - `-p 3000:8080`: 将主机端口 3000 映射到容器内的 8080 端口。 - `--gpus all`: 如果有 NVIDIA GPU 设备，启用全部 GPU 支持。 - `-v open-webui:/app/backend/data`: 创建一个名为 `open-webui` 的数据卷用于持久化存储。 - `--name open-webui`: 设置容器的名字为 `open-webui`。 - `--restart always`: 当 Docker 主机重启时自动重新启动该容器。 - `ghcr.io/open-webui/open-webui:ollama`: 要运行的具体镜像及其标签。 #### 5. 验证容器状态 最后，确认容器是否已成功启动并处于运行状态： ```bash docker ps ``` 你应该能看到类似于以下输出的内容： ``` CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 984c0d7006ef ghcr.io/open-webui/open-webui:ollama "bash start.sh" 5 minutes ago Up 5 minutes 0.0.0.0:3000->8080/tcp, :::3000->8080/tcp open-webui ``` 这意味着服务已经在本地监听端口 3000 并可访问[^2]。 --- ### 注意事项 - 如果遇到权限问题，请尝试在相关命令前加上 `sudo`。 - 对于 GPU 支持，需提前安装好 NVIDIA Container Toolkit 及驱动程序。 - 若网络较慢或无法连接至 GHCR (GitHub Container Registry)，可能需要调整代理设置或更换国内源地址。