已集成懒猫 oidc 登录。 Silo 是一个私有 SQL 备份管理器，用来集中保存、校验、下载和分享数据库备份文件。它适合把多台服务器、多个业务数据库的 `.sql` 或 `.sql.gz` 备份统一收集到懒猫微服中，并通过网页或 API 管理备份记录、访问凭据和审计日志。 Silo 不直接连接数据库执行备份，也不提供一键恢复数据库功能。推荐做法是由你的数据库服务器、CI 任务、定时脚本或自动化平台生成 SQL dump，然后上传到 Silo；需要恢复时，从 Silo 下载备份文件，再用对应数据库工具恢复。 ## 主要用途 - 集中保存 PostgreSQL、MySQL、MariaDB 等数据库导出的 SQL 备份文件。 - 按数据库项目分类管理备份。 - 为不同数据库生成独立上传凭据，方便 CI、定时任务或脚本自动上传。 - 校验备份文件类型、大小、SHA256 和重复上传。 - 设置每个数据库的备份保留数量或保留天数。 - 下载备份文件，或生成短期有效的签名分享链接。 - 查看上传、下载、删除、凭据使用等操作记录。 - 管理用户、角色和管理员审计日志。 ## 首次使用 1. 在懒猫微服中安装并打开 Silo。 2. 首次进入时，页面会提示创建第一个管理员。 3. 推荐点击 `Create admin with Lazycat`，使用懒猫账户创建管理员并登录。 4. 如果需要，也可以手动输入用户名和密码创建第一个管理员。 5. 第一个账户会自动成为超级管理员，之后注册入口会关闭，其他用户需要由管理员创建。 ## 基本使用流程 ### 1. 创建数据库项目 进入左侧 `Databases` 页面，点击右上角 `New database`。 填写： - `Name`：数据库项目名称，例如 `production-blog`、`crm-main`。 - `Description`：可选说明，用来标记业务系统、环境或负责人。 - `Retention`：可选保留策略。 保留策略支持两种维度： - `Keep last N backups`：只保留最近 N 个备份。 - `Keep backups for N days`：只保留最近 N 天内的备份。 两个条件可以同时设置，任一条件触发时，旧备份会被清理。留空表示不限制该维度。 ### 2. 手动上传备份 进入左侧 `Backups` 页面： 1. 在右上角选择要上传到哪个数据库项目。 2. 点击上传按钮，选择 `.sql` 或 `.sql.gz` 文件。 3. 也可以把文件直接拖到页面中的上传区域。 4. 上传完成后，列表会显示文件名、类型、大小、上传时间和 SHA256。 Silo 会检查： - 文件扩展名必须是 `.sql` 或 `.sql.gz`。 - 文件内容需要像真实 SQL dump。 - 默认最大上传大小为 2 GB。 - 同一数据库短时间内重复上传相同 SHA256 会被拒绝。 ### 3. 为自动上传创建凭据 如果希望服务器脚本、CI 或自动化任务定时上传备份，需要给对应数据库创建上传凭据。 在 `Databases` 页面，点击某个数据库右侧的钥匙图标，进入 `API credentials`。 点击 `New credential` 后填写： - `Name`：凭据名称，例如 `nightly-pg-dump`。 - `Expires`：有效期，可选择 30 天、90 天、365 天或无限期。 - `IP allowlist`：可选，只允许指定 IP 或 CIDR 使用该凭据。 创建后会显示： - `client_id` - `client_secret` `client_secret` 只显示一次。请立即保存到 CI Secret、服务器环境变量或密码管理器中，关闭弹窗后无法再次查看。