很多用户在完成百度一镜数字人本地部署后的首次直播测试，或刚完成服务器迁移后，都会遇到同一个问题：打开磁盘一看，几十个 GB 的空间被缓存、日志和临时模型权重占得满满当当。想手动清理，又担心误删关键目录，导致整个服务无法启动。针对这个常见问题，确实需要一份清晰、可靠的“安全清理指南”来帮助排查和释放磁盘空间。
下面这份经过实际验证的清理清单，可以直接对照操作。核心原则只有一个：明确哪些目录可以清理，哪些目录绝对不能动。
确认安装路径与主目录结构
开始清理之前，首先要确认百度一镜本地部署版的实际安装路径。百度一镜本地部署版本（非 SaaS 网页版）的默认安装目录通常是 /opt/baidu-yijing/，这个路径由安装脚本固定写入，不能通过环境变量修改。如果你在安装时使用了自定义路径，建议回看安装日志，查找 "Installation completed at:" 后面显示的真实目录位置。
进入安装目录后，执行 ls -F，通常会看到这些核心子目录：bin/ conf/ data/ logs/ models/ runtime/ tmp/ webui/。
这里有一个必须牢记的重点：bin/、conf/、webui/ 这三个目录中的任何文件都不要修改或删除。它们分别对应启动脚本、核心配置文件和前端界面资源，只要缺少其中任意关键文件，百度一镜服务就可能无法正常运行。
可安全清理的目录及操作步骤
接下来可以按照顺序逐步清理，把被占用的磁盘空间安全释放出来。
第一步：清空 tmp/ 下全部内容
tmp/ 目录用途非常明确，主要保存单次推流或直播过程中生成的中间帧、音频切片以及临时视频缓存。这些文件只在当前直播会话期间有效，服务重启后会自动重新生成。因此，直接执行 rm -rf /opt/baidu-yijing/tmp/* 即可，通常不会产生副作用，属于百度一镜磁盘清理中最安全的一步。
第二步：归档并压缩 logs/ 中30天前的日志文件
logs/ 目录默认通常只保留 7 天滚动日志，但不少用户为了排查部署问题或直播异常，会把完整日志保留时间调长，例如在 conf/logback-spring.xml 中将
find /opt/baidu-yijing/logs -name "*.log" -mtime +30 -exec gzip {} ;
一定要注意顺序：先压缩，再处理原日志。不要为了省事直接执行 rm *.log 全删，否则后续如果需要定位直播故障、模型报错或部署异常，就可能失去最重要的排查依据。
第三步：筛选性清理 data/cache/ 子目录
data/ 是整个百度一镜本地部署目录中最需要谨慎处理的位置之一。它下面通常包含三个子目录：cache/、upload/、output/。
- cache/：主要存放 AI 脚本生成的中间状态文件、语音合成缓存以及口型对齐产生的临时数据。这部分可以安全清理，直接执行 rm -rf /opt/baidu-yijing/data/cache/* 即可。
- upload/：这里保存的是你主动上传的真人视频素材（用于“一键克隆”）、商品图片、背景图等业务资源。是否删除要根据实际业务需求判断，没有统一的清理标准。
- output/：主要保存已导出的直播回放 MP4、视频剪辑片段和封面图。如果这些文件已经备份到 NAS、网盘或对象存储中，就可以按需批量删除，以释放大量磁盘空间。
models/ 目录清理规则
models/ 目录比前面的缓存目录更敏感，清理时一定要更加小心。下面提供两种常见方法。
方法一：手动删除未加载的模型权重包
models/ 下的每个子目录通常对应一个数字人形象模型或语音模型，命名格式可能类似 a vatar_zhangsan_v2/ 或 voice_xiaomei_202506/。建议先执行 ps aux | grep "ja va.*yijing"，查看当前服务实际加载的模型 ID，该信息通常会出现在 -Dmodel.id=xxx 参数中。确认后，只删除那些没有出现在该参数中的完整子目录，避免误删正在使用的模型文件。
方法二：使用内置清理工具（推荐）
进入 bin/ 目录后，执行：
./cleanup-models.sh --dry-run 先进行预览，确认系统准备删除哪些模型；
确认没有问题后，再执行：
./cleanup-models.sh --keep-last 2 —— 该命令会为每种模型类型保留最新的 2 个版本，其余旧版本自动清理，更适合定期维护百度一镜模型目录。
这里还要特别强调一点：models/ 目录下的 .index 文件绝对不能单独删除。这类文件记录的是模型元信息，一旦缺失，服务启动时通常会报出 ModelMetaNotFoundException 错误，最终可能需要重新下载模型甚至重新部署环境。
runtime/ 目录能否删？
不能直接删除，但可以有针对性地做“瘦身处理”。
runtime/ 目录主要保存 Ja va 虚拟机运行时生成的 JIT 编译缓存、堆转储快照（.hprof）以及线程堆栈日志。其中，runtime/dump/ 目录下的 .hprof 文件体积往往非常大，单个文件就可能达到 4–8GB，这类文件一般只会在 OOM（内存溢出）时生成，日常运行中基本没有使用价值。因此，可以直接执行：
find /opt/baidu-yijing/runtime/dump -name "*.hprof" -type f -delete。
至于其他子目录，例如 jre/ 和 lib/，它们属于嵌入式 JRE 运行环境，是百度一镜本地部署服务正常启动的基础组件。一旦删除，服务很可能立即瘫痪，因此这部分文件绝对不要碰。