统信UOS安装Docker与Docker Compose需先确认内核≥5.4、架构匹配及cgroups启用,再通过APT安装Docker引擎并启用服务,添加用户至docker组,最后按版本选择APT插件、离线二进制或curl脚本方式安装Compose,配置国内镜像加速器后用hello-world和compose version验证全链路。

在统信UOS系统上安装Docker容器引擎与Docker Compose编排工具,是启动本地容器化开发或部署微服务应用的必要前提;若只装Docker而漏掉Compose,后续运行多容器应用时会直接报错“command not found”,若跳过非root权限配置,普通用户每次执行docker命令都必须加sudo,严重影响日常效率。
确认系统环境与内核兼容性
打开终端,先执行cat /etc/os-version查看UOS具体版本(如V20 1070或桌面专业版23),再运行uname -r确认内核版本不低于5.4——低于此版本将无法加载cgroups v2驱动,Docker守护进程启动后立即崩溃。
执行dpkg --print-architecture明确当前是amd64还是arm64架构,这决定后续软件源地址和二进制包选型;填错会导致apt安装报“package architecture does not match system”错误。
运行ls /sys/fs/cgroup/检查cgroup挂载点是否存在非空目录结构;若返回“no such file”,说明内核未启用cgroups功能,【此时Docker无法启动,必须先升级内核或联系运维调整系统配置】。
APT源一键安装Docker引擎(推荐用于UOS桌面专业版及网络通畅的企业版)
第一步:更新软件包索引并安装基础依赖:sudo apt update && sudo apt install -y curl gnupg2 software-properties-common。
第二步:导入Docker官方GPG密钥:curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg;注意该密钥用于验证软件包签名,跳过将导致apt安装失败。
第三步:添加国内镜像源(适配UOS基于Debian的发行代号):echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.ustc.edu.cn/docker-ce/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null。
第四步:刷新源列表并安装Docker核心组件:sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io;此步骤会自动解决依赖关系,无需手动干预。
启用Docker服务与配置非root用户权限
方法一:启动Docker服务并设为开机自启:sudo systemctl start docker && sudo systemctl enable docker。
方法二:创建docker用户组(如不存在):sudo groupadd docker;将当前用户加入该组:sudo usermod -aG docker $USER。
执行newgrp docker立即刷新组权限,无需注销重登——这一步能立刻生效,避免反复重启会话浪费时间。
Docker Compose安装(三选一,按场景匹配)
方法一:APT在线安装插件(仅限UOS 1060e及以上版本)
执行sudo apt update→sudo apt install docker-compose-plugin -y→验证:docker compose version。此方式安装后命令为docker compose(无短横线),与新版Docker CLI深度集成,无需额外PATH配置。
方法二:离线二进制部署(全版本兼容,含ARM平台)
在有网机器下载对应架构文件:ARM平台用wget https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-linux-aarch64,x86_64平台用wget https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-linux-x86_64。
重命名并赋权:mv docker-compose-linux-* docker-compose && chmod +x docker-compose。
移入系统路径:sudo mv docker-compose /usr/local/bin/。
【必须确保下载版本与系统架构严格匹配;若在ARM机器上误用x86_64二进制文件,将报错“Exec format error”】。
方法三:curl脚本自动化安装(适合批量部署)
执行sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose→sudo chmod +x /usr/local/bin/docker-compose→验证:docker-compose --version。
配置国内镜像加速器并验证全链路
创建配置目录:sudo mkdir -p /etc/docker。
写入加速器地址:echo '{"registry-mirrors": ["https://docker.m.daocloud.io"]}' | sudo tee /etc/docker/daemon.json。
重载配置并重启服务:sudo systemctl daemon-reload && sudo systemctl restart docker。
拉取并运行测试镜像:docker run --rm hello-world;看到“Hello from Docker!”输出即表示Docker引擎就绪。
运行docker compose version或docker-compose --version(依所选方法而定),确认Compose可用。











