【教程5】Docker安装与避坑指南 — 含国内镜像加速方案（2026最新）

lpf2026

Docker 是现代应用部署的事实标准，也是部署 New API（我们的中转站核心程序）最便捷的方式。本文覆盖 Ubuntu/CentOS/Windows 三大平台的安装，并给出国内镜像加速的有效方案。

一、Docker 是什么？为什么用它？

简单理解：Docker 像一个轻量级的虚拟机，把程序和它需要的环境打包成一个「容器」，做到一键部署、环境隔离、不污染系统。对于API中转站来说：

• 一键部署：别人配好了 Docker 镜像，你只需一条命令就能跑起来
  
• 环境一致：不会出现「我电脑上能跑，服务器上不行」的问题
  
• 方便迁移：换服务器时，导出配置直接在新机器上跑
  
• 资源隔离：不会和服务器上的其他程序冲突
  

二、Ubuntu/Debian 安装 Docker（推荐）

1. # 1. 卸载旧版本（如果有的话）
2. sudo apt remove docker docker-engine docker.io containerd runc
4. # 2. 安装依赖
5. sudo apt update
6. sudo apt install -y ca-certificates curl gnupg lsb-release
8. # 3. 添加 Docker 官方 GPG 密钥
9. sudo mkdir -p /etc/apt/keyrings
10. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
12. # 4. 添加 Docker 仓库
13. echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
15. # 5. 安装 Docker
16. sudo apt update
17. sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
19. # 6. 验证安装
20. docker --version
21. docker compose version

复制代码

三、Docker Compose 安装（必需）

Docker Compose 让你通过一个 YAML 文件定义和运行多个容器。新版 Docker 已内置 docker compose（注意中间没有横杠），不需要单独安装 docker-compose。

1. # 验证 docker compose 是否可用
2. docker compose version
3. # 输出: Docker Compose version v2.x.x

复制代码

如果你的 Docker 版本较老，可以手动安装：

1. sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
2. sudo chmod +x /usr/local/bin/docker-compose

复制代码

四、国内服务器必做：配置镜像加速

国内服务器不配置镜像加速，拉取 Docker 镜像会极慢甚至超时！以下是 2026年5月 经验证有效的方案：

方案1：阿里云镜像加速（推荐，最稳定）

• 访问 阿里云容器镜像服务控制台（免费，需登录阿里云账号）
  
• 左侧菜单「镜像工具」→「镜像加速器」
  
• 你会看到专属加速地址，类似 https://xxxxxx.mirror.aliyuncs.com
  
• 在服务器上配置：
  

[code]# 创建配置目录
sudo mkdir -p /etc/docker

# 写入配置（将 xxxxxx 替换为你的加速器ID）
sudo tee /etc/docker/daemon.json