Linux服务器安装Docker前要检查哪些内核与权限条件

发布人:A5数据发布时间:2026-11-08 13:43阅读量:78

在 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

相关推荐