---
title: "如何在Ubuntu Server安装 Docker & Docker Compose"
type: source
tags: [Docker, Ubuntu, 容器化, DevOps]
date: 2026-04-14
---

## Source File
- [[Home Office/如何在Ubuntu Server安装 docker & docker compose]]

## Summary（用中文描述）
- 核心主题：Ubuntu Server 上安装 Docker Engine 和 Docker Compose V2 的完整操作指南
- 问题域：Ubuntu Server 容器运行时环境搭建，是后续所有 Docker 部署类笔记的前置依赖
- 方法/机制：通过添加 Docker 官方 APT 仓库（GPG 密钥验证）→ 安装 Docker Engine 核心组件（dockerd、containerd、buildx、compose）→ 验证安装 → 配置非 root 用户权限
- 结论/价值：官方仓库安装确保版本最新，与 Ubuntu 内置旧版 docker.io 包完全兼容；Docker Compose V2 通过 `docker compose` 调用，与传统 `docker-compose` 命令分离

## Key Claims（用中文描述）
- Docker 官方 APT 仓库安装比 Ubuntu 默认仓库版本更新、功能更完整
- 安装 `docker-compose-plugin` 即获得 Docker Compose V2，使用 `docker compose` 而非 `docker-compose` 命令
- 将用户加入 `docker` 用户组后无需 `sudo` 即可运行 Docker 命令
- 完整安装包含 5 个组件包：docker-ce、docker-ce-cli、containerd.io、docker-buildx-plugin、docker-compose-plugin

## Key Quotes
> "The `docker-compose-plugin` installs Docker Compose V2, which is used via the command `docker compose` instead of `docker-compose`." — 源文档 Step 3 安装说明
> "Log out and log back in (or restart your terminal session, or run `newgrp docker`) for the changes to take effect." — 源文档 Step 5 用户组配置说明

## Key Concepts
- [[Docker Engine]]：容器运行时核心，包含 dockerd 守护进程、containerd 容器运行时、docker CLI 工具
- [[Docker Compose]]：多容器应用编排工具，V2 版本通过 `docker compose` 子命令调用
- [[containerd]]：Docker 的底层容器运行时，本文档安装 `containerd.io` 包
- [[GPG 密钥验证]]：Docker 官方通过 GPG 密钥（`/etc/apt/keyrings/docker.asc`）验证 APT 包来源真实性
- [[APT 仓库配置]]：通过在 `/etc/apt/sources.list.d/docker.list` 添加 Docker 官方仓库启用
- [[Docker 用户组]]：通过 `usermod -aG docker $USER` 将用户加入 docker 组实现免 sudo 运行

## Key Entities
- [[Docker]]：Docker 公司及其容器平台生态
- [[Docker-CE]]：Docker Community Edition 开源版本
- [[hello-world]]：官方验证镜像，用于测试 Docker 安装是否成功
- [[Docker-Buildx-Plugin]]：Docker 多平台镜像构建插件
- [[Docker-Compose-Plugin]]：Docker Compose V2 插件形式实现

## Connections
- [[Docker Engine]] ← 依赖 ← [[containerd]]（安装 containerd.io 包）
- [[Docker Engine]] ← 依赖 ← [[Docker-Buildx-Plugin]]（安装时一并安装）
- [[Docker Engine]] ← 依赖 ← [[Docker-Compose-Plugin]]（安装时一并安装）
- [[Ubuntu Server]] ← 目标平台 ← [[如何在ubuntu-server安装-docker-docker-compose]]（本文档）
- [[Docker]] ← 官方维护 ← [[Docker-CE]]（上游包来源）
- [[如何在ubuntu-server安装-docker-docker-compose]] → 前置依赖 → [[用docker安装it-tools]]（it-tools 需 Docker 环境）
- [[如何在ubuntu-server安装-docker-docker-compose]] → 前置依赖 → [[用docker安装portainer]]（Portainer 需 Docker 环境）
- [[如何在ubuntu-server安装-docker-docker-compose]] → 前置依赖 → [[用docker安装transmission]]（Transmission 需 Docker 环境）
- [[如何在ubuntu-server安装-docker-docker-compose]] → 前置依赖 → [[用docker中安装navidrome]]（Navidrome 需 Docker 环境）

## Contradictions
- 无冲突。文档聚焦 Ubuntu Server 单机安装流程，与企业级 Kubernetes 容器编排（[[Container-Lifecycle-Hardening]]）等来源属不同层次，无内容矛盾。