管理后台
第一个创建成功的账号会自动成为管理员，流程见 首次启动与第一个管理员。
管理员登录后，在右上角用户菜单进入 管理。
后台入口速查
Section titled “后台入口速查”| 你想做什么 | 先打开哪里 | 深入看 |
|---|---|---|
| 看全站状态、最近活动、任务事件 | 管理 -> 概览 | 本页 概览 |
| 创建用户、改角色、改配额、重置密码或 MFA | 管理 -> 用户 | 用户与团队 |
| 创建团队、归档或恢复团队空间 | 管理 -> 团队 | 用户与团队 |
| 决定文件真正存到哪里、迁移存储数据 | 管理 -> 存储策略 | 存储策略与策略组 |
| 接一种新的存储后端 | 管理 -> 存储策略 | 存储后端 |
| 把另一台 AsterDrive 接成存储后端 | 管理 -> 远程节点 | 远程节点 |
| 让不同用户或团队走不同存储路线 | 管理 -> 策略组 | 存储策略与策略组 |
| 接入 OIDC / OAuth2 / GitHub / QQ / Google / Microsoft 登录 | 管理 -> 外部认证 | 注册、登录与 SSO |
| 配通注册激活、找回密码等邮件 | 管理 -> 系统设置 -> 邮件投递 | 邮件投递 |
| 配置链接导入（离线下载）引擎 | 管理 -> 系统设置 -> 文件处理 | 离线下载 |
| 接入 OnlyOffice / Collabora 在线预览编辑 | 管理 -> 系统设置 -> 站点配置 -> 预览应用 | 预览与文件处理 |
| 查分享链接、停用异常分享 | 管理 -> 分享 | 本页 分享 |
| 查文件记录、Blob 位置和版本引用 | 管理 -> 文件 / 管理 -> 文件 Blob | 本页 文件与文件-blob |
| 看后台任务失败原因 | 管理 -> 任务 | 本页 任务 |
| 清理异常 WebDAV / WOPI 锁 | 管理 -> 锁 | 本页 锁 |
| 改注册、公开站点地址、回收站等运行规则 | 管理 -> 系统设置 | 系统设置 |
| 替换或魔改前端界面 | 部署侧 frontend-override/ | 自定义前端 |
| 查谁做了什么 | 管理 -> 审计日志 | 本页 审计日志 |
我们对管理后台的克制
Section titled “我们对管理后台的克制”AsterDrive 的管理后台故意做得不”全功能”。
我们的判断是：
- 常见的事点几下就行 —— 用户禁用、改配额、看审计、关注册，都不该需要先读文档
- 不常见的事 CLI 解决 —— 数据库迁移、批量改配置、灾难恢复，去 运维 CLI，不塞进 web 后台
- 危险的事写明后果 —— 强制删用户、清空回收站这种，按钮上明写”会删除什么”，不藏进二级菜单装”高级”
如果你觉得后台里某个常用动作”绕”，告诉我们——管理后台的迭代方向是 “管理员日常动作越来越短”，不是”功能堆得越来越多”。
先看全站当前状态时，进这里。
你会在这里看到：
- 用户总数、启用中用户、已禁用用户
- 文件数量、文件总容量、底层文件对象总量
- 分享数量
- 最近 7 天趋势
- 最近活动
- 最近后台任务事件
- 每日汇总
概览里的绝对时间会跟着你当前设置的展示时区走；最近 7 天趋势和每日汇总也按这个时区聚合。 如果关闭了审计日志，趋势和最近活动会明显变少，甚至显示为空；后台任务事件仍然会继续显示。
分享 页面会列出当前全站所有公开链接。
常见用法：
- 某条公开链接不该继续访问
- 某个分享已经不再需要
- 想统一检查目前还有哪些资料在对外公开
管理员可以直接在这里删除任意一条分享。用户视角的分享用法见 分享与协作。
文件与文件 Blob
Section titled “文件与文件 Blob”文件 和 文件 Blob 是给管理员排查存储问题用的可观测页面，不是普通文件管理器。
文件 页面按文件记录查看当前状态。你可以筛选和查看：
- 文件名、大小、MIME 类型和删除状态
- 所属用户、所属团队、当前策略和当前 Blob
- 当前 Blob 的哈希、存储路径和策略位置
- 这个文件的历史版本引用
文件 Blob 页面按底层对象查看。你可以筛选和查看：
- Blob 哈希、大小、策略 ID 和存储路径
- 引用计数
- 哪些当前文件引用了这个 Blob
- 哪些历史版本引用了这个 Blob
这两页适合用来回答这类问题：
- 某个文件现在实际落在哪条策略上
- 存储迁移后，文件记录是否已经指向目标策略
- 某个 Blob 还有没有当前文件或历史版本引用
doctor --deep或日志提示存储不一致时，先定位到具体文件、Blob 和策略
它们不会替代备份、迁移和修复工具。看见异常后，先确认现象和备份状态，再决定是否用 CLI 或后台迁移任务继续处理。
任务 页面会列出系统里已经记录下来的后台任务，包括系统周期任务、个人工作空间任务和团队任务。
你会在这里看到：
- 任务名称、类型、来源和状态
- 摘要行里的当前进度、最近活动时间和错误摘要
- 展开后的分步执行详情、耗时、检查点和重试信息
- 在线压缩、在线解压、打包下载和系统运行任务记录
- 存储策略数据迁移任务记录
- 缩略图生成、媒体元数据解析、压缩包预览生成任务记录
这个页面最适合做两类事：确认某个后台任务到底有没有在跑；看最近是不是有一批任务持续失败。 也可以按任务类型或状态筛选历史记录、条件清理已经结束的历史任务记录。清理历史任务只会处理已完成、失败或取消的记录；排队中、处理中、重试中的任务不会被删。
系统设置 -> 运行时 -> 任务保留时长 控制的是后台任务临时产物最多保留多久，例如打包下载结果、在线压缩输出、在线解压 staging 或链接导入临时文件。它不会自动删掉任务列表里的历史记录；历史记录需要管理员在任务页按条件清理。
存储策略数据迁移这类任务通常会有更长的分步详情。排查时先看摘要行判断是否失败，再展开任务看具体卡在预检查、复制、校验还是提交阶段。迁移结果里”已重命名 Opaque Key”的含义见 存储策略与策略组。
锁 页面适合处理卡住的锁。
最常见的场景：
- 某个文件一直显示被锁定
- WebDAV 客户端异常退出后没有释放锁
- WOPI 编辑器关闭异常，文件仍然被视为正在编辑
- 管理员想先清掉一批已过期的锁
你可以在这里查看当前锁路径、持有者和状态，清理过期锁，或强制解锁某一条锁。
AsterDrive 允许协议语义里的共享锁，所以同一个资源可能同时存在多条有效锁。不要看到多条锁就直接当成错误；真正需要处理的是已经过期、客户端异常退出后残留，或者明确阻止了后续操作的异常锁。对文件夹的移动、复制和删除也会递归检查子树锁，避免绕过子项锁直接改父目录。
审计日志 页面用于查看关键操作记录。
常见用途：
- 查谁删除了某个文件
- 查某个用户什么时候登录或修改过内容
- 排查分享、锁和团队管理相关问题
- 检查管理员操作是否按预期发生
主节点的服务启动和关闭也会写成审计事件，方便你追查实例什么时候上线、什么时候退出。 是否记录审计日志、记录哪些操作，以及日志保留多久，都由系统设置控制。
关于 页面会显示当前部署版本、许可证、仓库和文档入口。
排查”现在到底跑的是哪个版本”时，先看这里。
管理员日常检查清单
Section titled “管理员日常检查清单”建议定期确认下面几项：
公开站点地址是否仍然指向真实 HTTP(S) 来源；多个公开入口逐项添加- 默认存储策略和默认策略组是否仍然可用
- 用户和团队绑定的策略组是否符合当前使用方式
- 如果接了从节点，远程节点最近测试状态是否正常
- 回收站、历史版本、任务产物和团队归档保留时间是否符合当前容量
- 测试邮件是否还能正常发出
- 是否存在不该继续公开的分享链接
- 是否有长期失败或卡住的后台任务
- 是否有长期未释放的锁
- 审计日志是否开启，保留时间是否足够