韩国服务器如何安装Docker?仓库配置与容器启动怎样验证
韩国服务器安装 Docker,核心不是单纯执行安装命令,而是确认系统版本、配置可用的软件仓库,再分别验证 Docker Engine、镜像仓库访问和容器端口。下面以 Ubuntu 22.04/24.04 或 Debian 12 的 64 位服务器为例,使用 Docker 官方 APT 仓库完成首次安装,并启动一个 Nginx 测试容器。命令中的输出是预期样例,实际版本号会随仓库更新而变化,并不代表已经在某台服务器上执行。
韩国机房位置不会改变 Docker 的安装方式,但服务器必须能够正常解析域名并通过 HTTPS 访问软件仓库和镜像仓库。如果服务器有云平台安全组、机房防火墙或出口策略,还需要分别确认 443 端口的出站访问,以及测试服务端口的入站规则。
Docker 容器化部署既需要稳定的计算与存储资源,也依赖服务器所在地区和网络线路适配业务访问。A5idc数据提供韩国首尔及香港、日本、美国等地区的物理服务器,涵盖不同CPU、内存、存储和网络线路方案,可为网站、业务后台、数据库及容器应用提供部署基础;NVMe与SSD配置也适用于需要较快存储响应的业务环境。
一、准备条件与系统核验
1. 确认发行版、架构和管理权限
本步骤只覆盖 Ubuntu 和 Debian。先不要根据主机名称猜测系统版本,直接读取系统信息:
cat /etc/os-release
uname -m
sudo -v
Ubuntu 通常会看到 ID=ubuntu,Debian 通常会看到 ID=debian;uname -m 返回 x86_64 或 aarch64 时,分别对应常见的 amd64 或 arm64 软件包架构。sudo -v 没有报错,说明当前账号具备执行安装操作的权限。
如果系统是 Rocky Linux、AlmaLinux、CentOS 或其他发行版,不应直接套用下面的 APT 命令,应改用与该发行版对应的仓库配置。若系统是 Ubuntu 衍生版,也要先确认其底层版本和 Docker 仓库兼容性。
2. 检查网络和端口占用
Docker 安装阶段需要访问 download.docker.com,首次启动容器时还需要从镜像仓库拉取镜像。先检查 DNS 和本机测试端口:
getent hosts download.docker.com
getent hosts registry-1.docker.io
sudo ss -lntp | grep ':18080' || true
前两个命令能够返回 IP 地址,说明基础域名解析正常;最后一个命令没有输出,表示本机暂时没有进程监听 18080 端口。如果 18080 已被占用,后续可以改用 18081,但要同步修改验证命令。
这里的网络检查只用于确认安装和拉取镜像的必要连通性,不等于已经验证公网访问。若服务器采用云安全组,公网访问还要单独检查入站规则。
3. 识别已有 Docker 安装
不要在同一台服务器上混用发行版自带的 docker.io 和 Docker 官方仓库的 docker-ce。可以先查看已安装的软件包:
dpkg -l | grep -E 'docker|containerd' || true
如果已经存在运行中的 Docker 服务或重要容器,应先记录容器、镜像、卷和配置,再决定是继续使用原有安装,还是安排迁移窗口。下面的安装步骤适合尚未部署 Docker,或已经确认没有重要容器数据的环境。
二、配置 Docker APT 仓库
1. 安装仓库依赖
先更新系统软件包索引并安装证书和下载工具:
sudo apt-get update
sudo apt-get install -y ca-certificates curl
如果这里出现 Temporary failure resolving,问题在 DNS 或出站网络,不要继续执行仓库配置。若出现签名、证书或时间校验错误,应先检查系统时间、CA 证书和出口代理策略。
2. 写入密钥并生成仓库地址
以下命令会根据 /etc/os-release 自动选择 Ubuntu 或 Debian 仓库,并根据系统代号生成 APT 源。执行前应确认系统确实是支持的 Ubuntu 或 Debian 版本:
set -eu
. /etc/os-release
case "${ID:-}" in
ubuntu)
REPO_OS="ubuntu"
CODENAME="${UBUNTU_CODENAME:-${VERSION_CODENAME:-}}"
;;
debian)
REPO_OS="debian"
CODENAME="${VERSION_CODENAME:-}"
;;
*)
echo "仅支持 Ubuntu 或 Debian,当前系统为:${ID:-unknown}" >&2
exit 1
;;
esac
test -n "$CODENAME"
ARCH="$(dpkg --print-architecture)"
sudo install -m 0755 -d /etc/apt/keyrings
if [ -f /etc/apt/keyrings/docker.asc ]; then
sudo cp -a /etc/apt/keyrings/docker.asc "/etc/apt/keyrings/docker.asc.bak.$(date +%Y%m%d%H%M%S)"
fi
sudo curl -fsSL "https://download.docker.com/linux/${REPO_OS}/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
if [ -f /etc/apt/sources.list.d/docker.list ]; then
sudo cp -a /etc/apt/sources.list.d/docker.list "/etc/apt/sources.list.d/docker.list.bak.$(date +%Y%m%d%H%M%S)"
fi
echo "deb [arch=${ARCH} signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/${REPO_OS} ${CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
这段配置做了三件事:把 GPG 密钥放在 APT keyring 目录,为仓库源限定当前系统架构,并通过 signed-by 指定该源使用的密钥。它不会安装 Docker,也不会启动容器。
3. 验证仓库是否生效
先查看源文件内容,再刷新索引并检查候选版本:
cat /etc/apt/sources.list.d/docker.list
sudo apt-get update
apt-cache policy docker-ce
正常情况下,apt-cache policy docker-ce 会显示类似下面的结果:
Candidate: 5:27.x.x-1~ubuntu.22.04~jammy
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
版本号、Ubuntu 代号和架构会因服务器不同而变化。关键判断有两个:Candidate 不能是 (none),软件包来源应当指向刚配置的 Docker 仓库。如果候选版本为空,不要改用不明镜像源,应先检查系统代号、仓库地址、密钥权限和 apt-get update 的完整报错。

