Linux服务器安装Docker前要检查哪些内核与权限条件
在 Linux 服务器首次安装 Docker 前,重点不是只确认系统能否执行安装命令,还要检查 CPU 架构、发行版与内核能力、cgroup、OverlayFS、网络过滤模块、存储文件系统,以及当前用户是否具备安装和管理服务的权限。常见的 64 位 Ubuntu、Debian、Rocky Linux、AlmaLinux 等系统通常可以运行 Docker,但具体支持范围仍要以目标 Docker 版本和发行版仓库为准。

内核版本本身没有一个适用于所有 Docker 版本和发行版的统一最低值。更重要的是确认内核已启用命名空间、cgroup、OverlayFS 和安全策略相关能力,并判断使用 rootful 还是 rootless 模式。前者由 root 权限运行 Docker 守护进程,后者由普通用户运行,权限边界更小,但对用户命名空间、UID/GID 映射和用户态网络组件有额外要求。
一、先确定部署模式和检查范围
1. rootful 与 rootless 的区别
首次部署前先明确 Docker 的运行方式。不要在检查过程中同时混用两种模式,否则容易出现服务、套接字和数据目录相互混淆。
| 检查对象 | rootful 模式 | rootless 模式 |
|---|---|---|
| Docker 守护进程 | 通常由 systemd 以 root 启动 | 由普通用户的用户服务启动 |
| 安装权限 | 需要 root 或 sudo | 安装依赖通常仍需要管理员协助 |
| Docker 套接字 | /var/run/docker.sock | 用户目录下的 rootless 套接字 |
| 默认数据目录 | /var/lib/docker | 用户目录下的 Docker 数据目录 |
| 主机低端口 | 通常可直接发布 | 默认不能直接绑定低于 1024 的端口 |
| 容器访问主机文件 | 受 root 权限和安全策略控制 | 不能超出运行用户自身权限 |
| 额外条件 | 主要检查内核、systemd、存储和安全策略 | 还要检查 newuidmap、newgidmap、subuid/subgid 和用户态网络组件 |
如果服务器用于承载需要管理主机网络、挂载系统目录或运行系统级服务的容器,通常需要评估 rootful 模式的权限边界。如果只是普通应用容器,rootless 可以作为更严格的权限方案,但不能把它理解成“安装时不需要管理员权限”。
2. 确定系统是否属于标准主机环境
本文以能够运行 systemd 服务的物理机、虚拟机或云服务器为主要场景。如果 Linux 本身运行在受限容器、某些精简救援系统或没有完整 PID 1 的环境中,Docker 守护进程可能无法正常启动。
执行基础识别命令:
uname -m
uname -r
getconf LONG_BIT
cat /etc/os-release
ps -p 1 -o pid,comm,args
常见的正常结果应符合以下特征:
uname -m返回x86_64、aarch64等与安装包匹配的 64 位架构。getconf LONG_BIT返回64。/etc/os-release能明确识别发行版和版本。- PID 1 通常是
systemd,标准 rootful 服务可以由systemctl管理。
如果架构为 ARM64,不要直接使用面向 x86_64 的安装包或第三方二进制文件。若系统版本已经停止维护,即使内核功能足够,也可能无法从正常仓库安装兼容的 Docker 软件包。
对于需要在标准 Linux 主机上运行 Docker 的业务,A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,覆盖常规建站、AMD计算、存储、多IP及不同带宽线路需求。产品可按业务负载搭配Xeon或AMD EPYC处理器、充足内存、SSD或NVMe存储,为容器化应用、数据库、接口服务及多任务运行提供相应的硬件与网络资源基础。
二、逐步检查内核能力
1. 检查命名空间、cgroup 和 seccomp
Docker 依赖 Linux 命名空间隔离进程、网络、挂载点和用户;依赖 cgroup 管理容器的 CPU、内存和进程数量;通常还会使用 seccomp 限制危险系统调用。
先检查当前内核配置:
CONFIG_FILE="/boot/config-$(uname -r)"
if [ -r "$CONFIG_FILE" ]; then
grep -E '^(CONFIG_(NAMESPACES|USER_NS|CGROUPS|MEMCG|CGROUP_SCHED|OVERLAY_FS|SECCOMP|SECCOMP_FILTER))=' "$CONFIG_FILE"
else
echo "未找到 $CONFIG_FILE,请根据发行版方式检查内核配置"
fi
理想情况下,相关配置应为 y 或 m。不同发行版可能将某些功能编译进内核,或者拆分为模块,因此不能只根据某一项配置缺失就判定系统不支持。
继续检查 cgroup 挂载情况:
mountpoint -q /sys/fs/cgroup && echo "cgroup 挂载点存在" || echo "cgroup 挂载点不存在"
stat -fc %T /sys/fs/cgroup
cat /sys/fs/cgroup/cgroup.controllers 2>/dev/null
结果判断:
stat返回cgroup2fs,表示使用 cgroup v2。/sys/fs/cgroup/cgroup.controllers能列出cpu、memory、pids等控制器,说明 cgroup v2 控制器可见。- 如果返回
tmpfs或没有cgroup.controllers,可能是 cgroup v1,也可能是 cgroup 没有正确挂载。
cgroup v1 和 v2 是否可用,取决于 Docker 版本、发行版和所需功能。不要为了追求某一种模式直接修改 GRUB 或强制切换 cgroup。先确认目标 Docker 版本是否支持当前模式,尤其是计划使用资源限制、systemd cgroup 驱动或其他依赖 cgroup v2 的功能时。
2. 检查 OverlayFS 和网络模块
Docker 通常使用 OverlayFS 作为镜像层和容器可写层的存储驱动。Linux 内核没有 OverlayFS,或者 Docker 数据目录所在文件系统不适合使用 overlay2 时,守护进程可能退回到性能较差的存储驱动,甚至无法启动。
先进行不改变系统状态的检查:
grep -w overlay /proc/filesystems || echo "当前未发现 overlay 文件系统"
modinfo overlay 2>/dev/null | head -n 10
modprobe -n overlay >/dev/null 2>&1
echo "overlay 模块检查退出码:$?"
modprobe -n br_netfilter >/dev/null 2>&1
echo "br_netfilter 模块检查退出码:$?"
modprobe -n 只是检查模块是否可以被解析,不会真正加载模块。退出码为 0 通常表示模块存在或可以由内核处理;如果失败,应检查内核模块包是否安装完整,而不是立即复制其他系统的 .ko 文件。
Docker 的桥接网络还涉及内核转发和防火墙规则。检查当前状态:
sysctl net.ipv4.ip_forward 2>/dev/null
sysctl net.bridge.bridge-nf-call-iptables 2>/dev/null
sysctl net.bridge.bridge-nf-call-ip6tables 2>/dev/null
command -v nft >/dev/null && sudo nft list ruleset
command -v iptables >/dev/null && sudo iptables -S
这里的命令主要用于观察,不要在安装前执行 iptables -F、nft flush ruleset 等清空规则的操作。清空防火墙可能导致 SSH 中断、业务端口暴露或现有网络策略失效。
net.ipv4.ip_forward 是否开启,需要结合服务器的容器网络和主机防火墙策略判断。对于需要容器访问外部网络、使用 Docker bridge 网络的场景,应确保转发策略没有被主机防火墙拒绝。不要为了“让 Docker 先启动”而永久关闭防火墙或直接设置为全放行。
3. 检查安全模块,不要简单禁用
Ubuntu、Debian 及其衍生系统可能启用 AppArmor;RHEL、Rocky Linux、AlmaLinux 等系统常见 SELinux。它们通常可以与 Docker 一起使用,真正需要确认的是策略是否会阻止 Docker 守护进程、容器挂载或特定系统调用。
检查状态:
command -v aa-status >/dev/null && sudo aa-status || echo "未安装或未启用 AppArmor 工具"
command -v getenforce >/dev/null && getenforce || echo "当前系统未提供 SELinux 状态命令"
grep -E '^(docker|containerd)' /proc/1/comm /proc/*/comm 2>/dev/null | head
如果 SELinux 返回 Enforcing,这不是安装失败条件。后续挂载主机目录时,应根据实际标签使用 Docker 支持的 :Z 或 :z 选项,并结合审计日志定位拒绝原因。不要把关闭 SELinux 当成默认修复方式。
如果 AppArmor 或 seccomp 阻止了容器运行,应先确认具体拒绝事件。也不要用 --privileged 作为通用绕过方案,因为该参数会显著扩大容器的主机访问能力。
三、检查存储和文件系统条件
1. 检查 Docker 数据目录所在磁盘
rootful Docker 默认会在 /var/lib/docker 保存镜像层、容器可写层、元数据和部分日志。首次安装前,至少要确认根分区或计划使用的数据分区有足够空间和 inode。
df -hT /
df -i /
findmnt -T / -o TARGET,SOURCE,FSTYPE,OPTIONS
如果计划把 Docker 数据目录放到单独磁盘,应在安装前确认该路径对应的挂载点。例如先准备好目标目录后检查:
sudo install -d -m 0755 /srv/docker-data
findmnt -T /srv/docker-data -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /srv/docker-data
df -i /srv/docker-data
install -d 会创建目录,这是一次实际的文件系统变更。若服务器有变更审批要求,应先确认目录位置和权限,再执行。
容量没有适用于所有环境的固定最低值。只运行一个测试容器时,预留十几 GB 通常可以满足初始验证;如果需要多个大型镜像、构建缓存和较多容器日志,应按镜像大小、写入量和日志保留策略单独估算。不要只看 df -h,inode 用尽同样会导致镜像解压和容器创建失败。
2. 检查 OverlayFS 对文件系统的适配
常见的 ext4 通常可以作为 Docker 数据目录文件系统。使用 XFS 时,要确认 ftype=1,否则 overlay2 可能无法正常使用。
FS_TYPE="$(findmnt -no FSTYPE -T /)"
FS_TARGET="$(findmnt -no TARGET -T /)"
printf '文件系统类型:%s\n挂载点:%s\n' "$FS_TYPE" "$FS_TARGET"
if [ "$FS_TYPE" = "xfs" ]; then
sudo xfs_info "$FS_TARGET" | grep -E 'ftype='
fi
示例中如果看到:
naming =version 2 bsize=4096 ascii-ci=0, ftype=1
通常表示 XFS 具备 overlay2 所需的目录项类型支持。如果显示 ftype=0,不要直接修改现有 XFS 文件系统参数;这通常需要重新创建文件系统,必须先完成数据备份和迁移。
Docker 数据目录不建议直接放在未经验证的网络文件系统、只读文件系统或带有特殊挂载限制的路径上。若挂载选项包含 ro、异常的 noexec、nodev 或其他安全限制,应先确认是否会影响容器运行和镜像解压。
四、检查安装、服务和文件权限
1. 检查管理员权限和 systemd
安装软件包需要写入系统目录、创建服务文件和加载配置;启动 rootful Docker 还需要管理 systemd 服务。
id
sudo -v
command -v systemctl
systemctl --version | head -n 1
ps -p 1 -o comm=
sudo -v 会验证当前账户是否能取得 sudo 授权,可能要求输入密码。若失败,应先处理账户授权、sudo 配置或云服务器的管理权限,不要直接使用不明来源的提权脚本。
检查安装前是否已有同名软件或旧配置:
command -v docker && docker --version || echo "当前未找到 docker 命令"
sudo test -f /etc/docker/daemon.json && sudo cat /etc/docker/daemon.json || echo "未发现 daemon.json"
sudo systemctl status docker --no-pager 2>/dev/null || true
如果服务器已有旧版 Docker、发行版自带的 docker.io、第三方 Docker 包或手工安装的二进制文件,应先确认来源,避免同时存在多个版本的客户端、守护进程和 containerd。删除旧包前要记录配置,并确认不会影响已有容器。
2. 检查 docker 组的权限风险
rootful Docker 通常通过 /var/run/docker.sock 提供管理接口。将用户加入 docker 组后,该用户通常可以直接控制 Docker,而 Docker 管理权限在很多场景下等同于较高的主机权限。
安装并启动服务后,可以这样检查套接字:
sudo ls -l /var/run/docker.sock
sudo docker info
如果普通用户执行 docker info 提示无权访问套接字,不要直接执行:
sudo chmod 666 /var/run/docker.sock
这种做法会把 Docker 管理接口暴露给所有本机用户,风险较高。若组织允许使用 docker 组,应明确记录授权对象,再执行:
sudo usermod -aG docker "$USER"
执行后需要退出当前登录会话并重新登录,或启动新的登录 shell,组权限才会生效。此权限变更影响范围是整个 Docker 守护进程,不只是某一个容器。
如果不再需要该权限,可以回滚:
sudo gpasswd -d "$USER" docker
回滚后同样需要重新登录,并检查当前会话是否仍保留旧的组成员身份。
3. rootless 模式的额外检查
如果选择 rootless,使用目标普通用户执行以下检查:
id -u
id -un
for cmd in newuidmap newgidmap rootlesskit slirp4netns; do
command -v "$cmd" || echo "缺少组件:$cmd"
done
sudo grep -E "^$(id -un):" /etc/subuid /etc/subgid 2>/dev/null || \
echo "未发现当前用户的 subuid/subgid 配置"
sysctl user.max_user_namespaces 2>/dev/null || true
sysctl kernel.unprivileged_userns_clone 2>/dev/null || true
重点确认:
newuidmap和newgidmap可执行。/etc/subuid与/etc/subgid中存在当前用户的映射范围。user.max_user_namespaces不是0。- rootless 所需的
rootlesskit、slirp4netns或发行版提供的替代网络组件已安装。 - 用户会话能够运行
systemctl --user,或者已经规划好用户服务的生命周期。
rootless 默认无法直接绑定 80、443 等低于 1024 的端口。优先使用高位端口,或通过已有的主机服务转发,不要为了绕过限制而随意修改全局低端口策略。rootless 服务退出用户会话后是否继续运行,也要根据 systemd 用户服务和会话保活配置确认。
五、通过检查后安装并验证首次运行
1. 选择匹配的软件包来源
不要把不同来源的 Docker 软件包混装。Ubuntu、Debian 可以使用发行版提供的 docker.io,也可以按目标版本配置 Docker 官方软件源;RHEL 系列通常需要先配置兼容的软件源,再安装 Docker CE 相关软件包。
以下命令仅适用于软件源已经按发行版和架构配置完成的情况:
# Ubuntu 或 Debian,使用发行版仓库示例
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl enable --now docker
# RHEL、Rocky Linux 或 AlmaLinux,Docker CE 软件源已配置时
sudo dnf install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
systemctl enable --now docker 会立即启动 Docker,并设置为开机启动。这一步会启动守护进程,若服务器上已有旧容器或旧配置,应先确认启动动作不会改变现有业务状态。
如果软件包不存在、依赖冲突或服务名不同,应停止安装并核对发行版版本、软件源和架构,不要强行覆盖系统包。
2. 验证服务、内核能力和存储驱动
先检查服务状态和 Docker 版本:
sudo systemctl status docker --no-pager
sudo docker version
sudo docker info
重点查看 docker info 中的以下字段:
Storage Driver:常见结果为overlay2。Cgroup Driver:应与当前系统的 cgroup 和 systemd 配置匹配。Cgroup Version:确认与前面检查到的 cgroup 模式一致。Security Options:确认 seccomp、AppArmor 或 SELinux 等安全能力没有异常缺失。Docker Root Dir:确认数据目录位于预期磁盘。Warnings:存在警告时不要直接忽略。
在能够访问镜像仓库的环境中,使用无持久化业务数据的测试容器验证首次运行:
sudo docker run --rm hello-world
正常情况下会看到 Docker 客户端联系服务端、拉取测试镜像并输出欢迎信息。这个命令会访问镜像仓库,失败不一定代表内核或权限错误。如果服务器没有外网出口、仓库访问受限或 DNS 配置异常,应先区分网络原因。
如果测试镜像已经存在本地,可以避免再次拉取:
sudo docker image ls
sudo docker run --rm --pull=never hello-world
如果 docker info 正常而 hello-world 拉取失败,优先检查 DNS、默认路由、主机防火墙、仓库认证和代理配置;如果 docker info 本身失败,则应先处理守护进程、套接字或内核条件。
六、常见异常及处理顺序
1. Cannot connect to the Docker daemon
先从服务状态和日志开始,不要立即重装:
sudo systemctl status docker --no-pager
sudo journalctl -u docker -b --no-pager -n 100
如果服务没有启动,日志中的 overlay、cgroup、permission denied、配置文件格式错误等信息分别对应不同方向。rootless 模式不要使用 rootful 的服务命令,应检查:
systemctl --user status docker --no-pager
journalctl --user -u docker --no-pager -n 100
2. permission denied 访问 docker.sock
先用 sudo docker info 验证守护进程是否正常。若 sudo 可以执行而普通用户失败,问题通常是套接字权限或用户组未刷新。
可检查:
id
getent group docker
ls -l /var/run/docker.sock
按照组织权限要求决定是否加入 docker 组,不要使用 chmod 666。如果已经加入用户组但仍失败,重新登录后再次检查。
3. 存储驱动不是 overlay2
如果 docker info 显示 vfs 或其他非预期驱动,应检查:
sudo docker info | grep -E 'Storage Driver|Docker Root Dir|Backing Filesystem'
findmnt -T /var/lib/docker -o TARGET,SOURCE,FSTYPE,OPTIONS
重点确认 OverlayFS 模块、XFS 的 ftype、Docker 数据目录的挂载方式和内核日志。不要在已有容器数据上直接删除 /var/lib/docker,因为该目录包含镜像、容器和本地卷数据。
4. 容器启动但无法联网
先确认 Docker bridge 网络和主机转发状态:
sudo docker network ls
sudo docker network inspect bridge
sysctl net.ipv4.ip_forward
sudo iptables -S 2>/dev/null
sudo nft list ruleset 2>/dev/null
如果主机已有严格防火墙策略,应在不清空现有规则的前提下规划 Docker 相关转发和端口。不要用“关闭防火墙”作为长期解决方案,也不要同时让多个工具无协调地管理同一组 Docker 规则。
5. SELinux 或 AppArmor 拒绝容器操作
遇到挂载目录、读取文件或执行程序被拒绝时,先查看具体审计记录:
command -v ausearch >/dev/null && \
sudo ausearch -m AVC -ts recent | tail -n 50
command -v aa-status >/dev/null && sudo aa-status
根据拒绝对象调整目录标签、容器安全配置或应用路径。只有在确认策略误配且经过变更审批后,才考虑临时调整策略;不要为了通过测试直接永久禁用安全模块。
七、验收与回滚检查项
验收清单
安装完成后,至少确认以下项目:
uname -m、发行版版本和 Docker 软件包架构匹配。/sys/fs/cgroup已正确挂载,Docker 能识别预期的 cgroup 模式。- OverlayFS 可用,XFS 数据盘已确认
ftype=1。 /var/lib/docker或自定义数据目录位于空间和 inode 充足的磁盘。sudo systemctl status docker显示服务正常运行。docker info中的存储驱动、cgroup、安全选项和数据目录符合设计。docker run --rm hello-world能成功运行,或已明确记录失败属于镜像仓库网络问题。- 只有经过授权的账户可以访问 Docker 管理套接字。
- 主机防火墙、SELinux/AppArmor 规则没有被无意清空或关闭。
- rootless 模式下,subuid/subgid、用户态网络组件和用户服务状态均已确认。
回滚清单
如果首次验证失败,需要撤销部署,先区分“撤销服务”与“删除数据”:
sudo systemctl disable --now docker
该命令会停止 Docker,并影响当前运行的所有容器。执行前应确认业务已停止或已经迁移。
随后根据安装来源移除软件包,但不要默认删除数据目录:
# Debian 或 Ubuntu 示例
sudo apt-get remove docker.io
# RHEL 系列示例
sudo dnf remove docker-ce docker-ce-cli containerd.io
/var/lib/docker、自定义 data-root 目录和本地卷可能包含业务数据。只有完成备份、确认不再需要,并明确接受数据删除影响后,才可以清理这些目录。若只是回滚 Docker 程序,保留数据目录通常更安全。
最后检查并撤销本次新增的权限和配置:
- 从
docker组移除不再需要的用户。 - 删除本次新增且确认没有其他服务依赖的
/etc/docker/daemon.json配置。 - 撤销本次新增的 sysctl、systemd 用户服务或模块自动加载配置。
- 不要卸载仍被其他服务使用的内核模块。
- 重新检查磁盘、网络规则、SELinux/AppArmor 状态和 SSH 连接,确认回滚没有扩大影响范围。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8294.html



