Cosmos-Server在Ubuntu 24.04上的安装问题解析与解决方案

问题背景

在Ubuntu Server 24.04 LTS环境下使用Docker安装Cosmos-Server时，用户可能会遇到一个常见的错误提示："Error while creating mount source path '/var/lib/cosmos': mkdir /var/lib/cosmos: read-only file system"。这个错误会导致容器虽然启动，但无法正常连接到Cosmos-cloud服务。

问题根源分析

经过深入调查，发现这个问题与Ubuntu 24.04 LTS中预装的Docker版本有关。当用户在Ubuntu安装过程中选择了"Install Docker"选项时，系统会安装一个特殊配置的Docker版本，这个版本存在以下特性：

1. 文件系统权限限制：预装版本对/var/lib目录设置了只读权限
2. 目录创建限制：Docker无法在/var/lib下创建新的子目录
3. 与标准Docker行为的差异：这与官方Docker安装包的行为不一致

解决方案

要解决这个问题，可以采取以下两种方法之一：

方法一：重新安装Docker

1. 首先卸载现有的Docker安装：

   sudo apt remove docker.io
   sudo apt autoremove
   

2. 按照Docker官方文档的指引安装最新版本：

   sudo apt-get update
   sudo apt-get install ca-certificates curl
   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   sudo chmod a+r /etc/apt/keyrings/docker.asc
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   sudo apt-get update
   sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
   

3. 安装完成后，再次尝试运行Cosmos-Server的一键安装命令。

方法二：修改安装目录

如果不想重新安装Docker，可以修改Cosmos-Server的配置目录路径：

1. 选择一个有写入权限的目录，例如/home目录下的某个位置
2. 修改安装命令中的挂载点参数：

   docker run -d --network host --privileged --name cosmos-server -h cosmos-server --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /:/mnt/host -v /home/username/cosmos-config:/config azukaar/cosmos-server:latest
   

预防措施

为了避免类似问题，建议在Ubuntu Server 24.04 LTS安装时：

1. 在安装向导的"Featured Server Snaps"步骤中，不要勾选"Docker"选项
2. 系统安装完成后，按照官方文档手动安装Docker
3. 在安装任何依赖Docker的服务前，先验证Docker的基本功能是否正常

技术原理

这个问题的本质是Ubuntu预装的Docker snap包与标准Docker在文件系统权限处理上的差异。Snap包默认采用严格的沙盒安全策略，限制了容器对主机文件系统的访问权限。而Cosmos-Server需要创建和访问/var/lib/cosmos目录来存储配置数据，当权限不足时就会导致安装失败。

通过重新安装标准Docker或修改配置目录位置，可以绕过这个限制，确保Cosmos-Server能够正常运行。