⚡ Linux Debian 安装与配置 Docker

🐧 Linux Debian 安装与配置 Docker

---

📦 1. Docker 简介

Docker 是一个开源的应用容器引擎，它允许开发者将应用及其依赖打包到一个标准化的镜像中，然后在任何地方快速部署和运行。

Docker 利用了 Linux 的 容器技术（Namespaces 和 Cgroups） 来实现资源隔离，它相比传统虚拟机更轻量、更高效。Docker 支持微服务架构，适合用于持续集成 / 持续部署（CI/CD）流程中。

---

⬇️ 2. Docker 的下载安装

🧹 2.1 卸载旧版 Docker

执行以下命令卸载旧版 Docker

sudo apt remove docker docker-engine docker.io containerd runc

🔧 2.1 安装依赖

执行以下命令更新软件源并安装依赖

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

💡 -y 参数表示自动接受所有提示。

🔐 2.3 添加 Docker GPG 公钥

执行以下命令添加公钥

sudo mkidr -p /etc/apt/keyrings
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | \
  sudo gpg --dearmor -o /etc/apt/leyrings/docker.gpg 

⚠️ 这里使用阿里云的镜像，避免因国内网络限制无法访问官方 GPG 公钥。

🧭 2.4 添加 Docker 软件源

执行以下命令添加 Docker 软件源

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://mirrors.aliyun.com/docker-ce/linux/debian \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

⚠️ 使用国内源（阿里云）避免官方镜像不稳定或下载失败。

📥 2.5 安装 Docker

执行以下命令安装 Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plug

⚙️ 2.6 配置 Docker 服务

执行以下命令开启 Docker 服务并设置为开机自启服务

sudo systemctl start docker
sudo systemctl enable docker

✅ 2.7 验证安装

执行以下命令验证 Docker 是否成功安装

docker version
sudo docker run hello-world

⚠️本安装流程只适用于 Debian 版本的 Linux 系统，如果是 CentOS 或 Ubuntu 按照本流程安装不出意外的话会报错。其实 CentOS 和 Ubuntu 的流程整体差不多，就改一下GPG公钥和镜像源就行了。

---

⚙️ 3. Docker 的配置

🔁 3.1 配置镜像加速器

再没有任何配置的情况下，docker pull 是 100% 会失败的（docker run 需要 pull 的镜像也会失败）。

编辑配置文件 /etc/docker/daemon.json（如果不存在则创建）：

sudo mkdir -p /etc/docker
sudo nano /etc/docker/daemon.json

添加以下内容

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me"
  ]
}

保存后执行以下命令应用配置并重启 Docker 服务：

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker

🌐 3.2 设置 HTTP/HTTPS 代理

docker search 命令默认不会使用镜像加速器，而是通过终端直接访问 Docker Hub 的 API。

所以会出现即使你配置了镜像加速器，并且开启了网络代理（不仅开了KDE的，连终端的也开了），还是 dockers search 失败的情况。

所以我们需要为 Docker 服务设置系统级代理，先创建相关的配置文件

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

在 http-proxy.conf 中写入以下内容（以本地 Clash 代理端口为例）：

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"

然后重启服务让配置生效：

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker

⚠️docker search 命令成功运行还有一个前提条件，就是你的网络代理软件能正常工作。我这里用的是 Clash 作为网络代理，Clash相关的配置和使用方法详见
Linux Debian 安装与配置 Clash (没过审在我的垃圾箱里)

---

🛠️ 4. Docker 的基本用法

📦 镜像相关命令

命令	说明
docker search <关键字>	从 Docker Hub 搜索镜像（注意需设置代理）
docker pull <镜像名>	拉取远程镜像到本地
docker images	查看本地已有的镜像
docker rmi <镜像ID或镜像名>	删除本地镜像

🧱 容器相关命令

命令	说明
docker run -it <镜像名> /bin/bash	基于镜像启动容器，并进入交互式终端
docker ps	查看当前运行的容器
docker ps -a	查看所有容器（包括停止的）
docker stop <容器ID或容器名>	停止正在运行的容器
docker start <容器ID或容器名>	启动已存在但停止的容器
docker rm <容器ID或容器名>	删除指定容器

🧰 其他常用命令

命令	说明
docker exec -it <容器ID或容器名> /bin/bash	在运行中的容器中执行命令（常用于进入容器）
docker logs <容器ID或容器名>	查看容器日志输出
docker inspect <容器ID或镜像名>	获取容器或镜像的详细元信息

---

⚠️ 5. 注意事项

❌ WSL1 限制导致 Docker 无法运行

如果在 2.7 验证安装 的时候出现以下报错：

docker: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Head "http://%2Fvar%2Frun%2Fdocker.sock/_ping": 
dial unix /var/run/docker.sock: connect: permission denied

说明你在使用 WSL1 的系统， WSL1 本身无法运行 Docker 守护进程。建议使用 Windows 安装 Docker Desktop，或升级为 WSL2。

🐛 Linux 版本问题

如果在 2.5安装 docker 的时候出现以下报错：

E: The repository 'https://download.docker.com/linux/debian jammy Release' does not have a Release file.

说明系统不是 Debian，而可能是 Ubuntu（如 jammy 是 Ubuntu 22.04 的代号）。请确认 2.3 添加 Docker GPG 公钥 和 2.4 添加 Docker 软件源 中添加的 GPG 公钥和软件源是否为 Debian 的版本。

🌐 Docker 镜像失效

如果在 2.7 验证安装 的时候出现以下报错：

docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaitin

说明配置的 Docker 镜像失效导致无法连接上 Docker Hub，请检查 /etc/docker/daemon.json 是否配置了有效镜像：

解决方法请参考 3.1 配置镜像加速器

🕸️ Docker Search 卡住或 i/o timeout

docker search 不使用镜像加速器，直接访问 Docker API，需要配置 HTTP 代理才能正常工作，否则会因被墙而超时。

解决方法请参考 3.2 设置 HTTP/HTTPS 代理