银河麒麟v10 docker容器环境配置需五步：一、修改/etc/docker/daemon.json启用overlay2存储驱动与systemd cgroup；二、加载overlay内核模块并确保xfs/ext4兼容；三、通过grub启用cgroup v1兼容模式；四、将用户加入docker组获取免sudo权限；五、配置containerd为默认运行时。
如果您已在银河麒麟V10 (kylinos)系统上完成Docker基础安装，但容器无法正常运行或环境功能受限，则可能是由于Docker守护进程未正确配置、存储驱动不兼容、或cgroup版本未适配所致。以下是配置Docker容器环境的多种可行方法：
一、配置Docker守护进程（daemon.json）
该方法通过修改Docker守护进程配置文件，统一设定容器运行时行为，包括默认存储驱动、镜像仓库地址、日志策略等关键参数，确保容器在银河麒麟V10内核下稳定运行。
1、创建Docker配置目录（若不存在）：
sudo mkdir -p /etc/docker
2、使用文本编辑器新建或编辑配置文件：
sudo vim /etc/docker/daemon.json
3、写入标准适配配置（适配Kylin V10 aarch64/x86_64架构及4.19+内核）：
{
"storage-driver": "overlay2",
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
},
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"],
"exec-opts": ["native.cgroupdriver=systemd"]
}
4、保存退出后重载Docker守护进程：
sudo systemctl daemon-reload
5、重启Docker服务以应用新配置：
sudo systemctl restart docker
二、启用并验证overlay2存储驱动
overlay2是银河麒麟V10推荐的容器存储驱动，依赖内核模块overlay与fs.xfs挂载支持。若未启用，容器镜像层将无法叠加，导致pull失败或启动异常。
1、检查overlay内核模块是否已加载：
lsmod | grep overlay
2、若无输出，手动加载模块：
sudo modprobe overlay
3、确保开机自动加载，创建配置文件：
echo "overlay" | sudo tee /etc/modules-load.d/overlay.conf
4、验证文件系统是否支持xfs（/var/lib/docker所在分区）：
df -T /var/lib/docker | awk 'NR==2 {print $2}'
5、若返回ext4，需确认内核支持overlay2 on ext4（Kylin V10 SP1+内核4.19.90及以上已原生支持），否则必须将/var/lib/docker挂载到xfs格式分区
三、配置cgroup v2兼容模式
银河麒麟V10默认启用cgroup v2，而部分旧版Docker二进制包仅兼容cgroup v1。若容器启动报错“cgroup controller not found”或“no cgroup mount found”，需显式启用v1兼容支持。
1、编辑GRUB配置文件：
sudo vim /etc/default/grub
2、在GRUB_CMDLINE_LINUX行末尾添加参数：
systemd.unified_cgroup_hierarchy=0 systemd.legacy_systemd_cgroup_controller=1
3、更新GRUB配置：
sudo update-grub
4、重启系统使内核参数生效：
sudo reboot
5、重启后验证cgroup版本：
cat /proc/1/cgroup | head -1 | cut -d: -f3 | grep -q "/" && echo "cgroup v1 active" || echo "cgroup v2 only"
四、配置非root用户容器执行权限
为避免每次执行docker命令均需sudo，需将普通用户加入docker组。此操作直接影响容器环境的日常可用性与安全性边界。
1、创建docker用户组（如不存在）：
sudo groupadd docker
2、将当前用户加入docker组：
sudo usermod -aG docker $USER
3、刷新组权限（无需登出）：
newgrp docker
4、验证权限是否生效：
docker run --rm hello-world
5、若提示“permission denied”，请确认/var/run/docker.sock文件属组为docker且权限为srw-rw----
五、配置Containerd作为默认运行时
自Docker 20.10起，Containerd已成为默认容器运行时。在银河麒麟V10中显式配置Containerd可提升容器启动速度与资源隔离稳定性，尤其适用于.NET、Java等需高精度CPU/内存控制的容器场景。
1、确认Containerd已安装并运行：
sudo systemctl status containerd
2、编辑Docker守护进程配置，指定运行时路径：
sudo vim /etc/docker/daemon.json
3、在原有配置中追加runtimes字段：
"runtimes": {
"io.containerd.runc.v2": {
"path": "/usr/bin/runc"
}
},
"default-runtime": "io.containerd.runc.v2"
4、重启Docker服务：
sudo systemctl restart docker
5、验证运行时类型：
docker info | grep "Default Runtime"
