Open WebUI容器重启后OLLAMA_BASE_URL配置失效问题分析

在Open WebUI项目使用Docker部署时，用户报告了一个关于OLLAMA_BASE_URL环境变量配置的异常行为。该问题表现为：当通过环境变量设置OLLAMA_BASE_URL后，容器重启时该配置未能正确保留，导致服务连接异常。

问题现象

用户在Docker Compose配置中明确设置了环境变量OLLAMA_BASE_URL: "http://ollama:11434"，期望Open WebUI能够通过该地址连接到Ollama服务。初次启动时，系统确实能够识别并使用该配置。然而，当容器重启后，该设置会自动恢复为默认值host.docker.internal，导致服务连接失败。

技术背景

Open WebUI是一个基于Web的界面，用于与Ollama模型交互。在Docker环境中部署时，通常需要配置多个容器协同工作：

1. Ollama容器：运行AI模型服务，默认监听11434端口
2. Open WebUI容器：提供用户界面，需要配置正确的Ollama服务地址
3. Traefik容器：作为反向代理，管理服务路由

问题根源

经过分析，该问题的根本原因在于Open WebUI的配置持久化机制。虽然环境变量OLLAMA_BASE_URL可以在初次启动时生效，但该配置被标记为PersistentConfig类型。这意味着：

1. 初次启动时，系统会读取环境变量并存入数据库
2. 后续启动时，系统优先从数据库读取配置，而非环境变量
3. 如果数据库中存在该配置，环境变量的设置将被忽略

解决方案

针对这一问题，开发者可以考虑以下几种解决方案：

1. 使用OLLAMA_BASE_URLS替代：该环境变量未被标记为持久化配置，可以确保每次启动都从环境变量读取
2. 手动修改数据库配置：通过UI界面或直接操作数据库文件，永久修改该设置
3. 清除持久化数据：删除volume中的数据文件，强制系统重新从环境变量初始化

最佳实践建议

对于生产环境部署，建议：

1. 明确区分临时配置和持久化配置的需求
2. 对于关键服务地址，考虑使用不会被持久化的环境变量
3. 在容器编排文件中添加注释，说明配置的持久化特性
4. 实施配置验证机制，确保服务启动时配置正确

总结

这个案例展示了在容器化环境中配置管理的重要性。开发者需要理解应用配置的完整生命周期，包括初始化、持久化和覆盖机制。Open WebUI项目通过区分持久化和非持久化配置，为用户提供了灵活的配置方式，但也要求部署者对这一机制有清晰的认识。

对于类似问题，建议开发者仔细阅读项目文档中关于环境变量的说明，特别是关于配置持久化的部分，以确保部署时能够正确设置各项参数。