CasaOS项目：解决Zimaboard内部存储空间不足问题

问题背景

在使用CasaOS系统运行于Zimaboard设备时，用户经常遇到内部存储空间被占满的问题。从技术角度来看，这通常是由于Docker容器默认将数据存储在系统分区（/var/lib/docker）导致的。虽然用户可能只运行少量容器，但这些容器产生的数据会迅速消耗有限的内部存储空间。

问题分析

通过系统诊断命令可以看到，28GB的内部存储中已有26GB被使用，使用率高达98%。深入分析发现：

1. Docker相关文件占用了大量空间，特别是overlay2目录（3.9GB）和volumes目录（677MB）
2. 系统挂载点显示Docker容器数据仍存储在内部存储而非外部SSD
3. /mnt目录下虽然挂载了1.8TB的外部SSD，但Docker并未利用这部分空间

解决方案

方案一：迁移Docker数据目录

最彻底的解决方案是将Docker的数据目录迁移到外部存储设备上。以下是详细步骤：

1. 停止Docker服务 首先需要停止所有Docker相关服务，确保数据完整性：

   sudo systemctl stop docker.service
   sudo systemctl stop docker.socket
   

2. 创建新的存储目录 在外部SSD上创建用于存放Docker数据的目录：

   sudo mkdir -p /mnt/StorageSSD/docker
   

3. 复制现有数据 使用rsync命令将现有Docker数据完整复制到新位置：

   sudo rsync -aSv /var/lib/docker/ /mnt/StorageSSD/docker
   

4. 创建符号链接 建立符号链接，使系统仍能通过原路径访问Docker数据：

   sudo ln -s /mnt/StorageSSD/docker /var/lib/docker
   

5. 重启Docker服务 完成迁移后重新启动Docker服务：

   sudo systemctl start docker.service
   sudo systemctl start docker.socket
   

6. 清理旧数据（可选） 确认新位置运行正常后，可删除原数据释放空间：

   sudo rm -rf /var/lib/docker/*
   

方案二：调整Docker存储驱动配置

对于不想完全迁移目录的用户，可以调整Docker配置，使其部分数据存储在外部设备：

1. 编辑Docker配置文件：

   sudo nano /etc/docker/daemon.json
   

2. 添加或修改以下配置：

   {
     "data-root": "/mnt/StorageSSD/docker",
     "storage-driver": "overlay2"
   }
   

3. 重启Docker服务使配置生效：

   sudo systemctl restart docker
   

预防措施

为避免未来再次出现存储空间问题，建议：

1. 定期监控存储使用情况 设置定期任务检查存储空间，可使用以下命令：

   df -h
   du -hs /var/lib/docker/*
   

2. 配置日志轮转 Docker容器日志可能占用大量空间，配置日志轮转限制日志文件大小：

   sudo nano /etc/docker/daemon.json
   

   添加配置：

   {
     "log-driver": "json-file",
     "log-opts": {
       "max-size": "10m",
       "max-file": "3"
     }
   }
   

3. 清理无用Docker资源 定期执行以下命令清理无用资源：

   docker system prune -a --volumes
   

技术原理

Docker默认使用overlay2存储驱动，它会为每个容器创建多层文件系统。这些层包括：

1. 基础层：镜像的基础文件系统
2. 容器层：容器运行时的可写层
3. 合并层：将各层合并后呈现给容器的统一视图

当容器频繁写入数据时，这些层会占用大量空间。迁移到外部存储可以避免内部存储被耗尽，同时利用外部设备通常具有更好的I/O性能。

注意事项

1. 在执行任何存储迁移前，建议备份重要数据
2. 确保外部存储设备已正确挂载且具有足够空间
3. 迁移过程中不要中断电源或操作，以免造成数据损坏
4. 对于生产环境，建议先在测试环境验证迁移方案

通过以上方法，可以有效解决CasaOS在Zimaboard设备上的存储空间问题，同时为未来可能出现的类似问题提供预防措施。