Linux服务器如何安装并部署Docker?从服务启动到容器运行怎样验证
在一台尚未安装 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



