维护和运行状态

重新加载存储配置

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

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

清除存储缓存

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

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

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

清理无效权限和挂载

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

搜索索引维护

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

系统状态

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

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

设置 GO_DRIVE_LOGGING_LEVEL=debug 可临时增加调试日志。问题解决后移除该环境变量。

日常维护建议

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