Skip to main content
Version: Current

Operations

日常运维命令与流程。本文档更新没有修改运行中的 Docker / systemd。

运行形态​

容器启动方式当前 restart说明
openwebui/root/openwebui 的 Composeunless-stopped宿主机重启后一般会自己起来
litellm/root/litellm/operation.sh 的 docker runno宿主机或 Docker 重启后需再跑 operation.sh

服务器重启后先 docker ps --filter name=openwebui --filter name=litellm。若只有 Open WebUI：bash /root/litellm/operation.sh。长期修复应在脚本里加 --restart unless-stopped（维护窗口操作，本次不改脚本）。

服务状态​

docker ps --filter name=openwebui --filter name=litellm
sudo systemctl status nginx

重启​

组件命令
Open WebUIcd /root/openwebui && docker compose restart
LiteLLM（改配置后）bash /root/litellm/operation.sh
Nginxsudo systemctl reload nginx

改 api_keys.env 或 config.yaml 后，对 LiteLLM 使用 operation.sh 重建，不要只 docker restart（环境变量以 recreate 为准）。

日志​

docker logs openwebui --tail 200 -f
docker logs litellm --tail 200 -f
sudo tail -f /var/log/nginx/error.log

备份上传日志：/root/infra-backup/logs/rclone-upload-*.log

备份​

Open WebUI 卷：

/root/infra-backup/backup/openwebui.sh

一键全量（含其它服务，若启用）：

/root/infra-backup/backup/run-all.sh

Cron 示例见 /root/infra-backup/README.md。

保留策略（摘要）​

层级策略
本地 staging约 3 天（utils/lib.sh LOCAL_RETENTION_DAYS）
远端 openwebui tar保留最近 3 个（OPENWEBUI_KEEP_LAST）
R2 生命周期建议在控制台对 archive/ 配置约 7 天

恢复​

详见：

  • /root/infra-backup/docs/runbook-restore.md
  • /root/infra-backup/restore/openwebui.sh

恢复前 停止 openwebui 容器，避免 SQLite 损坏。

升级​

  1. 备份
  2. docker compose pull / 更新 LiteLLM 镜像 tag
  3. operation.sh 或 compose up -d
  4. 冒烟测试：登录、流式对话、模型列表

API 充值与账单​

各模型厂商控制台均使用 bucssatech@gmail.com 登录；充值、付款方式、余额查询的分厂商步骤见 API 充值与账单。

轮换 API Key 后记得更新 /root/litellm/api_keys.env 并运行 operation.sh。

安全运维​

  • 定期轮换 api_keys.env 中厂商 Key
  • chmod 600 敏感文件
  • 勿将 api_keys.env、rclone.conf、Resend Key 提交 Git
  • 检查 docker-compose.yml 是否仍含明文 Key。若有：迁到 chmod 600 的 env 文件、从 Compose 删掉、在厂商控制台轮换该 Key（维护窗口；本次文档未改生产文件）

监控建议（可选）​

  • Uptime：HTTPS 首页 + 127.0.0.1:4001/
  • 磁盘：/var/lib/infra-backup/staging 与 Docker 卷
  • 备份：run-all.sh 失败邮件或检查 rclone 日志