维护和运行状态

重新加载 Drive

新增、编辑、删除或重新授权 Drive 后，点击“管理员 → 盘”顶部的“重新加载盘”。保存只是更新数据库配置，重新加载才会替换运行中的 Drive 实例。

重新加载失败时检查错误日志和对应远端凭据。不要反复保存 Secret 占位值；密码字段会使用隐藏占位符保护已有密钥。

清除 Drive 缓存

在“管理员 → 其他 → 清除缓存”选择 Drive。适用于：

• 文件由远端系统直接修改。
• OneDrive/Google Drive/S3 等返回陈旧目录项。
• 更改 cache_ttl 后需要立即刷新。

清缓存不会删除真实文件。

清理无效权限和挂载

删除 Drive 或外部移动目录后，数据库中可能留下指向不存在路径的权限和挂载。“清理无效的权限项/挂载项”会删除这些记录。操作前建议备份数据库，因为它是持久化修改。

搜索索引维护

搜索页可以按路径创建索引任务、查看进度和中止任务。Drive 结构变化或外部修改后应重新索引相关路径，详见搜索与索引。

系统状态

“管理员 → 状态”显示版本和运行时统计，用于确认实际运行版本及资源使用情况。排障报告至少包含：

• go-drive 版本和构建修订。
• Docker/二进制及操作系统架构。
• 数据库类型。
• 问题涉及的 Drive 类型。
• 已隐藏凭据的相关配置。
• 同一时间段的后端日志。

设置 GO_DRIVE_DEBUG=1 可临时增加调试信息。问题解决后关闭调试模式。

日常维护建议

• 定期验证备份恢复。
• 在 OAuth Client Secret 到期前轮换。
• 检查 LDAP 和 S3 服务账号权限。
• 监控数据目录、临时目录和数据库容量。
• 清理不再使用的脚本 Drive、任务执行记录和缩略图缓存。
• 升级前阅读 release notes 并保留可回滚备份。