DzzOffice 网盘文件

DzzOffice 网盘文件采用「物理文件+数据库元数据」分离存储，以下是完整存储逻辑与迁移备份要点：

一、物理文件存储（硬盘）

默认根目录：data/attachment/dzz/（Windows 为 \data\attachment\dzz\）

目录规则：按上传日期自动创建子目录（如 202603/），避免单目录文件过多

文件名：系统自动重命名（随机串），不保留原文件名

示例路径：data/attachment/dzz/202512/11/223807wtxwofxfwg75x3go.docx

所有文件的基础信息存在 dzz_attachment 表中

直接备份：data/attachment/dzz/ 整个目录

适用：仅需恢复文件内容，不保留网盘结构

按照迁移整站方法来或联系官方进行针对性的迁移。

该表存储DzzOffice 文件的元数据信息，与物理文件 data/attachment/dzz/ 一一对应，是文件调用、引用计数、去重、清理的核心依据。

字段名	类型	默认值	字段说明
aid	int(10) unsigned	自动增量	附件唯一ID 文件的主键标识，供全站应用调用
filename	char(100)	-	原始文件名用户上传时的真实文件名称（含后缀）
filetype	char(15)	-	文件类型文件后缀/格式（如 pdf ）
filesize	bigint(20) unsigned	0	文件大小文件占用空间大小（单位：字节）
attachment	char(60)	-	文件相对路径物理文件在服务器存储的相对路径（用于定位实际文件）
remote	smallint(6) unsigned	0	存储位置标识 0 = 本地服务器存储非0 = 云存储（OSS/COS/S3 等）
copys	smallint(6)	0	文件引用计数记录文件被多少个地方引用（帖子/文章/网盘目录等）新增引用时 +1，删除引用时 -1
md5	char(32)	-	文件唯一指纹系统通过 MD5 值判断文件是否重复，实现秒传/文件去重，相同 MD5 视为同一个文件
dateline	int(10) unsigned	0	上传时间戳文件首次上传的时间（Unix 时间戳格式）

文件调用逻辑
其他应用（新闻、文章、插件）只需记录 aid，即可通过该字段查询文件名称、路径、大小等所有信息。

文件去重逻辑
上传新文件时，系统先计算 md5 值，若表中已存在相同 md5，则不重复存储物理文件，仅对对应记录的 copys + 1。

文件自动清理逻辑
当 copys = 0 时，表示该文件无任何应用/位置引用，系统计划任务会自动删除该条数据及对应的物理文件。

存储路径关联
attachment 字段记录的相对路径，直接对应服务器本地 data/attachment/dzz/ 目录下的物理文件，不可随意修改路径或目录名。