一、备份清单总览

优先级	项目	说明	典型路径
必须	MySQL 数据库	所有用户、消息、会话、文件元数据	mysqldump 导出
必须	XXD 上传文件	聊天中的文件附件（图片、文件、语音等）	{uploadPath}/{serverName}/YYYY/MM/DD/
必须	XXB 上传文件	用户头像、编辑器粘贴图片	{xxd运行目录}/site/www/data/upload/YYYYMM/
必须	xxd.conf	XXD 主配置文件	{xxd运行目录}/config/xxd.conf
必须	my.php	XXB 数据库连接配置	{xxd运行目录}/site/config/my.php
重要	证书文件	HTTPS/WSS 加密证书和私钥	{certPath}/xxd.crt、xxd.key
重要	License 文件	XXB 商业授权许可证	{xxd运行目录}/site/config/license
可选	日志文件	用于故障排查和审计	{logPath}/xxd_*.log

二、MySQL 数据库备份

使用mysqldump命令将xxb数据库全量备份

三、文件存储备份

喧喧有两套独立的文件存储路径，必须同时备份。

1. XXD 文件存储（聊天附件）
配置项：xxd.conf → [server] → uploadPath

XXD 负责处理聊天中发送的文件附件（图片、文件、语音等）。上传文件按年/月/日三级目录组织：

{uploadPath}/
└── {serverName}/              # 后台程序名称，通常为 xuanxuan
    └── YYYY/                  # 年
        └── MM/                # 月
            └── DD/            # 日
                ├── {MD5hash}          # 原始文件（MD5(文件名+文件ID+时间戳)）
                └── {MD5hash}          # 缩略图（thumb_ 前缀，仅图片生成）

文件命名规则：MD5(原始文件名 + 文件ID + 上传时间戳)。原始文件和缩略图存放在同一目录下，缩略图通过 thumb_ 前缀区分。

2. XXB 文件存储（头像、编辑器图片）
路径：{wwwRoot}data/upload/（wwwRoot` 默认为 site/www/）

XXB 处理后台管理中的图片上传（用户头像、富文本编辑器粘贴的图片等）。上传文件按年月分目录，每种文件存储多个尺寸变体：

data/upload/
└── YYYYMM/                    # 按年月分目录（如 202606）
    ├── f_{md5}.{ext}          # 原始文件（full）
    ├── s_{md5}.{ext}          # 小缩略图（small）
    ├── m_{md5}.{ext}          # 中缩略图（medium）
    └── l_{md5}.{ext}          # 大缩略图（large）