三、安装 Docker Engine 并验证服务
1. 安装 Engine、运行时和常用插件
确认仓库候选版本正常后再安装:
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
这里安装的主要组件分别负责 Docker 服务端、命令行客户端、容器运行时、镜像构建和 Compose 操作。仅完成这一步,还需要确认 systemd 服务已经运行。
2. 启动服务并检查状态
sudo systemctl enable --now docker
sudo systemctl is-enabled docker
sudo systemctl is-active docker
sudo docker version
sudo docker info --format 'Server={{.ServerVersion}} Storage={{.Driver}}'
sudo docker compose version
预期结果包括:is-enabled 返回 enabled,is-active 返回 active,docker version 同时能看到 Client 和 Server 信息,docker compose version 能显示 Compose 插件版本。docker info 能返回 Server 版本和存储驱动,说明 CLI 已经连接到 Docker daemon。
如果服务没有启动,先读取最近日志,而不是反复执行 start:
sudo journalctl -u docker -n 80 --no-pager
sudo systemctl status docker --no-pager -l
3. 用一次性容器验证 Engine 和镜像拉取
sudo docker run --rm hello-world
看到 Hello from Docker! 等欢迎信息,通常说明 Docker daemon 可用、镜像能够拉取并且容器能够创建和退出。--rm 会在容器退出后清理该测试容器,但不会删除已下载的镜像。
需要区分两个仓库:APT 仓库负责安装 Docker 软件包;docker run 使用的镜像则来自容器镜像仓库。APT 仓库验证成功,并不代表镜像仓库一定可访问,因此这一步不能省略。

