1. 项目概述在Ubuntu 22.04 LTSJammy Jellyfish上安装Docker及其配套工具Docker Compose v2是开发者搭建容器化开发环境的常见需求。Docker作为当前最流行的容器化平台能够实现应用程序的快速部署和隔离运行而Docker Compose则简化了多容器应用的管理。本文将详细介绍从零开始的全套安装流程包含国内镜像源配置、常见问题排查等实战经验。2. 环境准备2.1 系统要求确认首先确认你的Ubuntu 22.04系统满足以下条件64位x86架构可通过uname -m命令验证内核版本5.4以上uname -r查看至少2GB可用内存建议4GB以上已配置sudo权限的用户提示如果是在WSL2环境下运行Ubuntu 22.04需要确保Windows主机已启用虚拟化支持BIOS中开启VT-x/AMD-V且WSL2内核版本为5.10.60.1以上。2.2 更新系统软件包安装前务必更新现有软件包sudo apt update sudo apt upgrade -y sudo apt install -y apt-transport-https ca-certificates curl software-properties-common3. Docker引擎安装3.1 添加官方GPG密钥使用国内镜像源加速下载curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg3.2 设置稳定版仓库配置阿里云镜像源echo deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null3.3 安装Docker引擎执行安装命令sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io验证安装是否成功sudo docker run hello-world成功运行后会显示欢迎信息。4. Docker Compose v2安装4.1 下载二进制文件直接从GitHub下载最新版当前v2.23.3为例DOCKER_CONFIG${DOCKER_CONFIG:-$HOME/.docker} mkdir -p $DOCKER_CONFIG/cli-plugins curl -SL https://github.com/docker/compose/releases/download/v2.23.3/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose4.2 设置执行权限chmod x $DOCKER_CONFIG/cli-plugins/docker-compose4.3 验证安装docker compose version应显示类似Docker Compose version v2.23.3的版本信息。5. 配置优化5.1 非root用户操作将当前用户加入docker组sudo usermod -aG docker $USER newgrp docker # 立即生效5.2 国内镜像加速创建或修改/etc/docker/daemon.json{ registry-mirrors: [ https://registry.cn-hangzhou.aliyuncs.com, https://hub-mirror.c.163.com ], exec-opts: [native.cgroupdriversystemd], log-driver: json-file, log-opts: { max-size: 100m } }重启服务生效sudo systemctl daemon-reload sudo systemctl restart docker6. 常见问题排查6.1 服务启动失败如果遇到Failed to start docker.service错误检查内核模块lsmod | grep overlay若无输出需要加载模块sudo modprobe overlay查看详细日志journalctl -xe -u docker6.2 镜像拉取超时若遇到net/http: request canceled错误确认镜像源配置正确临时关闭防火墙测试sudo ufw disable6.3 WSL2特殊问题在WSL2中可能出现的问题解决DNS解析问题sudo tee /etc/wsl.conf EOF [network] generateResolvConf false EOF限制Docker内存使用sudo tee /etc/docker/daemon.json EOF { memory: 2GB } EOF7. 基础使用示例7.1 运行Nginx容器docker run -d -p 8080:80 --name my-nginx nginx访问http://localhost:8080应看到欢迎页面。7.2 Compose示例创建docker-compose.ymlversion: 3.8 services: web: image: nginx:alpine ports: - 8000:80 db: image: postgres:13 environment: POSTGRES_PASSWORD: example启动服务docker compose up -d8. 维护与升级8.1 查看Docker状态sudo systemctl status docker docker info8.2 清理无用资源定期执行docker system prune -f docker volume prune -f8.3 升级Docker版本sudo apt update sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io对于Docker Compose v2只需重新下载新版二进制文件替换即可。