Auto-sync: 2026-04-27 00:02

wiki/sources/如何在ubuntu-server安装-docker-docker-compose.md

@@ -1,60 +1,54 @@
----
-title: "如何在Ubuntu Server安装 Docker & Docker Compose"
-type: source
-tags: [docker, ubuntu]
-date: 2026-04-14
----
-
-## Source File
-- [[raw/Home Office/如何在Ubuntu Server安装 docker & docker compose.md]]
-
-## Summary (用中文描述)
-- 核心主题：在 Ubuntu Server 上通过官方 apt 仓库安装 Docker Engine 和 Docker Compose V2 的完整流程
-- 问题域：服务器容器化环境搭建
-- 方法/机制：五步标准安装流程——卸载旧版 → 配置官方仓库 → 安装引擎 → 验证安装 → 配置非 root 用户
-- 结论/价值：推荐从 Docker 官方仓库安装以确保获取最新版本；Docker Compose V2 已集成到 docker-compose-plugin，使用 `docker compose` 命令
-
-## Key Claims (用中文描述)
-- Docker 官方仓库安装能确保获取最新版本的 Docker Engine
-- Docker Compose V2 通过 docker-compose-plugin 安装，使用 `docker compose` 命令而非 `docker-compose`
-- 将用户加入 docker 用户组后，可无需 sudo 直接运行 Docker 命令
-- 必须先安装 ca-certificates 和 curl 才能通过 HTTPS 添加 Docker GPG 密钥和仓库
-
-## Key Quotes
-> "It's generally best to install from Docker's official repositories to ensure you have the latest version." — 官方仓库安装的最佳实践理由
-> "The `docker-compose-plugin` installs **Docker Compose V2**, which is used via the command `docker compose` instead of `docker-compose`." — V2 版本命令变化说明
-> "By default, running Docker commands requires `sudo`. To run Docker without `sudo`, you can add your user to the **`docker` group`." — docker 用户组的作用
-
-## Key Concepts
-- [[Docker Engine]]：Docker 核心运行时，包含 dockerd 守护进程、CLI 和 containerd 容器运行时
-- [[Docker Compose]]：多容器 Docker 应用的定义和运行工具，V2 版本集成到 docker CLI（`docker compose`）
-- [[APT 仓库]]：Ubuntu/Debian 的软件包管理仓库，通过 /etc/apt/sources.list.d/ 配置
-- [[GPG 密钥]]：apt 仓库签名验证，确保软件包来源可信
-- [[Docker 用户组]]：Linux 用户组，允许组成员无需 sudo 直接运行 Docker 命令（存在安全风险）
-- [[containerd]]：Docker 的容器运行时底层引擎，独立项目
-
-## Key Entities
-- [[Docker CE]]：Docker Community Edition，Docker Engine 的开源版本
-- [[docker-ce-cli]]：Docker 命令行工具
-- [[docker-buildx-plugin]]：Docker 扩展插件，支持多平台镜像构建
-- [[docker-compose-plugin]]：Docker Compose V2 插件，替代独立的 docker-compose 包
-- [[containerd.io]]：containerd 的 Docker 打包版本
-- [[hello-world]]：Docker 官方测试镜像，用于验证安装是否成功
-
-## Connections
-- [[Docker Engine]] ← installed_by ← [[Docker CE on Ubuntu]]
-- [[Docker Compose]] ← extends ← [[Docker Engine]]
-- [[APT 仓库]] ← provides ← [[Docker CE]]
-- [[GPG 密钥]] ← authenticates ← [[APT 仓库]]
-- [[Ubuntu Server]] ← runs_on ← [[Docker Engine]]
-- [[Docker 用户组]] ← enables ← [[Docker Engine]] (non-root execution)
-- [[containerd]] ← powers ← [[Docker Engine]]
-
-## Contradictions
-- 无已知冲突
-
-## Related Sources
-- [[用docker安装transmission]] — Docker 部署实战
-- [[用docker安装portainer]] — Docker 可视化管理
-- [[用docker安装jellyfin]] — Docker 媒体服务
-- [[家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]] — Docker 监控堆栈
+---
+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]]）等来源属不同层次，无内容矛盾。