四、启动容器并验证 HTTP 服务
1. 启动本机回环地址测试容器
为了避免首次测试时直接把服务暴露到公网,先将宿主机的 18080 只绑定到 127.0.0.1:
sudo docker run -d \
--name a5idc-docker-check \
--restart unless-stopped \
-p 127.0.0.1:18080:80 \
nginx:alpine
参数含义如下:-d 让容器在后台运行,--name 固定容器名称便于查询,--restart unless-stopped 允许主机重启后自动拉起,-p 127.0.0.1:18080:80 把宿主机回环地址的 18080 映射到容器的 80 端口。该命令创建的是测试容器,不应直接当作生产应用配置。
2. 验证容器状态和端口映射
sudo docker ps --filter 'name=^/a5idc-docker-check$'
sudo docker inspect -f 'status={{.State.Status}} health={{.State.Health.Status}}' a5idc-docker-check 2>/dev/null || sudo docker inspect -f 'status={{.State.Status}}' a5idc-docker-check
sudo ss -lntp | grep ':18080'
docker ps 应显示容器状态为 Up,inspect 至少应返回 status=running。由于 Nginx 镜像没有预设 Docker healthcheck,health 可能没有值,这不表示容器失败。ss 预期看到 127.0.0.1:18080,而不是一个无法确认用途的其他端口。
3. 验证容器内的 HTTP 响应
curl -fsS -o /tmp/a5idc-docker-check.html \
-w 'HTTP %{http_code}\n' \
http://127.0.0.1:18080/
head -n 3 /tmp/a5idc-docker-check.html
sudo docker logs --tail 30 a5idc-docker-check
预期状态码为 HTTP 200,HTML 文件开头通常能看到 Nginx 默认页面内容。此时已经分别验证了镜像拉取、容器创建、端口映射和应用响应。
如果确实需要从公网访问测试页面,应先确认服务内容不包含敏感信息,再将容器重建为监听所有接口的形式,并在云安全组和主机防火墙中仅开放必要的 TCP 端口:
sudo docker rm -f a5idc-docker-check
sudo docker run -d \
--name a5idc-docker-check \
--restart unless-stopped \
-p 18080:80 \
nginx:alpine
-p 18080:80 会监听宿主机所有可用地址,暴露范围明显大于 127.0.0.1:18080:80。如果只是验证 Docker 安装,不建议为了远程访问而扩大暴露面。公网验证还要从另一台网络环境执行 curl http://服务器公网IP:18080/,本机回环访问成功不能代替外部访问验证。

