Linux服务器如何安装并部署Docker?从服务启动到容器运行怎样验证

发布人:A5数据发布时间:2026-11-05 17:40阅读量:86

在一台尚未安装 Docker 的 Linux 服务器上,首次部署的目标可以分成三项:安装 Docker Engine、确认服务已启动,再运行一个容器并验证它能提供预期结果。下面以 Ubuntu 22.04 或 24.04、使用 systemd 管理服务的服务器为例,使用 Docker 的 APT 软件源安装。Debian、其他发行版及已运行 Docker 工作负载的主机,不应直接照搬软件源和卸载步骤。

实施前需要有具备 sudo 权限的账号,服务器能够访问软件源并拉取容器镜像。全程使用 sudo docker 验证,不把普通账号加入 docker 用户组:该用户组具有较高的主机操作权限,首次部署并不需要为此额外变更权限。

在 Linux 服务器上部署 Docker,后续容器应用需要计算、存储和网络资源作为运行基础。A5idc数据提供中国香港、美国、日本及新加坡等地区的物理服务器,涵盖 Xeon、AMD EPYC 等计算平台,以及 SSD、NVMe 存储配置,可承载网站服务、业务后台和接口应用的容器化部署。不同地区的带宽与线路方案,也为面向不同访问区域的业务提供网络资源选择。

准备条件:确认系统与现有安装状态

先核对发行版、版本代号和 CPU 架构。后续软件源会使用系统提供的版本代号,不能在未确认环境时直接写死。

. /etc/os-release
printf 'ID=%s VERSION_ID=%s VERSION_CODENAME=%s\n' "$ID" "$VERSION_ID" "$VERSION_CODENAME"
dpkg --print-architecture

预期 ID=ubuntu,Ubuntu 22.04 的版本代号为 jammy,24.04 为 noble。如果系统不是这两个版本,应先核对该发行版对应的安装说明,而不是继续使用本文的 Ubuntu 软件源。

再检查是否已有 Docker 或相关容器运行时:

command -v docker || true
dpkg-query -W -f='${binary:Package} ${Status}\n' \
  docker.io docker-ce docker-ce-cli containerd.io containerd runc podman-docker \
  2>/dev/null || true

未找到 docker 命令,且没有显示状态为 install ok installed 的相关软件包,符合本文的首次安装前提。如果已有 docker.io、containerd、runc 或正在运行的容器,先确认现有服务的用途并制定迁移方案;不要为了执行安装命令而直接卸载它们。

还应确认磁盘有可用空间,并检查系统时间。软件包安装和镜像拉取都需要磁盘空间;时间明显错误可能导致 HTTPS 证书校验失败。

df -h /
timedatectl status

以下步骤会新建 /etc/apt/keyrings/docker.asc 和 /etc/apt/sources.list.d/docker.list。执行前确认这两个文件不存在;如果已存在,应先检查内容和归属,避免覆盖原有配置。

ls -l /etc/apt/keyrings/docker.asc /etc/apt/sources.list.d/docker.list 2>/dev/null || true

安装 Docker Engine,并逐步验证

1. 安装获取软件源所需的工具

更新 APT 索引,安装 HTTPS 证书和下载工具:

sudo apt-get update
sudo apt-get install ca-certificates curl

两条命令均正常结束后,再添加 Docker 软件源。如果第一条命令已出现软件源连接或签名错误,应先处理现有 APT 问题,不要把后续安装失败直接归因于 Docker。

2. 添加 Docker 的软件源和签名密钥

仅在上一节确认目标文件不存在时执行:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

写入与当前 Ubuntu 版本代号、架构对应的软件源:

printf 'deb [arch=%s signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu %s stable\n' \
  "$(dpkg --print-architecture)" \
  "$(. /etc/os-release && printf '%s' "$VERSION_CODENAME")" |
  sudo tee /etc/apt/sources.list.d/docker.list

更新索引,并查看 Docker Engine 是否有可安装版本:

sudo apt-get update
apt-cache policy docker-ce

apt-cache policy 中应能看到来自所添加软件源的 Candidate 版本。如果显示 Candidate: (none),先核对系统版本代号、架构及 apt-get update 的报错;此时继续执行安装通常不会成功。APT 更新若报告签名验证失败,也应停止并检查密钥文件与软件源配置,不要关闭签名校验。

3. 安装软件包并启动服务

安装 Engine、命令行工具、容器运行时及 Docker 的构建和 Compose 插件:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker

enable --now 会立即启动 Docker,并设置开机启动。先检查 systemd 状态,再检查客户端能否连接到服务端:

systemctl is-active docker
systemctl is-enabled docker
sudo docker version

前两条命令预期分别输出 active 和 enabled;sudo docker version 应同时包含 Client 与 Server 信息。只有客户端版本、没有服务端信息,说明“命令已安装”,但还不能判定 Docker 服务可用。

首次运行容器:分别验证执行能力与访问结果

先运行一次临时测试容器:

