文件运维与挂载
文件运维把挂载、传输任务、备份、缓存与限速等节点级维护收进一页，面向长期看管存储节点的运维人员。
10 个 Tab 收在一页
挂载列表、挂载诊断、备份管理、WebDAV、文件缓存、存储任务、文件日志、系统日志、传输设置、进程黑名单。
- 页头徽章直接告诉你 FUSE 可用还是不可用，不可用时给出缺失依赖与安装提示
- 编辑与删除挂载配置都要求先卸载
- 12 类任务、16 态状态机，父任务可展开子任务，每条都带 Trace ID
能做什么
- 把网盘挂载源映射成本地 FUSE 文件系统。
- 统一观测 12 类任务与 16 态状态机。
- 配置备份、WebDAV、缓存、限速与黑名单。
界面与操作
10 个 Tab 走 hash 路由：#/mounts、#/storage/mounts → 挂载列表，#/storage/tasks → 存储任务，#/storage/operations → 备份管理，支持 ?tab=。页头节点选择器是统一门禁。
单机版没有节点切换菜单
单机版只有一个内置 Storage（node-local-storage），页头隐藏节点选择器，只显示当前服务状态； 你不需要、也无法切换节点。分布式版有多个文件管理节点时才出现切换，切换会提示取消进行中的浏览器上传。
FUSE 挂载
挂载＝把已启用的网盘挂载源映射成本地 FUSE 文件系统，本地磁盘不需重复挂载。
单机版默认不提供主机 FUSE 挂载
单机版把 Storage 与其它服务放在同一个容器里，为挂载授予 /dev/fuse、SYS_ADMIN 或 privileged 会让同一容器内的全部服务共享更高权限，因此本期默认关闭主机 FUSE 挂载。 页头的 FUSE 能力徽章会显示不可用及原因。
这不影响云盘管理、文件浏览、上传下载、媒体同步与刮削——它们照常可用。
单机版的容器权限边界
单机版默认关闭主机 FUSE 挂载，聚合容器不使用 privileged，不授予 SYS_ADMIN。 这是默认配置，不需要你手工调整。
| 字段 | 说明 |
|---|---|
| 挂载名称 / 网盘 Provider | 选一个已启用的挂载源 |
| Provider 源目录 | 留空为根目录，带目录选择器 |
| 本地挂载点 | 留空用默认目录，示例 /mnt/yiyi/gd1 |
| 读写模式 / 自动挂载 | 只读或读写；自动或手动 |
| UID / GID | -1 沿用进程 |
| 权限 | 八进制，默认 0755，非法值被拦截 |
生命周期「创建配置 → 挂载 → 卸载 → 删除配置」，编辑与删除都要先卸载。状态分未挂载 / 挂载中 / 已挂载 / 卸载中 / 错误五档。
页头有「FUSE 可用 / 不可用」徽章：不可用时直接给出缺失的依赖、安装提示与清理命令，不静默失败；同时给出平台、FUSE 版本与支持的读写改名能力。
挂载级指标：缓存命中与未命中（目录 / 属性 / 读）、IO 读写字节与操作数、暂存区待处理与待传字节。
挂载诊断 Tab：活动打开句柄（路径、inode、读 / 写、pid、进程名等）与持久暂存临时文件；不显示服务器绝对路径。卸载后未完成的持久暂存仍由任务链路恢复。
存储任务
| 类型 | 怎么产生 |
|---|---|
| 读取 | 挂载点连续长读取达阈值后升级为持久化任务 |
| 上传 | 向挂载点写入文件 |
| 下载 | 跨挂载操作 |
| 离线下载 | 填写 HTTP(S) 地址与目标路径 |
| 复制 / 移动 | 复制、移动文件 |
| 目录合并 | 复制或移动目录到同名目录时的递归合并 |
| 备份 | 备份策略入队 |
| 建目录 / 重命名 / 删除 | 建目录、改名、删条目 |
| 整理器批量删除 | 媒体整理删除重复版本文件 |
16 态状态机，主链路是预处理 → 排队 → 运行 / 下载中 / 上传中 → 已完成，旁路为暂停、取消与终态：
| 状态 | 中文 | 集合 |
|---|---|---|
WAITING / PREPROCESSING | 排队中 / 预处理中 | 进行中 |
DOWNLOADING / UPLOADING / RUNNING | 下载中 / 上传中 / 运行中 | 进行中 |
PAUSING / CANCELLING | 暂停中 / 取消中 | 进行中 |
PAUSED / FAILED | 已暂停 / 失败 | 需关注 |
PARTIAL_FAILED / BLOCKED | 部分失败 / 已阻塞 | 需关注 |
DONE / SUCCEEDED | 已完成 | 已结束 |
CANCELLED / IGNORED / SKIPPED | 已取消 / 已忽略 / 已跳过 | 已结束 |
读取、删除、重命名、建目录四类不可暂停、恢复、取消或重试。
预处理阶段依次做扫描源、算 hash、探测秒传、二次校验与提交；115 秒传命中带「0 字节传输」徽标。浏览器上传另有 8 个阶段：QUEUED → LOCAL_CHUNKS → PROVIDER_COMMIT → VERIFYING → DONE，以及 FAILED / PAUSED / CANCELLED。
观测：刷新间隔 1–300 秒十档可选；进度条两种口径——字节类显示已传 / 总量与百分比，删除 / 重命名 / 建目录 / 整理器批量删除按项计数「已处理 N / M 项」；父任务可展开子任务。详情抽屉含来源与目标路径、冲突策略、重试次数、最近心跳、各类文件计数与事件时间线等。复制类任务（复制 / 移动 / 合并 / 备份）只展示进度，不展示速度：它们是编排记录，自身不搬运字节，进度由派生的下载与上传子任务汇总而来，真实速率只属于那两类子任务；列表在当前视图不含下载 / 上传任务时整列隐藏速度，卡片也只在下载 / 上传卡片上显示速率。页面不再单列「总速率」这类跨类型汇总，避免与卡片重复。
筛选：关键词（源 / 目标路径）、状态（16 态加进行中 / 上传中 / 下载中 / 预处理中四个聚合态，均含已阻塞）、来源（7 种）、Provider；类型直接点上方复制 / 下载 / 上传三张聚合卡片切换，不再另设类型下拉框（离线下载 Tab 无卡片，仍保留类型下拉框）。首次进入 /storage/tasks 默认选中「复制任务」，直接看复制、移动、合并与备份任务；带 origin / kind / status 等参数的深链（文件管理、备份管理等入口）仍按参数筛选，不被默认值覆盖。批量暂停 / 恢复 / 重试 / 取消 / 删除，前四项仅在选中任务全部可控时显示。
离线下载：存储节点从 HTTP(S) 拉取到受配额保护的暂存区，再经挂载源续传会话上传；签名参数不出现在任务与日志中。
备份、WebDAV 与文件缓存
备份管理 Tab：备份策略含冲突处理、源文件消失处置、完成后动作，源 Provider + 源目录路径 + 备份目标。
| 项 | 可选值 |
|---|---|
| 同名文件 | SKIP / OVERWRITE / KEEP_HISTORY_VERSION |
| 源文件消失 | KEEP / DELETE / RECYCLE / MOVE_TO_VERSION_HISTORY |
| 备份完成后 | NONE / DELETE_SOURCE / DELETE_SOURCE_AND_EMPTY_FOLDER |
| 遍历间隔 | 秒，0 关闭 |
| 开关 | 启用、文件变更 Watch、启动时强制遍历、同步源删除 |
另有文件规则黑名单、按星期的定时表、立即运行、重新遍历与运行记录。
WebDAV Tab：用标准 WebDAV 客户端访问选定挂载源，操作进入存储任务与文件日志；每个用户绑定一个 Provider 与隔离根路径；访问 Token 可作 Bearer Token 或 Basic 密码，只能重置、不回显。
文件缓存 Tab：远端文件按分块落盘，前台读取与后台完整下载共享进度；设置项含启用持久化缓存、缓存目录、分块大小、容量上限、淘汰策略与后台并发；条目可「失效并清理」或「执行淘汰」。
传输设置与黑名单
传输设置 Tab 分组如下，部分项标「只读 · 修改配置并重启后生效」，其余「保存并立即生效」：
- 并发与速率：上传 / 下载 / 预处理并发数——三个线程池的并发槽数，约 1 秒后生效。
- 带宽限速：上传 / 下载限速，
0或留空为不限速，即时生效无需重启，单位 K / M / G / T。 - 读取观测：长读时间与字节阈值、Provider 单请求阈值、读取会话空闲窗口；连续读取按 Provider、路径与进程聚合，达阈值升级为读取任务。
- 写入策略：Provider 封禁时拒绝写入（关掉后会假装写入成功，不推荐）、fsync 阻塞至上传完成（开＝真等远端确认）、同步直传阈值、Provider 分片大小、进度持久化步长、暂存保留时间、磁盘空间倍率拒绝。
- 自动刮削：写动作后联动刮削与清理；新建 / 删除 / 改名各有独立开关加一个主开关；改名与移动会先清理旧路径再入队新路径。⚠️ 界面上的「上卷到剧目录去重」开关目前不生效，实际去重窗口是 30 秒、粒度是「挂载源 + 条目」。
- 多实例接管：运行中任务由一个存储实例持租约续租，失联后其他实例只接管租约已过期的任务。
进程黑名单 Tab：规则（进程名如 mds、quicklookd ＋ 原因 ＋ 备注）与拦截记录。
双份日志
| Tab | 内容 |
|---|---|
| 文件日志 | 文件操作事实流水，可按路径、Provider、操作、结果、Task ID、Trace ID 筛选；支持暂停刷新与导出当前页 JSON |
| 系统日志 | 当前节点的服务日志，超 8 MiB 只取末尾窗口，可跳转文件日志 |
Trace ID 贯通存储任务与双份日志，是排查失败传输的线索。
关键规则
- 编辑或删除挂载配置前必须先卸载；FUSE 不可用时给缺失依赖与安装提示，不静默失败。
- 读取、删除、重命名、建目录四类任务不支持暂停、恢复、取消与重试；批量操作的前四项仅在选中项全部可控时出现。