AWS CLI list-extensions 实战指南：列出并解析 AppConfig 扩展（Extensions）
2026/9/14 13:53:26
Open WebUI 本地部署：5 分钟跑通容器 + 模型接入实操
【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui
Open WebUI 是一个能完全离线运行的自托管 AI 平台，把 Ollama 的本地模型或任何 OpenAI 兼容 API 接进网页界面里聊天。本文覆盖四步：跑起容器、接入你的模型、调出常用功能、稳住长期运行。
跑通最小环境：一条 Docker 命令部署 Open WebUI
这条命令会拉取 Open WebUI 镜像并启动容器，把服务端口映射到主机的 3000，数据存进命名卷，容器挂了自动拉起。
docker run -d \ -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main参数逐个拆开看：
| 参数 | 作用 | 为什么需要 |
|---|---|---|
-p 3000:8080 | 容器 8080 映射到主机 3000 | 8080 是容器内服务监听端口，用 3000 避免和主机上已有服务撞车 |
--add-host=host.docker.internal:host-gateway | 让容器里的host.docker.internal指向宿主机 | 容器默认网络访问不到宿主机的 Ollama，靠这个主机名兜住 |
-v open-webui:/app/backend/data | 挂载数据卷到容器数据目录 | 数据库、上传文件都在这个目录，不挂载就随容器删除而丢 |
--restart always | 容器退出后自动重启 | 宿主机重启或进程崩溃后服务自己回来 |
ghcr.io/open-webui/open-webui:main | 稳定版镜像 | :cuda是 GPU 加速变体，:ollama内嵌了 Ollama |
📌跑通标志，满足下面三点就算部署成功：
docker ps里容器状态是Up- 浏览器打开
http://localhost:3000，出现登录/注册界面 - 第一个注册的账号自动成为管理员，能进入后台管理页
GPU 加速部署
机器上有 NVIDIA 卡的话，只改两处：给容器加--gpus all开放全部 GPU，镜像换成:cuda标签。前提是你已经在宿主机装好 NVIDIA Container Toolkit，验证命令是docker run --rm --gpus all nvidia/cuda:12.4.1-base-ubuntu22.04 nvidia-smi能列出显卡。
接入你的模型：本地、远程与第三方 API
模型接入有三种场景，选一个对应你 Ollama 或 API 的位置即可。
本地直连：Ollama 装在同一台机器
基础命令里的--add-host参数就是为这个场景准备的，容器会通过host.docker.internal:11434找到宿主机的 Ollama。如果这台机器还没装 Ollama，更省事的做法是用:ollama标签镜像，它把 Ollama 和 Open WebUI 打包在一个容器里：
docker run -d \ -p 3000:8080 \ -v ollama:/root/.ollama \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:ollama确认接上了：进管理页的 Models 里点 "Ollama" 连接，执行ollama pull llama3.2拉个模型，右上角模型列表里出现它并能发起对话。
远程服务：OLLAMA_BASE_URL 指向另一台机器
Ollama 部署在别的服务器上时，用OLLAMA_BASE_URL环境变量指过去：
docker run -d \ -p 3000:8080 \ -e OLLAMA_BASE_URL=http://192.168.1.50:11434 \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main要同时挂多台 Ollama，改用OLLAMA_BASE_URLS，多个地址用分号分隔。确认接上了：管理页连接测试通过，远程服务器上的模型全部出现在列表里。
第三方 API：任意 OpenAI 兼容接口
LMStudio、vLLM、GroqCloud、OpenRouter 这类服务，都按 OpenAI 兼容格式接：
docker run -d \ -p 3000:8080 \ -e OPENAI_API_BASE_URL=https://api.groq.com/openai/v1 \ -e OPENAI_API_KEY=your_key \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main接上之后也能在 设置 → External Interfaces 里增删密钥，不用重建容器。确认接上了：Settings 里对应连接显示已连通，模型列表出现该服务商的模型。
支持的后端和连接方式汇总：
| 服务 | 连接方式 | 典型场景 |
|---|---|---|
| Ollama | 自动发现，或OLLAMA_BASE_URL | 本地跑开源模型 |
| LMStudio | OPENAI_API_BASE_URL指向http://127.0.0.1:1234/v1 | 桌面端临时测模型 |
| vLLM | OPENAI_API_BASE_URL兼容接入 | 批量推理、高吞吐 |
| GroqCloud / OpenRouter | OPENAI_API_BASE_URL+OPENAI_API_KEY | 高速云端推理、多模型切换 |
| OpenAI 官方 | OPENAI_API_KEY | 直接走官方接口 |
调出常用功能：权限、插件、频道与定时任务
配置管理员账号与角色
第一个注册的账号就是管理员。想让管理员账号在启动时就固定下来，加三个环境变量：
-e WEBUI_ADMIN_USERNAME=admin \ -e WEBUI_ADMIN_PASSWORD=ChangeMe123! \ -e DEFAULT_USER_ROLE=pending第三个参数控制新注册用户的默认角色，pending表示待批准，管理员在用户管理页逐个放行。
| 角色 | 可做的事 | 典型使用者 |
|---|---|---|
| admin | 管理用户、模型、全局设置，查看所有会话 | 自托管运维者 |
| user | 聊天、上传文件、创建工具与频道 | 日常使用者 |
| pending | 登录后等待审批，无法使用功能 | 新注册未批准的账号 |
装插件：Tools 和 Pipes
插件分 Filters、Tools、Pipes、Skills 几类，覆盖消息改写、外部工具调用、数据管道。进 Tools 页面，社区市场里直接点安装，然后分配给某个模型即可生效。想自己写一个，最小骨架如下，改消息内容后原样返回：
async def pipe(message: str, history: list, **kwargs) -> str: if "urgent" in message: message = "[优先处理] " + message return message适用场景：给消息自动打标、统一加前缀、按规则改写提示词。更多接入方式（MCP、OpenAPI 工具服务器）在 后端源码 的utils/mcp/目录能看到实现。
开协作频道：人和 AI 同一个时间线
Channels 是团队共享的实时讨论区，把模型拉进来后，人和模型在同一条时间线里回复，支持线程、表情反应、置顶。适合几个人一起评审同一份文档，让模型逐条点评的场景。
设定时任务：Automations
Automations 让提示词按固定周期自动执行，每次运行记录在日历上，点进去能跳回那次运行产生的完整会话。适合每天早上自动汇总、周期性生成报告这类活。
稳住运行：调优参数、健康检查与备份
参数别全调，默认值对单机小团队够用。这五个是实际会动的：
| 配置项 | 推荐值 | 调整依据 |
|---|---|---|
WEBUI_SECRET_KEY | 随机长字符串（≥32 位） | 启用认证后是硬要求，丢了无法解密已有会话 |
THREAD_POOL_SIZE | CPU 核数 × 2 | 后端处理并发请求的线程池，多人同时聊再往上加 |
MODELS_CACHE_TTL | 默认 1 秒，模型少可设 30 | 模型列表的缓存刷新周期，模型不常变就调大 |
HF_HUB_OFFLINE | 完全离线环境设1 | 阻止启动时尝试从外网拉模型，避免卡住 |
REDIS_URL | 多实例部署必填 | 跨实例共享会话和 WebSocket 消息 |
健康检查加自动重启，一条命令带上--health-cmd，容器内部每 30 秒自检一次：
docker run -d \ -p 3000:8080 \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ --health-cmd "curl -f http://localhost:8080/health || exit 1" \ --health-interval 30s \ --health-timeout 10s \ --health-retries 3 \ ghcr.io/open-webui/open-webui:main备份脚本直接拷走，把数据卷打包成 tar，恢复时反向解到/app/backend/data即可：
#!/bin/bash DEST=owui-$(date +%F).tar docker run --rm \ -v open-webui:/data \ -v /backups:/backup \ alpine sh -c "tar -cf /backup/$DEST -C /data ." ls -lh /backups数据卷里是 SQLite 数据库加上传文件，日常体积不大，每天备一份足够。
排掉高频坑：5 个最常见的问题
| 症状 | 大概率原因 | 解法 |
|---|---|---|
| 页面打不开 | 主机 3000 端口被占 | docker ps确认容器是 Up，否则把-p改成空闲端口 |
| 模型列表是空的 | 容器连不上 Ollama | 检查有没有--add-host=host.docker.internal:host-gateway，或直接设OLLAMA_BASE_URL |
| 重启后数据没了 | 启动时漏挂数据卷 | 带-v open-webui:/app/backend/data重新跑，旧数据如果没备份找不回来 |
| 新账号登录进不去 | DEFAULT_USER_ROLE=pending还没批准 | 管理员进用户管理页点批准，或直接注册第一个账号当管理员 |
| 多人用一段时间后连接断开 | 多实例但没配 Redis | 单机部署别开多实例；要水平扩展就配REDIS_URL |
三个容易踩的坑，对比着看：
❌-p 8080:8080宿主机容器同端口映射，主机上已有服务占 8080 时直接起不来 ✅-p 3000:8080内外端口分开，互不干扰
❌ 重建容器时每次重新生成WEBUI_SECRET_KEY✅ 固定值写进.env文件复用，否则每次重建老会话全部失效，用户得重新登录
❌ 图新把镜像切成:dev标签 ✅ 生产固定在:main稳定标签，看完 release 说明再升级
排查时先拉日志，八成问题直接看得见：
docker logs -f --tail 100 open-webui想进一步定制，仓库里的 部署配置 给了带 Ollama 的双容器编排，环境变量全在 后端源码 里能查到默认值。
自检与延伸
部署完成前，逐项过一遍：
- ✅
docker ps状态显示Up，容器没有反复重启 - ✅ 浏览器打开
http://localhost:3000，首个账号登录成功且角色为 admin - ✅ 模型列表至少有一个模型，发一句消息能收到回复
- ✅ 删一条聊天记录，重启容器后再删一条，历史数据都还在
- ✅ 跑一次上面的备份脚本，
/backups里出现非零大小的 tar 包 - ✅ 删掉容器再重建（带同样参数），老账号密码还能登录，说明数据卷生效
延伸方向：
- 多实例扩展：加 Redis 共享会话，数据库换 PostgreSQL，前面挂负载均衡
- 主题定制：改
static/custom.css和 Logo，管理页的品牌设置里也能换名 - API 集成：管理、聊天、知识库都有 REST 接口，可以直接写脚本自动化
卡住的时候先拉日志，再对照环境变量逐项核对，多数问题这两步就能定位。
【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考