Skip to main content
Version: Current

FAQ

CSSA GPT 和 Open WebUI 是什么关系?

CSSA GPT 是服务名称;界面与账号系统由 Open WebUI 提供,模型调用经 LiteLLM 转发。

为什么不用 LiteLLM 数据库?

当前只用 LiteLLM 做 无状态 API 网关。用户、聊天记录在 Open WebUI 的 SQLite 卷里。不需要 LiteLLM 的虚拟 Key、团队预算等功能时,无 DB 最省事。

数据存在哪里?会丢吗?

  • 对话与设置:Docker 卷 openwebui_openwebui-data
  • 定期备份:infra-backup → Cloudflare R2

删除卷或未备份就 docker volume rm 会丢数据。

API 余额不足 / 欠费怎么充值?

各厂商统一用 bucssatech@gmail.com 登录对应官网充值,步骤见 API 充值与账单。充值后若仍报错,检查是否需更新 api_keys.env 并执行 bash /root/litellm/operation.sh

如何新增一个模型?

编辑 /root/litellm/config.yaml 和(如需)api_keys.env,执行 bash /root/litellm/operation.sh,在 Open WebUI 刷新模型列表。

LiteLLM 需要对外暴露吗?

不需要。只给本机 Open WebUI 用,监听 127.0.0.1:4001 即可。

忘记管理员密码怎么办?

按 Open WebUI 官方文档重置(通常涉及卷内数据库或 CLI)。操作前先做备份。

备份存在哪?

R2 bucket(脚本中常为 openwebui),路径前缀 archive/,文件名形如 openwebui-YYYY-MM-DD.tar.gz。细节见 /root/infra-backup/README.md

流式回复在手机上正常、电脑上异常?

多为浏览器插件或公司代理缓冲;换浏览器或无痕模式试。服务端先确认 Nginx proxy_buffering off

能否接入本地 Ollama?

可以。在 LiteLLM model_list 增加 Ollama 项,或在 Open WebUI 单独添加 Ollama 连接。当前生产未部署 Ollama。

文档在哪更新?

本站 docs/systems/cssagpt。改配置时同步更新相关章节,避免与生产漂移。