统信uos安装docker需先确认内核≥5.4、cgroups已启用、架构匹配，否则将报“permission denied”或“cannot connect to the docker daemon”；依次执行cat /etc/os-version、uname -r、dpkg --print-architecture、ls /sys/fs/cgroup/验证环境。
在统信UOS系统上安装Docker容器运行时，必须先确认内核版本≥5.4、cgroups已启用、架构匹配，否则后续执行docker命令会提示“permission denied”或直接报错“Cannot connect to the Docker daemon”，甚至容器根本无法启动。
确认系统环境是否满足前提条件
打开终端，依次执行以下三条命令：
运行cat /etc/os-version查看UOS具体版本（如V20 1050AE或桌面专业版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源一键安装（推荐用于网络通畅的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 apt-key add -；注意该密钥用于验证软件包签名，跳过将导致apt安装失败。
第三步：添加国内镜像源（适配UOS基于Debian的发行代号）：echo "deb [arch=$(dpkg --print-architecture)] https://mirrors.ustc.edu.cn/docker-ce/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list。
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
第四步：刷新源列表并安装Docker核心组件：sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io；此步骤会自动解决依赖关系，无需手动干预。
启用服务与非root用户权限配置
方法一：启动Docker服务并设为开机自启：sudo systemctl start docker && sudo systemctl enable docker。
方法二：创建docker用户组（如不存在）：sudo groupadd docker；将当前用户加入该组：sudo usermod -aG docker $USER。
执行newgrp docker立即刷新组权限，无需注销重登——这一步能立刻生效，避免反复重启会话浪费时间。
配置国内镜像加速器并验证安装
第一步：创建Docker配置目录：sudo mkdir -p /etc/docker。
第二步：写入镜像加速配置：
sudo tee /etc/docker/daemon.json {<br>"registry-mirrors": ["https://docker.m.daocloud.io", "https://docker.xuanyuan.me"]<br>}<br>EOF。
第三步：重载配置并重启服务：sudo systemctl daemon-reload && sudo systemctl restart docker。
第四步：拉取并运行测试镜像：docker run hello-world；若终端输出包含“Hello from Docker!”且无报错，则说明Docker已可正常拉取、创建并运行容器。