五、常见失败及处理顺序
1. 仓库没有候选版本
表现为 apt-cache policy docker-ce 的 Candidate 为 (none),或 apt-get update 报仓库不存在。先执行以下检查:
. /etc/os-release
printf 'ID=%s CODENAME=%s ARCH=%s\n' "${ID:-}" "${VERSION_CODENAME:-}" "$(dpkg --print-architecture)"
cat /etc/apt/sources.list.d/docker.list
重点检查仓库中的发行版路径、系统代号和架构是否对应。Ubuntu 应使用 ubuntu 路径,Debian 应使用 debian 路径。不要把 jammy、noble、bookworm 等代号混用。
2. 密钥、证书或签名错误
NO_PUBKEY、The following signatures couldn't be verified 通常表示密钥文件不完整、权限异常或源文件指向了错误密钥;证书错误则可能与系统时间或 CA 证书有关。可以检查:
ls -l /etc/apt/keyrings/docker.asc
date -u
sudo apt-get update
不要通过删除签名校验、使用不受信任的 HTTP 源来规避错误。若之前已有 docker.asc 或 docker.list,应优先恢复备份,再重新核对配置。
3. Docker 服务启动失败
先判断是服务问题还是命令权限问题:
sudo systemctl is-active docker
sudo journalctl -u docker -n 100 --no-pager
sudo docker info
如果 systemctl 返回 inactive 或 failed,重点看 daemon 日志;如果服务为 active 但普通用户执行 docker info 返回权限错误,可以暂时使用 sudo 验证。将用户加入 docker 组会赋予接近 root 的容器管理权限,属于权限变更,不应在多人共用服务器上随意执行。
4. 镜像拉取超时或被拒绝
docker run 失败而 APT 安装成功,通常说明 Docker 软件仓库可访问,但镜像仓库访问、DNS、出口策略或镜像名称仍有问题。检查:
getent hosts registry-1.docker.io
sudo docker pull nginx:alpine
sudo docker image ls nginx
pull access denied 还可能是镜像名称、标签或权限错误;i/o timeout 更偏向网络路径或出口策略问题。不要为了绕过错误直接替换成来源不明的镜像仓库,尤其是在需要验证镜像完整性的环境中。
5. 容器运行但 HTTP 无法访问
先由内向外排查:
sudo docker ps -a --filter 'name=^/a5idc-docker-check$'
sudo docker logs --tail 50 a5idc-docker-check
sudo ss -lntp | grep ':18080'
curl -v http://127.0.0.1:18080/
容器状态为 Exited 时,先看日志;状态为 Up 但端口没有监听,检查 -p 参数和容器是否使用了预期端口;本机访问成功而公网失败,则检查绑定地址、安全组、主机防火墙和运营商入站策略。若 18080 被其他进程占用,换用未占用端口并重新创建容器。
六、验收与回滚检查项
1. 首次部署验收
可以按下面的顺序保存验收结果:
| 检查对象 | 验收命令或依据 | 通过标准 |
|---|---|---|
| 系统环境 | cat /etc/os-release、uname -m | Ubuntu/Debian 与架构符合计划 |
| APT 仓库 | cat /etc/apt/sources.list.d/docker.list | 路径、代号、架构和签名密钥正确 |
| 软件候选版本 | apt-cache policy docker-ce | Candidate 非 (none),来源正确 |
| Docker 服务 | systemctl is-active docker | 返回 active |
| 开机启动 | systemctl is-enabled docker | 返回 enabled |
| Engine 连接 | docker info、docker version | 能取得 Server 信息 |
| 镜像拉取 | docker run --rm hello-world | 输出欢迎信息并正常退出 |
| 容器状态 | docker ps、docker inspect | 测试容器为 Up 或 running |
| HTTP 响应 | curl 返回状态码 | 本机访问返回 200 |
| 暴露范围 | ss -lntp | 符合预期的监听地址和端口 |
如果只要求验证 Docker Engine,到 hello-world 即可;如果还要验证端口和容器应用,再完成 Nginx 测试。不要把 docker ps 显示容器存在误认为应用已经可以访问,端口映射和 HTTP 响应仍需单独检查。
2. 只回滚测试容器
下面的命令只删除本教程创建的容器,影响范围是容器本身,不会删除 Nginx 镜像:
sudo docker rm -f a5idc-docker-check
如果容器中已经写入业务数据,执行删除前必须先导出数据或确认容器没有持久化内容。本示例没有挂载数据卷,因此适合在首次验证失败后清理。
3. 回滚仓库配置和软件包
如果决定撤销本次 Docker 安装,应先停止业务容器并备份重要的 Docker 卷、镜像清单和配置。仅针对没有业务容器的数据测试机,可以执行:
sudo systemctl disable --now docker
sudo apt-get remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -f /etc/apt/sources.list.d/docker.list
sudo rm -f /etc/apt/keyrings/docker.asc
sudo apt-get update
systemctl disable --now 会停止 Docker 服务,正在运行的容器将不可用;apt-get remove 会卸载软件包,但不要据此推断业务数据已经完成安全备份。不要直接执行 rm -rf /var/lib/docker,该目录可能包含镜像、容器元数据和卷数据。若原先存在 docker.list 或 docker.asc,应根据安装前生成的备份文件恢复,而不是留空或随意改写。
最终回滚检查包括:Docker 服务是否确实停止、仓库文件是否恢复到安装前状态、测试容器是否已删除,以及 /var/lib/docker 中的业务数据是否仍按计划保留。完成这些检查后,才算完成一次可验证、可回退的首次部署。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7825.html



