Operations

日常运维命令与流程。

服务状态

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

重启

组件	命令
Open WebUI	cd /root/openwebui && docker compose restart
LiteLLM（改配置后）	bash /root/litellm/operation.sh
Nginx	sudo 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，若有则迁移到 env 文件并轮换

监控建议（可选）

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