管理后台
2026/11/17大约 6 分钟约 1699 字
管理后台
管理员登录后侧栏出现「管理后台」。七个页签:概览、用户、举报审核、申诉审核、意见反馈、审计日志、系统设置。

概览
- 运行状态:版本、运行时长、数据库类型与当前模式(主库 / 降级 SQLite)。
- 存储:总容量、已用、文件数与用户数,条状图看占用比例。
- 最近操作:最新几条审计记录,点进去可到完整日志。
- 占用排行:谁用得最多,方便找超额用户。
用户管理

列表带搜索与分页,每行可以:
| 操作 | 说明 |
|---|---|
| 调整配额 | 单独设 GB 数,改完立即生效(已超额的部分不会被删) |
| 封禁 / 解封 | 封禁时要填原因并选时长(1 / 3 / 7 / 30 天或永久)。在线的用户会立刻看到封禁弹窗(原因、封禁时间、解封时间、去申诉),不在线的下次登录会被带到申诉页;到期自动解封 |
| 重置密码 | 生成新密码,用户下次登录用新密码;不会发邮件 |
| 设置角色 | 普通用户 / 管理员 / 超级管理员(只有超管能操作) |
| 级联删除 | 删账号连同其全部文件、分享、回收站记录;需要二次确认 |
角色与权限
| 角色 | 怎么来的 | 能做什么 |
|---|---|---|
| 普通用户 | 自己注册 | 自己的文件、分享、快传 |
| 管理员 | 超管在用户页设置 | 进管理后台、看用户与审计日志、调配额 / 重置密码 / 封禁、改系统设置 |
| 超级管理员 | 第一个注册的账号自动成为;超管也能再提别人 | 管理员的一切 + 增减管理员、设置或取消超管 |
默认限制(都是服务端拦截,绕过界面直接调接口也一样):
- 普通管理员不能把任何人设为管理员,也不能取消别人的管理员;
- 普通管理员不能取消超管,也不能把超管降成普通用户;
- 超管的密码重置、封禁、删除对普通管理员一律不可用(防止接管超管账号);
- 超管不能取消自己、不能把自己降级——避免管理员列表里一个能管的人都不剩;
- 一个超管想退回普通用户,得由另一个超管先取消他的超管身份(会保留管理员身份),再取消管理员。
想在同一套数据库里放多个超管(比如运维账号),直接改库即可:
UPDATE users SET is_super = 1 WHERE username = 'ops';下一次启动会顺手把 role 补齐成 1;is_super=1 本身就足以进管理后台,不必等重启。
申诉审核
被ban的用户可以在申诉页提交说明,条目出现在这里:
- 顶部按「待审核 / 已通过 / 已驳回 / 全部」筛选;
- 每条显示申诉人、申诉内容、当时的封禁原因与解封时间,以及账号当前是否仍在封禁;
- 通过并解封:立即解除封禁、清空原因与到期时间,用户下一次请求就能回到网盘;
- 驳回:账号继续封禁,可以附一句说明,显示在用户的申诉页,用户可以补充信息再次申诉;
- 每人 24 小时内最多提交 3 条申诉,已有「审核中」的条目时重复提交会被拦下(409);
- 管理员成员的申诉只有超管能审(避免普通管理员互相放行)。
用户在线时被封会马上收到弹窗;如果当时不在线,下一次在登录页登录会直接跳到申诉页。 临时封禁到期会自动解封,不需要手动操作。
举报审核
访客在分享页可以举报内容。这里列出举报条目,能直接看到被举报文件的预览与举报理由, 处理方式为「忽略」或「下架分享」。
意见反馈
用户在「关于」页提交的建议 / 问题汇总在这里,只有管理员可见。可以标记为已处理, 反馈内容、联系方式、提交人都会显示。
审计日志

覆盖 80+ 类动作:登录(含被封账号尝试登录)、注册、上传、下载、删除、还原、移动、复制、改名、 分享创建 / 下载、快传收发与取件、WebDAV 写入、后台设置变更、数据库切换、封禁与申诉审核、 看板娘工具调用与 AI 配置等。每条记录带操作者、动作、详情、IP 与时间。
- 支持按动作、用户、时间范围筛选与分页;动作下拉里每一项都带累计条数(如「看板娘调用工具(128)」), 方便直接看出哪类操作最多。
- 审计动作名会按界面语言显示;没翻译的动作退回原始名称,不会出现
审计动作:xxx这种前缀。 - 「系统设置 → 维护」里可以按天数清理旧日志,也可以手动清空。
系统设置
| 卡片 | 能改什么 |
|---|---|
| 站点 | 站点名称、公告、是否开放注册 |
| 找回密码兜底联系 | 管理员邮箱与 QQ,登录页「忘记密码」会显示 |
| 配额与上传 | 新用户默认配额、单文件上限、分片大小、回收站保留天数 |
| 快传取件码 | 最长有效期、单个文件下载次数上限、过期后文件保留天数,以及立即清理过期文件 |
| 版本更新 | 是否自动检查更新、手动更新按钮(git fast-forward + 重启) |
| 数据库 | 当前服务库、探活延迟、容灾副本状态,以及刷新配置 / 手动切换,见数据库容灾 |
| 维护 | 清理审计日志、孤儿文件扫描、运行环境路径 |
孤儿文件扫描
上传中断、数据库回滚都可能留下「磁盘上有 blob、但没有任何记录引用」的残骸。扫描会对比 磁盘与数据库,列出可回收的字节数,确认后清理。正常文件不会被误删。
版本更新
- 关于页有「检查更新」,任何人都能点,只读地比对版本号,不会改代码。
- 后台「版本更新」卡片可以开自动检查提示,也可以直接点更新:只做
git pull --ff-only, 然后按CLOUDNETP_RESTART_CMD(或内置scripts/restart_helper.py)重启。 - 前提:git 检出、main 分支、工作区没有未提交改动。私有仓库要在
.env配只读UPDATE_TOKEN(fine-grained PAT,Contents: Read),否则匿名请求会 404。 - Docker / 压缩包部署不适用,请在宿主机重新拉取或覆盖文件。
