如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可:
请先阅读并遵守:https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Open WebUI 是 AI 的家园,一个自托管的 AI 平台,它可扩展、功能丰富、用户友好,并且设计为完全离线运行。通过支持 Ollama 和 OpenAI 兼容 API,它为本地和云模型提供了强大的、与供应商无关的界面。
热衷于开源 AI?加入我们的团队 →
正在寻找企业版方案?– 立即联系我们的销售团队!
如需更多信息,请务必查看我们的 Open WebUI 文档。
想了解更多关于 Open WebUI 的功能?请查看我们的 Open WebUI 文档以获取全面概述!
请注意,在某些 Docker 环境中可能需要额外配置。如果遇到任何连接问题,可查阅 Open WebUI 文档中的详细指南获取帮助。
[!WARNING] 使用 Docker 安装 Open WebUI 时,请确保在 Docker 命令中包含
-v open-webui:/app/backend/data。此步骤至关重要,它能确保数据库正确挂载并防止数据丢失。
-v open-webui:/app/backend/data
如果希望使用包含 Ollama 或支持 CUDA 加速的 Open WebUI,建议使用我们标记为 :cuda 或 :ollama 的官方镜像。要启用 CUDA,必须在 Linux/WSL 系统上安装 Nvidia CUDA 容器工具包。
:cuda :ollama
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
要连接到其他服务器上的 Ollama,请将 OLLAMA_BASE_URL 更改为服务器的 URL:
docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda
docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
此安装方法使用一个包含 Open WebUI 和 Ollama 的单一容器镜像,可通过一条命令实现简化部署。根据您的硬件配置选择相应命令:
docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
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
这两条命令都能实现 Open WebUI 和 Ollama 的内置无缝安装,确保您能快速启动并运行所有组件。
安装完成后,可通过 http://localhost:3000 访问 Open WebUI。祝您使用愉快!😄
如果遇到连接问题,通常是因为WebUI Docker容器无法访问容器内的Ollama服务器(地址为127.0.0.1:或host.docker.internal:)。在Docker命令中使用--network=host标志可解决此问题。注意,端口会从3000更改为8080,因此访问链接为:http://localhost:8080。
docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main
请查看Open WebUI文档中的更新指南。
[!WARNING]
:dev分支包含最新的不稳定功能和变更。使用此分支需自行承担风险,因为它可能存在错误或功能不完整的情况。
如果您想尝试最新的前沿功能,并且可以接受偶尔的不稳定性,可以像这样使用:dev标签:
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --add-host=host.docker.internal:host-gateway --restart always ghcr.io/open-webui/open-webui:dev
如果您在离线环境中运行Open WebUI,可以将HF_HUB_OFFLINE环境变量设置为1,以阻止尝试从互联网下载模型。
export HF_HUB_OFFLINE=1
在Open WebUI文档中了解我们路线图上的即将推出的功能。
本项目包含采用多种许可证的代码。当前代码库包括根据Open WebUI许可证授权的组件(附加要求是保留“Open WebUI”品牌),以及根据其各自原始许可证授权的先前贡献。有关许可证变更的详细记录以及代码各部分的适用条款,请参阅LICENSE_HISTORY。有关完整和最新的许可详情,请参见LICENSE和LICENSE_HISTORY文件。
如果您有任何问题、建议或需要帮助,请提交issue或加入我们的Open WebUI ***社区与我们联系! 🤝
如果您认为发现了安全漏洞或不应公开披露的内容,请通过我们在GitHub上的负责任披露计划进行保密联系。我们仅通过GitHub接受报告,不通过任何其他平台。感谢您帮助我们保持Open WebUI的安全!
由Timothy Jaeryang Baek创建 - 让我们共同让Open WebUI变得更加出色! 💪
来自真实用户的反馈,见证轩辕镜像的优质服务