sudo docker run --rm hello-world

这一步会拉取镜像、创建并运行容器;正常完成时,输出中会出现 Hello from Docker!。--rm 表示容器结束后自动删除,因此随后在运行中容器列表里看不到它是正常的。它能验证基本的拉取和执行链路,但不能证明持续运行的应用已经可访问。

接着运行一个用于本机验证的 Nginx 容器:

sudo docker run -d \
  --name docker-first-web \
  -p 127.0.0.1:8080:80 \
  nginx:stable-alpine

这里将容器的 80 端口映射到服务器本机的 127.0.0.1:8080,并未把示例页面发布到公网。首次执行需要拉取镜像;命令成功返回容器 ID 之后,还要继续检查容器是否保持运行:

首次运行容器:分别验证执行能力与访问结果配图

sudo docker ps --filter 'name=^/docker-first-web$'
sudo docker inspect -f '{{.State.Status}} {{.State.Running}}' docker-first-web
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/

预期容器出现在 docker ps 中,状态检查输出 running true,HTTP 状态码为 200。这是示例预期结果,并非某台服务器的实际执行记录。如果服务器没有 curl,可先用前文的 APT 命令安装;不要仅凭 docker run -d 返回了容器 ID 就认定部署成功。

本例只做本机首次运行验证。若日后要对外提供服务,需要另行确定监听地址、访问控制和云平台安全规则;Docker 发布端口可能改变主机防火墙规则的实际效果,不应将本例的端口参数直接改成公网监听后投入使用。

失败时按发生位置排查

APT 无法安装或找不到软件包:先看 sudo apt-get update 的具体报错,再检查软件源文件、系统代号和网络连通性。域名解析失败、HTTPS 连接失败与签名失败是不同问题;签名失败不能通过禁用校验处理。如果 apt-cache policy docker-ce 没有候选版本,应先解决软件源问题。

失败时按发生位置排查配图

服务未启动,或命令只能显示 Client:查看服务状态和近期日志:

sudo systemctl status docker --no-pager
sudo journalctl -u docker -n 80 --no-pager

如果日志提示容器运行时、存储或配置错误,应根据实际报错处理。不要在不清楚影响范围时清空 /var/lib/docker;该目录可能包含镜像、容器和卷数据。

hello-world 无法拉取:区分“无法连接 Docker daemon”和“镜像下载失败”。前者回到服务状态检查;后者检查服务器的 DNS、出站 HTTPS 连通性、系统时间及磁盘空间。镜像仓库可能涉及多个服务地址,不宜仅凭某一个域名可访问就认定拉取链路正常。

Nginx 容器创建了但访问失败:先看容器状态和日志,再检查本机 8080 端口是否已被其他进程占用:

sudo docker ps -a --filter 'name=^/docker-first-web$'
sudo docker logs --tail 50 docker-first-web
sudo ss -ltn | grep ':8080' || true

容器状态为 Exited 时,应以容器日志为主要线索;端口已被占用时,先确认占用者,不要直接停止未知服务。如果提示容器名称已存在,也应先用 docker ps -a 确认它是否属于本次操作,避免误删原有容器。

验收与回滚检查项

完成部署后,可按以下项目验收,而不是只检查安装命令的退出状态:

验收与回滚检查项配图

  • 系统和软件源对应:确认是预期的 Ubuntu 版本、架构,docker-ce 有可安装版本。
  • 服务可用:systemctl is-active docker 为 active,sudo docker version 同时显示 Client 和 Server。
  • 容器可执行:hello-world 正常结束;示例 Nginx 容器显示 running true。
  • 应用可访问:在服务器本机访问 http://127.0.0.1:8080/ 返回 200;这不等同于公网访问验收。

若只需撤回本次示例容器,先确认 docker-first-web 确实由本次操作创建,且没有在其中保存需要保留的数据。下列命令会强制停止并删除该容器,不删除镜像,也不删除 Docker 服务:

sudo docker rm -f docker-first-web

若要连 Docker 安装一并撤回,前提是这台服务器在本文操作前确实没有 Docker 工作负载,且安装后没有新增其他依赖 Docker 或 containerd 的服务。先模拟卸载并检查 APT 拟变更的软件包,再决定是否执行;有需保留的数据时,应先备份并确认恢复方式。

sudo apt-get -s remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

确认影响范围仅涉及本次安装的软件包后,再执行卸载:

sudo apt-get remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

最后,仅当两个软件源文件确实是本次新建、且没有被其他配置使用时,才删除它们并更新索引:

sudo rm -f /etc/apt/sources.list.d/docker.list /etc/apt/keyrings/docker.asc
sudo apt-get update

卸载软件包不等于清除 /var/lib/docker 中的数据。本次回滚不执行数据目录删除,也不自动清理其他容器或镜像;回滚后的检查重点是示例容器已移除、Docker 服务不再运行,以及 APT 更新没有因遗留软件源配置而报错。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7741.html

相关推荐