📋 常见问题
💡 为什么选择 Docker?
我们理解并非所有人都偏好使用 Docker;然而,这种方式对于我们项目的设计和运营效率至关重要。我们认为项目对 Docker 的承诺是其核心方面,并鼓励那些寻找不同部署方式的人探索由社区驱动的替代方案。
问: 如何定制 logo 和品牌标识?
答: 您可以通过我们的 企业版授权 定制主题、logo 和品牌标识,从而解锁独特的企业功能。
有关企业解决方案和品牌定制的更多详情,请联系我们的销售团队:📧 [email protected]
问: 为什么需要注册?我的数据会被传送到哪里?
答: 我们要求您注册为管理员用户以增强安全性。这确保了如果 Open WebUI 暴露给外部访问,您的数据仍然安全。需要注意的是,所有数据都保持在本地。我们不会收集您的数据。当您注册时,所有信息都保存在您的服务器中,绝不会离开您的设备。您的隐私和安全是我们最优先考虑的事项,确保您的数据始终处于您的控制之下。
问: 为什么我的 Docker 容器无法通过 localhost
连接到主机上的服务?
答: 在 Docker 容器内,localhost
是 指容器本身,而不是主机。这种区别对于网络连接来说至关重要。要从容器连接到主机上的服务,您应该使用 DNS 名称 host.docker.internal
而不是 localhost
。此 DNS 名称是 Docker 特别识别的,用于促进这种连接,从而有效地将主机视为容器内可访问的实体,绕过通常的 localhost
作用范围限制。
问: 如何让主机上的服务对 Docker 容器可访问?
答: 如果希望主机上的服务对 Docker 容器可访问,请配置这些服务监听所有网络接口,使用 IP 地址 0.0.0.0
而不是仅限于 127.0.0.1
的 localhost
。此配置允许服务接受来自任何 IP 地址的连接,包括 Docker 容器。尤其是在存在潜在外部访问的环境中,需注意这种设置的安全影响。实施适当的安全措施,例如防火墙和身份验证,可以帮助降低风险。
问: 为什么我的 Open WebUI 没有更新?我已经重新拉取/重启容器,但没有变化。
答: 更新 Open WebUI 不仅仅是拉取新的 Docker 镜像。以下是可能导致您的更新未显示的原因以及确保更新有效的方法:
- 更新 Docker 镜像: 使用命令
docker pull ghcr.io/open-webui/open-webui:main
更新 Docker 镜像,但这并不会更新正在运行的容器或其数据。 - Docker 卷中的持久数据: Docker 卷独立于容器生命周期存储数据,通过更新保留您的数据(例如聊天记录)。
- 应用更新: 确保更新生效的方法是删除现有容器(这不会删除数据卷),并使用更新的镜像和现有卷创建新容器。
这一过程可以更新应用程序,同时保持您的数据安全。
问: 等等,我为什么要删除我的容器?删除后我的数据会丢失吗?
答: 这是一个常见的顾虑,但只要您正确使用 Docker 卷,删除容器并不会导致数据丢失。原因如下:
- 卷保留数据: Docker 卷旨在将数据持久化于容器生命周期之外。只要您的数据存储在卷中,它将保持完整,不受容器操作的影响。
- 安全更新过程: 在更新 Open WebUI 时,删除旧容器并使用更新的镜像创建新容器不会影响存储在卷中的数据。关键是不要通过类似
docker volume rm
的命令明确删除卷。
通过正确的更新步骤——拉取新镜像、删除旧容器但不删除卷,以及使用更新的镜像和现有卷创建新容器——您的应用程序代码会得到更新,同时您的数据保持不变和安全。
问: 我应该使用发行版内置的 Docker 还是官方 Docker 包?
A: 我们推荐使用官方 Docker 包,而不是分发版的 Docker 包来运行 Open WebUI。官方 Docker 包会频繁更新,提供最新的功能、错误修复和安全补丁,以确保最佳性能和安全性。此外,它支持像 host.docker.internal
这样的重要功能,而这些功能可能在分发版中不可用。此功能对于 Docker 容器内的网络配置和连接至关重要。
选择官方 Docker 包,您可以在不同环境中获得一致的行为、更可靠的故障排除支持,以及获取 Docker 最新技术的机会。更广泛的 Docker 社区和资源也更贴合官方包,为您提供丰富的信息和支持,以解决遇到的问题。
运行 Open WebUI 所需的一切,包括数据,都在您的控制和服务器环境内,强调了我们对隐私和安全的承诺。有关安装官方 Docker 包的说明,请参考 Docker 官方文档站点上的 安装 Docker 引擎 指南。
Q: Docker 是否支持 GPU?
A: Docker 中提供了 GPU 支持,但支持情况因平台而异。官方支持的 GPU 功能在 Windows 平台的 Docker 和 Linux 平台的 Docker Engine 中可用。其他平台,例如 Linux 和 MacOS 上的 Docker Desktop,目前尚不支持 GPU。这一限制对于需要 GPU 加速的应用程序来说至关重要。为获得最佳体验并使用 GPU 功能,我们建议在官方支持 GPU 集成的平台上使用 Docker。
Q: 为什么 Open WebUI 强调使用 Docker?
A: 使用 Docker 的决定源于其能够确保一致性、隔离依赖关系,并简化不同环境下的部署。Docker 最大程度地减少了兼容性问题,并简化了启动 WebUI 的流程,无论底层系统如何。这是项目维护者的战略选择,利用这些优势,同时承认 Docker 具有一定的学习曲线,但在部署和维护方面的优势显著。我们理解并非所有人都偏好 Docker;然而,这种方法是我们项目设计和运行效率的核心。我们将项目对 Docker 的承诺视为一个基本方面,并鼓励那些寻找不同部署方法的人探索社区驱动的替代方案。