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。改配置时同步更新相关章节,避免与生产漂移。