银河麒麟V10部署Docker有五种方法:一、YUM源在线安装(需修正$releasever为7);二、APT源安装(适用于Ubuntu系);三、静态二进制离线安装(适配ARM64/涉密环境);四、RPM离线安装(SP2/SP3官方认证包);五、一键脚本安装(仅限测试环境)。

如果您在银河麒麟V10操作系统上需要部署Docker容器运行环境,但系统未预装或安装失败,则可能是由于架构识别错误、软件源缺失、内核模块未加载或服务单元未注册所致。以下是针对银河麒麟V10(含SP1/SP2/SP3/Tercel/Lance等主流版本)的多种可靠安装方法:
一、YUM源在线安装(适用于Kylin V10服务器版,底层为CentOS/RHEL系)
该方法依赖系统内置或适配的yum仓库,自动解决依赖并完成服务注册,适合网络可达且已配置有效软件源的环境。需注意麒麟V10内核与Docker CE官方仓库存在$releasever变量兼容性问题,必须显式修正。
1、卸载可能存在的冲突包:sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-logrotate docker-engine -y
2、安装基础依赖工具:sudo yum install -y yum-utils device-mapper-persistent-data lvm2
3、添加Docker官方稳定版仓库:sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
4、强制替换仓库中$releasever变量为7以匹配麒麟内核:sudo sed -i 's/\$releasever/7/g' /etc/yum.repos.d/docker-ce.repo
5、安装Docker CE核心组件:sudo yum install -y docker-ce docker-ce-cli containerd.io
6、启动并启用Docker服务:sudo systemctl start docker && sudo systemctl enable docker
7、验证安装结果:sudo docker run hello-world
二、APT源安装(适用于基于Ubuntu/Debian的麒麟桌面版或部分定制版)
该方式通过apt包管理器拉取Docker CE社区版,需手动添加官方GPG密钥与软件源,适用于支持apt且架构匹配的麒麟衍生版本。注意必须校验lsb_release -cs输出是否为focal、jammy等有效代号。
1、更新系统并安装依赖:sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates curl gnupg software-properties-common
2、导入Docker官方GPG密钥:curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
3、添加软件源(x86_64平台):echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
4、更新索引并安装:sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io
5、验证安装结果:sudo docker --version
三、静态二进制包离线安装(适用于涉密网、物理隔离环境或ARM64架构)
该方案绕过包管理器,直接部署Docker官方静态编译二进制文件,完全可控、无网络依赖,是国产化替代场景下的首选方式。要求内核版本≥4.19.90且已加载overlay与br_netfilter模块。
1、确认系统架构与内核版本:uname -m 输出必须为aarch64或x86_64;uname -r 输出内核版本不低于4.19.90
2、加载必需内核模块:sudo modprobe overlay && sudo modprobe br_netfilter
3、持久化模块加载配置:echo "overlay" | sudo tee /etc/modules-load.d/overlay.conf && echo "br_netfilter" | sudo tee /etc/modules-load.d/br_netfilter.conf
4、下载对应架构的Docker静态包(如aarch64平台):wget https://download.docker.com/linux/static/stable/aarch64/docker-24.0.7.tgz
5、校验文件完整性:sha256sum docker-24.0.7.tgz 对比官网公布的哈希值,确保校验值完全一致
6、解压并复制二进制文件:tar -xzvf docker-24.0.7.tgz && sudo cp docker/* /usr/bin/
7、创建systemd服务单元文件:sudo vim /usr/lib/systemd/system/docker.service
8、填入标准服务定义内容(含[Unit]、[Service]中ExecStart=/usr/bin/dockerd、Type=notify、Restart=always、[Install])
9、重载并启动服务:sudo systemctl daemon-reload && sudo systemctl start docker
四、RPM包离线安装(适用于SP2/SP3高安全加固环境)
该方式使用麒麟官方适配的docker-engine RPM包,经国密算法签名认证,满足等保三级及信创目录要求,适用于政务、金融等强合规场景,无需修改内核参数或手动配置驱动。
1、从麒麟官方镜像站下载适配SP3的RPM包:wget https://repo.kylinos.cn/kylin/KYLIN-Server-V10-SP3/aarch64/Packages/docker-engine-24.0.7-1.ky10.aarch64.rpm
2、校验RPM包签名:rpm -K docker-engine-24.0.7-1.ky10.aarch64.rpm
3、安装RPM包:sudo rpm -ivh --force docker-engine-24.0.7-1.ky10.aarch64.rpm
4、启动Docker服务:sudo systemctl start docker-engine
5、验证服务状态:sudo systemctl status docker-engine
五、一键脚本安装(适用于快速验证及非生产环境)
该方式调用经轩辕镜像平台验证的通用部署脚本,自动识别架构、切换镜像源、配置加速器与docker组权限,适合开发测试及POC环境,不适用于涉密或审计严格场景。
1、下载并执行一键安装脚本:bash
2、脚本将自动完成以下操作:检测架构、选择源、安装docker-ce与docker-compose、配置/etc/docker/daemon.json启用国内镜像加速、创建docker用户组、将当前用户加入该组
3、验证安装结果:docker --version && docker compose --version


















