1. 项目概述为什么我们需要一个高效的Docker环境如果你是一名开发者、运维工程师或者仅仅是技术爱好者那么“环境配置”这个词大概率是你职业生涯中的一大痛点。回想一下有多少次你被“在我机器上能跑”这句话折磨又有多少次因为操作系统、库版本、依赖项的细微差别导致一个项目从搭建到运行就耗费了大半天Docker的出现正是为了解决这个核心痛点——环境一致性。它通过容器化技术将应用及其所有依赖打包成一个标准化的单元确保在任何地方都能以相同的方式运行。今天要聊的就是如何在20分钟内从零开始搭建一个稳定、可用的Docker环境。这个目标听起来有点“标题党”但只要你跟着步骤走并且理解每一步背后的逻辑20分钟绝对绰绰有余。这不仅仅是安装一个软件更是为你后续的开发、测试、部署工作铺平道路。无论你是想在个人电脑的Windows、macOS上体验还是在生产环境的Linux服务器上部署其核心思想和步骤都是相通的。我们将避开官方文档中那些冗长的理论直接切入实操并重点讲解那些容易踩坑的地方比如虚拟化支持、镜像源加速、权限配置等高频问题。2. 核心概念与准备工作理解容器与虚拟机的本质区别在动手之前花两分钟理解Docker到底是什么能让你后面的操作更加清晰。很多人会把Docker容器和虚拟机VM搞混虽然它们的目标都是隔离环境但实现原理和资源开销天差地别。2.1 容器 vs. 虚拟机轻量与重量级的对决你可以把虚拟机想象成一套完整的“精装房”。它通过一个叫“Hypervisor”的软件在物理服务器宿主机上模拟出一整套完整的硬件环境CPU、内存、硬盘、网卡然后在这个模拟的硬件上安装一个完整的操作系统Guest OS最后再在Guest OS里运行你的应用。这个过程资源消耗大每个VM都要独占一份OS内核和系统资源启动速度也慢。而Docker容器更像是一个“标准化集装箱”。它不需要模拟硬件而是直接共享宿主机的操作系统内核。Docker引擎在宿主机OS上划出一个独立的“沙箱”即容器这个沙箱拥有自己的文件系统、网络配置、进程空间但内核是共用的。这意味着极致轻量容器只包含应用及其运行时依赖体积通常是MB级别而VM动辄GB。秒级启动因为无需启动整个操作系统容器可以在几秒内完成启动。高性能直接使用宿主机内核几乎没有性能损耗。所以Docker的核心价值在于一次构建处处运行。你本地构建好的镜像可以毫无障碍地运行在测试、预发布、生产服务器上。2.2 环境检查与工具选型选择最适合你的安装方式安装Docker前需要根据你的操作系统做出选择。主流分为三大阵营Linux如Ubuntu, CentOS这是Docker的原生和最佳运行环境。通常通过系统包管理器apt, yum直接安装最为简单纯粹。macOS由于macOS内核Darwin与Linux不同无法直接运行Linux容器。因此Docker Desktop for Mac在后台创建了一个轻量级的Linux虚拟机以前是HyperKit现在基于更新的虚拟化框架然后将Docker引擎运行在这个虚拟机里。对用户而言操作是无感的。Windows情况最复杂分两种模式Windows 10/11 专业版/企业版/教育版支持Hyper-V虚拟化。Docker Desktop for Windows可以运行在“Windows容器”模式运行原生Windows应用或“Linux容器”模式通过一个Hyper-V虚拟机运行Linux内核。我们通常使用后者。Windows 10/11 家庭版或其他旧版本默认不支持Hyper-V。旧版Docker Toolbox会使用VirtualBox创建虚拟机但已停止维护。现在Docker Desktop for Windows也支持基于WSL 2Windows Subsystem for Linux 2的后端这是目前家庭版用户的推荐方案性能更好集成度更高。准备工作清单对于Windows/macOS用户确保你的机器支持硬件虚拟化Intel VT-x / AMD-V并且在BIOS/UEFI中已启用。这是后续安装能否成功的关键。对于所有用户准备一个稳定的网络环境。首次安装和拉取镜像需要下载不少文件。权限准备在Linux上通常需要使用sudo来执行Docker命令。安装后我们会将当前用户加入docker用户组以避免每次都输入sudo。3. 分步实操三大平台的Docker安装与配置接下来我们分平台进行详细安装。我会以最常见的Ubuntu 20.04/22.04 LTSLinux、Windows 11WSL2后端和macOSApple Silicon芯片为例。其他发行版或版本步骤类似核心逻辑不变。3.1 LinuxUbuntu安装最直接的方式在Linux上安装Docker官方推荐使用仓库安装而不是下载deb包便于后续升级。步骤1卸载旧版本如果是全新安装可跳过为了避免冲突先清理可能存在的旧版本。sudo apt-get remove docker docker-engine docker.io containerd runccontainerd和runc是Docker依赖的底层容器运行时如果存在也一并移除。步骤2安装依赖工具并添加Docker官方GPG密钥这些工具用于通过HTTPS使用仓库以及验证软件包的签名。sudo apt-get update sudo apt-get install ca-certificates curl gnupg lsb-release添加Docker的官方GPG密钥确保下载的软件包来自可信源。sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg步骤3设置稳定的软件仓库这里我们设置稳定版stable仓库。注意命令中的$(lsb_release -cs)会自动获取你的Ubuntu代号如jammy。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步骤4安装Docker引擎更新包索引并安装最新版本的Docker引擎、命令行工具CLI以及容器运行时containerd。sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin注意如果你需要安装特定版本可以先使用apt-cache madison docker-ce查看可用版本然后使用sudo apt-get install docker-ceVERSION_STRING来安装。步骤5验证安装并管理Docker服务安装完成后Docker服务会自动启动。我们可以运行一个测试镜像来验证。sudo docker run hello-world如果看到“Hello from Docker!”等欢迎信息说明安装成功。 让Docker服务开机自启并查看其状态sudo systemctl enable docker sudo systemctl status docker步骤6解决权限问题关键步骤默认情况下运行docker命令需要sudo权限。为了避免每次输入密码可以将当前用户加入docker用户组。sudo usermod -aG docker $USER执行此命令后你必须完全注销当前会话并重新登录或者重启系统这个组权限变更才会生效。这是新手最容易忽略的一点导致执行docker ps时依然报权限错误。3.2 Windows基于WSL 2安装家庭版用户的福音对于Windows我们采用目前最主流、体验最好的WSL 2后端方案。步骤1启用WSL与虚拟机平台功能以管理员身份打开PowerShell或Windows终端执行以下命令。这会启用“适用于Linux的Windows子系统”和“虚拟机平台”两个Windows功能。wsl --install这个命令通常会默认安装Ubuntu发行版。如果只想启用功能可以分别执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart完成后必须重启计算机。步骤2设置WSL 2为默认版本并安装Linux发行版重启后打开PowerShell设置WSL 2为默认版本wsl --set-default-version 2如果尚未安装Linux发行版可以去Microsoft Store搜索“Ubuntu”并安装。安装后从开始菜单启动Ubuntu完成初始用户名和密码的设置。步骤3下载并安装Docker Desktop for Windows访问Docker官网docker.com下载Docker Desktop for Windows的安装包.exe文件。运行安装程序在配置页面中务必勾选“Use WSL 2 instead of Hyper-V”选项如果可用。安装完成后再次重启电脑。步骤4配置Docker Desktop与WSL集成启动Docker Desktop。在系统托盘找到Docker图标右键进入“Settings”。在General页面确保“Start Docker Desktop when you log in”被勾选方便日常使用。进入Resources-WSL Integration页面。在这里你会看到已安装的WSL发行版如Ubuntu。为你常用的发行版开启集成开关。这意味着你可以在WSL的终端里直接使用docker命令而Docker引擎实际上由Windows端的Docker Desktop提供实现了无缝集成。步骤5验证安装打开你的WSL终端如Ubuntu输入docker --version docker run hello-world如果能正确显示版本并运行测试容器说明安装配置成功。3.3 macOSApple Silicon安装原生ARM体验在搭载M1/M2/M3芯片的Mac上Docker Desktop提供了原生ARM64支持性能非常好。步骤1下载安装包访问Docker官网下载适用于Apple Silicon芯片Apple芯片的Docker Desktop for Mac安装包.dmg文件。步骤2安装与基础配置双击下载的.dmg文件将Docker图标拖拽到“Applications”文件夹中完成安装。然后从“应用程序”文件夹中启动Docker Desktop。 首次启动时系统会请求权限包括需要你的密码来安装网络助手等组件全部允许即可。启动后你会在屏幕顶部菜单栏看到Docker的鲸鱼图标。步骤3验证与偏好设置打开终端Terminal输入命令验证docker --version docker run --platform linux/amd64 hello-world注意由于hello-world镜像可能没有提供ARM64版本我们通过--platform linux/amd64参数显式指定使用AMD64架构的镜像。Docker Desktop会在后台通过Rosetta 2进行转译运行这对用户是透明的。对于大多数常见的Linux镜像如nginx, redis, mysql现在都有官方的ARM64版本直接运行即可无需指定平台。进入Docker Desktop的Preferences设置在General中建议勾选“Start Docker Desktop when you log in”。在Resources中可以根据你的机器配置调整分配给Docker的CPU核心数、内存和交换空间大小。默认设置通常够用。4. 必做优化与核心配置让Docker飞起来安装完成只是第一步合理的配置能极大提升日常使用体验。这里有几个关乎效率和稳定性的关键配置。4.1 配置国内镜像加速器从Docker Hub拉取镜像时国内网络速度可能很慢甚至超时。配置一个国内的镜像加速器是必选项。这里以阿里云镜像加速器为例你也可以使用中科大、网易云等加速源。1. 获取加速器地址你需要注册一个阿里云账号免费进入“容器镜像服务”控制台在“镜像工具”-“镜像加速器”菜单下就能看到为你分配的专属加速器地址格式如https://xxxx.mirror.aliyuncs.com。2. 配置加速器Linux编辑或创建Docker的守护进程配置文件。sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://xxxx.mirror.aliyuncs.com] } EOF然后重启Docker服务使配置生效sudo systemctl daemon-reload sudo systemctl restart dockerDocker Desktop (Windows/macOS)更加简单。点击系统托盘Docker图标 - “Settings” - “Docker Engine”。你会看到一个JSON格式的配置窗口。在已有的配置中找到或添加registry-mirrors数组将你的加速器地址填入。点击“Apply Restart”保存并重启Docker引擎。验证加速器是否生效docker info在输出信息中查找Registry Mirrors部分如果能看到你配置的地址说明成功。4.2 管理磁盘空间Docker DesktopDocker会占用大量磁盘空间来存储镜像和容器数据。在Windows和macOS的Docker Desktop中这个数据默认存放在一个虚拟磁盘文件里。查看占用在Docker Desktop的Dashboard界面通常会有磁盘使用情况的概览。清理空间手动清理在终端执行以下命令可以清理掉所有已停止的容器、未被任何容器引用的网络、构建缓存dangling images以及未被引用的镜像。docker system prune -a -f警告-a参数会删除所有未被容器使用的镜像包括你可能暂时没用但以后想用的中间镜像。如果不加-a则只删除“悬空”镜像没有标签且未被引用的镜像层。调整磁盘大小在Docker Desktop的Settings - Resources - Advanced中可以调整虚拟磁盘的大小上限。如果经常提示磁盘空间不足可以适当调大。4.3 常用命令速查与理解安装配置好后掌握几个最核心的命令就能开始工作了。镜像相关docker pull nginx:latest拉取指定镜像nginx是镜像名latest是标签。docker images列出本地所有镜像。docker rmi image_id删除指定的本地镜像。容器生命周期docker run -d -p 80:80 --name my-nginx nginx运行容器。-d后台运行detached mode。-p 80:80端口映射将宿主机的80端口映射到容器的80端口。--name给容器起个名字便于管理。docker ps查看正在运行的容器。加-a参数查看所有包括已停止的。docker stop container_name停止一个运行中的容器。docker start container_name启动一个已停止的容器。docker rm container_name删除一个已停止的容器。进入容器与查看日志docker exec -it my-nginx /bin/bash以交互模式进入一个正在运行的容器内部假设容器内有bash。docker logs -f my-nginx查看并持续跟踪-f容器的日志输出这是调试应用问题的首要手段。5. 高频问题排查与解决实录即使按照教程操作你也可能会遇到一些常见问题。这里记录了几个最典型的情况和解决方案。5.1 Docker Desktop启动失败虚拟化支持未检测到这是Windows用户安装后最常遇到的错误提示信息通常是“Docker Desktop failed to start because virtualization support wasnt detected”。根本原因你的电脑的硬件虚拟化功能Intel VT-x / AMD-V没有开启或者被其他软件如某些安卓模拟器、旧版Hyper-V占用了。排查与解决步骤检查BIOS/UEFI设置重启电脑进入BIOS/UEFI设置界面开机时按F2、Del、F10等键因品牌而异。在“Advanced”高级或“Security”安全或“Configuration”配置选项卡下找到“Intel Virtualization Technology”Intel VT-x或“AMD SVM”选项确保其状态为Enabled。保存并退出。检查Windows功能在Windows搜索框输入“启用或关闭Windows功能”确保以下两项只勾选一项避免冲突Hyper-V如果你使用的是Windows专业版及以上且计划使用Hyper-V后端则勾选此项。Windows Hypervisor Platform 和 虚拟机平台如果你使用WSL 2后端则勾选这两项并取消勾选Hyper-V。注意WSL 2和传统的Hyper-V虚拟机可以在启用“虚拟机平台”的前提下共存但为了减少潜在冲突如果只用DockerWSL2关闭Hyper-V是更干净的选择。关闭冲突软件某些第三方虚拟化软件如VMware Workstation、VirtualBox的某些版本或一些安卓模拟器如雷电模拟器可能与Hyper-V/WSL2不兼容。尝试暂时关闭或卸载它们。以管理员身份重置网络有时网络组件冲突也会导致启动失败。在管理员PowerShell中执行netsh winsock reset然后重启电脑。彻底重装如果以上都不行尝试使用官方提供的清理工具如“Docker Desktop Cleanup”工具彻底卸载Docker Desktop然后重新安装。5.2 拉取镜像速度慢或超时现象执行docker pull时速度极慢或最终报错net/http: request canceled (Client.Timeout exceeded)。解决方案首要检查镜像加速器确保已按照4.1节正确配置了国内镜像加速器并且执行docker info确认配置已生效。检查DNS尝试将系统的DNS服务器改为114.114.114.114或8.8.8.8排除DNS解析问题。使用特定镜像标签有些镜像的latest标签可能很大。尝试拉取一个更具体的、体积可能更小的标签如alpine版本。docker pull nginx:alpine手动下载镜像文件对于极端情况可以尝试在其他网络环境好的机器上拉取镜像然后导出为文件再传输到目标机器导入。在A机器docker save -o nginx.tar nginx:latest将nginx.tar复制到B机器docker load -i nginx.tar5.3 权限错误Got permission denied现象在Linux上执行docker ps或其他命令时报错Got permission denied while trying to connect to the Docker daemon socket。原因与解决当前用户不在docker用户组中因此无权访问Docker守护进程的Unix套接字。确认解决方案已执行回顾3.1 步骤6你是否执行了sudo usermod -aG docker $USER命令关键一步生效组权限执行上述命令后必须注销当前用户并重新登录或者重启电脑。仅仅新开一个终端标签页是没用的因为组信息是在用户登录时加载的。验证重新登录后执行groups命令查看输出中是否包含docker组。如果包含再执行docker ps应该就不会报权限错误了。5.4 端口已被占用现象运行容器时报错Error response from daemon: driver failed programming external connectivity on endpoint...: Bind for 0.0.0.0:80 failed: port is already allocated。排查这意味着宿主机你的电脑的80端口已经被其他程序可能是另一个nginx容器、Apache、IIS等占用了。解决更换宿主机端口这是最简单的办法。将映射关系改为一个未被占用的端口例如-p 8080:80这样你访问http://localhost:8080就能看到容器内的服务。停止占用端口的进程在Linux/macOS上使用sudo lsof -i:80或sudo netstat -tulpn | grep :80查找占用80端口的进程ID然后使用kill命令停止它确保你了解该进程的作用避免误杀系统服务。在Windows上使用netstat -ano | findstr :80查找PID然后在任务管理器中结束对应进程。先停止冲突的容器如果是另一个Docker容器占用了端口使用docker ps找到它然后用docker stop container_id停止它。6. 第一个实战用Docker运行一个Web应用理论说再多不如动手跑一个。我们来完成一个经典操作用Docker运行一个Nginx web服务器并定制一个简单的欢迎页面。目标启动一个Nginx容器将本地的HTML文件挂载到容器中实现通过浏览器访问自定义页面。步骤1准备一个自定义的HTML文件在你的工作目录例如~/docker-demo下创建一个简单的index.html文件。mkdir ~/docker-demo cd ~/docker-demo cat index.html EOF !DOCTYPE html html head titleMy First Docker App/title /head body h1Hello from inside a Docker Container!/h1 pThis page is served by Nginx running in Docker./p /body /html EOF步骤2运行Nginx容器并挂载本地文件Nginx容器默认的网页文件目录是/usr/share/nginx/html。我们通过-v参数将本地的~/docker-demo目录挂载到容器的这个目录。docker run -d \ --name my-web \ -p 8080:80 \ -v ~/docker-demo:/usr/share/nginx/html \ nginx:alpine-d后台运行。--name my-web容器命名为my-web。-p 8080:80将宿主机的8080端口映射到容器的80端口。-v ~/docker-demo:/usr/share/nginx/html这是关键。-v建立了数据卷挂载将本地目录同步到容器内。这样你在本地修改index.html容器内立即生效无需重建镜像。nginx:alpine使用体积更小的Alpine Linux版本的Nginx镜像。步骤3验证打开你的浏览器访问http://localhost:8080。你应该能看到刚才创建的“Hello from inside a Docker Container!”页面。步骤4动态更新内容现在尝试修改本地的index.html文件比如在body里加一行pUpdated in real time!/p。保存文件后刷新浏览器页面你会发现更改立即生效了。这展示了Docker数据卷挂载在开发中的巨大便利性。步骤5清理实验完成后停止并删除容器。docker stop my-web docker rm my-web这个简单的实战涵盖了Docker最核心的几种用法拉取镜像、运行容器、端口映射、数据卷挂载。通过这个流程你已经能体会到Docker如何将应用与环境封装并通过简单的命令进行部署和管理。
1. 项目概述为什么我们需要一个高效的Docker环境如果你是一名开发者、运维工程师或者仅仅是技术爱好者那么“环境配置”这个词大概率是你职业生涯中的一大痛点。回想一下有多少次你被“在我机器上能跑”这句话折磨又有多少次因为操作系统、库版本、依赖项的细微差别导致一个项目从搭建到运行就耗费了大半天Docker的出现正是为了解决这个核心痛点——环境一致性。它通过容器化技术将应用及其所有依赖打包成一个标准化的单元确保在任何地方都能以相同的方式运行。今天要聊的就是如何在20分钟内从零开始搭建一个稳定、可用的Docker环境。这个目标听起来有点“标题党”但只要你跟着步骤走并且理解每一步背后的逻辑20分钟绝对绰绰有余。这不仅仅是安装一个软件更是为你后续的开发、测试、部署工作铺平道路。无论你是想在个人电脑的Windows、macOS上体验还是在生产环境的Linux服务器上部署其核心思想和步骤都是相通的。我们将避开官方文档中那些冗长的理论直接切入实操并重点讲解那些容易踩坑的地方比如虚拟化支持、镜像源加速、权限配置等高频问题。2. 核心概念与准备工作理解容器与虚拟机的本质区别在动手之前花两分钟理解Docker到底是什么能让你后面的操作更加清晰。很多人会把Docker容器和虚拟机VM搞混虽然它们的目标都是隔离环境但实现原理和资源开销天差地别。2.1 容器 vs. 虚拟机轻量与重量级的对决你可以把虚拟机想象成一套完整的“精装房”。它通过一个叫“Hypervisor”的软件在物理服务器宿主机上模拟出一整套完整的硬件环境CPU、内存、硬盘、网卡然后在这个模拟的硬件上安装一个完整的操作系统Guest OS最后再在Guest OS里运行你的应用。这个过程资源消耗大每个VM都要独占一份OS内核和系统资源启动速度也慢。而Docker容器更像是一个“标准化集装箱”。它不需要模拟硬件而是直接共享宿主机的操作系统内核。Docker引擎在宿主机OS上划出一个独立的“沙箱”即容器这个沙箱拥有自己的文件系统、网络配置、进程空间但内核是共用的。这意味着极致轻量容器只包含应用及其运行时依赖体积通常是MB级别而VM动辄GB。秒级启动因为无需启动整个操作系统容器可以在几秒内完成启动。高性能直接使用宿主机内核几乎没有性能损耗。所以Docker的核心价值在于一次构建处处运行。你本地构建好的镜像可以毫无障碍地运行在测试、预发布、生产服务器上。2.2 环境检查与工具选型选择最适合你的安装方式安装Docker前需要根据你的操作系统做出选择。主流分为三大阵营Linux如Ubuntu, CentOS这是Docker的原生和最佳运行环境。通常通过系统包管理器apt, yum直接安装最为简单纯粹。macOS由于macOS内核Darwin与Linux不同无法直接运行Linux容器。因此Docker Desktop for Mac在后台创建了一个轻量级的Linux虚拟机以前是HyperKit现在基于更新的虚拟化框架然后将Docker引擎运行在这个虚拟机里。对用户而言操作是无感的。Windows情况最复杂分两种模式Windows 10/11 专业版/企业版/教育版支持Hyper-V虚拟化。Docker Desktop for Windows可以运行在“Windows容器”模式运行原生Windows应用或“Linux容器”模式通过一个Hyper-V虚拟机运行Linux内核。我们通常使用后者。Windows 10/11 家庭版或其他旧版本默认不支持Hyper-V。旧版Docker Toolbox会使用VirtualBox创建虚拟机但已停止维护。现在Docker Desktop for Windows也支持基于WSL 2Windows Subsystem for Linux 2的后端这是目前家庭版用户的推荐方案性能更好集成度更高。准备工作清单对于Windows/macOS用户确保你的机器支持硬件虚拟化Intel VT-x / AMD-V并且在BIOS/UEFI中已启用。这是后续安装能否成功的关键。对于所有用户准备一个稳定的网络环境。首次安装和拉取镜像需要下载不少文件。权限准备在Linux上通常需要使用sudo来执行Docker命令。安装后我们会将当前用户加入docker用户组以避免每次都输入sudo。3. 分步实操三大平台的Docker安装与配置接下来我们分平台进行详细安装。我会以最常见的Ubuntu 20.04/22.04 LTSLinux、Windows 11WSL2后端和macOSApple Silicon芯片为例。其他发行版或版本步骤类似核心逻辑不变。3.1 LinuxUbuntu安装最直接的方式在Linux上安装Docker官方推荐使用仓库安装而不是下载deb包便于后续升级。步骤1卸载旧版本如果是全新安装可跳过为了避免冲突先清理可能存在的旧版本。sudo apt-get remove docker docker-engine docker.io containerd runccontainerd和runc是Docker依赖的底层容器运行时如果存在也一并移除。步骤2安装依赖工具并添加Docker官方GPG密钥这些工具用于通过HTTPS使用仓库以及验证软件包的签名。sudo apt-get update sudo apt-get install ca-certificates curl gnupg lsb-release添加Docker的官方GPG密钥确保下载的软件包来自可信源。sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg步骤3设置稳定的软件仓库这里我们设置稳定版stable仓库。注意命令中的$(lsb_release -cs)会自动获取你的Ubuntu代号如jammy。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步骤4安装Docker引擎更新包索引并安装最新版本的Docker引擎、命令行工具CLI以及容器运行时containerd。sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin注意如果你需要安装特定版本可以先使用apt-cache madison docker-ce查看可用版本然后使用sudo apt-get install docker-ceVERSION_STRING来安装。步骤5验证安装并管理Docker服务安装完成后Docker服务会自动启动。我们可以运行一个测试镜像来验证。sudo docker run hello-world如果看到“Hello from Docker!”等欢迎信息说明安装成功。 让Docker服务开机自启并查看其状态sudo systemctl enable docker sudo systemctl status docker步骤6解决权限问题关键步骤默认情况下运行docker命令需要sudo权限。为了避免每次输入密码可以将当前用户加入docker用户组。sudo usermod -aG docker $USER执行此命令后你必须完全注销当前会话并重新登录或者重启系统这个组权限变更才会生效。这是新手最容易忽略的一点导致执行docker ps时依然报权限错误。3.2 Windows基于WSL 2安装家庭版用户的福音对于Windows我们采用目前最主流、体验最好的WSL 2后端方案。步骤1启用WSL与虚拟机平台功能以管理员身份打开PowerShell或Windows终端执行以下命令。这会启用“适用于Linux的Windows子系统”和“虚拟机平台”两个Windows功能。wsl --install这个命令通常会默认安装Ubuntu发行版。如果只想启用功能可以分别执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart完成后必须重启计算机。步骤2设置WSL 2为默认版本并安装Linux发行版重启后打开PowerShell设置WSL 2为默认版本wsl --set-default-version 2如果尚未安装Linux发行版可以去Microsoft Store搜索“Ubuntu”并安装。安装后从开始菜单启动Ubuntu完成初始用户名和密码的设置。步骤3下载并安装Docker Desktop for Windows访问Docker官网docker.com下载Docker Desktop for Windows的安装包.exe文件。运行安装程序在配置页面中务必勾选“Use WSL 2 instead of Hyper-V”选项如果可用。安装完成后再次重启电脑。步骤4配置Docker Desktop与WSL集成启动Docker Desktop。在系统托盘找到Docker图标右键进入“Settings”。在General页面确保“Start Docker Desktop when you log in”被勾选方便日常使用。进入Resources-WSL Integration页面。在这里你会看到已安装的WSL发行版如Ubuntu。为你常用的发行版开启集成开关。这意味着你可以在WSL的终端里直接使用docker命令而Docker引擎实际上由Windows端的Docker Desktop提供实现了无缝集成。步骤5验证安装打开你的WSL终端如Ubuntu输入docker --version docker run hello-world如果能正确显示版本并运行测试容器说明安装配置成功。3.3 macOSApple Silicon安装原生ARM体验在搭载M1/M2/M3芯片的Mac上Docker Desktop提供了原生ARM64支持性能非常好。步骤1下载安装包访问Docker官网下载适用于Apple Silicon芯片Apple芯片的Docker Desktop for Mac安装包.dmg文件。步骤2安装与基础配置双击下载的.dmg文件将Docker图标拖拽到“Applications”文件夹中完成安装。然后从“应用程序”文件夹中启动Docker Desktop。 首次启动时系统会请求权限包括需要你的密码来安装网络助手等组件全部允许即可。启动后你会在屏幕顶部菜单栏看到Docker的鲸鱼图标。步骤3验证与偏好设置打开终端Terminal输入命令验证docker --version docker run --platform linux/amd64 hello-world注意由于hello-world镜像可能没有提供ARM64版本我们通过--platform linux/amd64参数显式指定使用AMD64架构的镜像。Docker Desktop会在后台通过Rosetta 2进行转译运行这对用户是透明的。对于大多数常见的Linux镜像如nginx, redis, mysql现在都有官方的ARM64版本直接运行即可无需指定平台。进入Docker Desktop的Preferences设置在General中建议勾选“Start Docker Desktop when you log in”。在Resources中可以根据你的机器配置调整分配给Docker的CPU核心数、内存和交换空间大小。默认设置通常够用。4. 必做优化与核心配置让Docker飞起来安装完成只是第一步合理的配置能极大提升日常使用体验。这里有几个关乎效率和稳定性的关键配置。4.1 配置国内镜像加速器从Docker Hub拉取镜像时国内网络速度可能很慢甚至超时。配置一个国内的镜像加速器是必选项。这里以阿里云镜像加速器为例你也可以使用中科大、网易云等加速源。1. 获取加速器地址你需要注册一个阿里云账号免费进入“容器镜像服务”控制台在“镜像工具”-“镜像加速器”菜单下就能看到为你分配的专属加速器地址格式如https://xxxx.mirror.aliyuncs.com。2. 配置加速器Linux编辑或创建Docker的守护进程配置文件。sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://xxxx.mirror.aliyuncs.com] } EOF然后重启Docker服务使配置生效sudo systemctl daemon-reload sudo systemctl restart dockerDocker Desktop (Windows/macOS)更加简单。点击系统托盘Docker图标 - “Settings” - “Docker Engine”。你会看到一个JSON格式的配置窗口。在已有的配置中找到或添加registry-mirrors数组将你的加速器地址填入。点击“Apply Restart”保存并重启Docker引擎。验证加速器是否生效docker info在输出信息中查找Registry Mirrors部分如果能看到你配置的地址说明成功。4.2 管理磁盘空间Docker DesktopDocker会占用大量磁盘空间来存储镜像和容器数据。在Windows和macOS的Docker Desktop中这个数据默认存放在一个虚拟磁盘文件里。查看占用在Docker Desktop的Dashboard界面通常会有磁盘使用情况的概览。清理空间手动清理在终端执行以下命令可以清理掉所有已停止的容器、未被任何容器引用的网络、构建缓存dangling images以及未被引用的镜像。docker system prune -a -f警告-a参数会删除所有未被容器使用的镜像包括你可能暂时没用但以后想用的中间镜像。如果不加-a则只删除“悬空”镜像没有标签且未被引用的镜像层。调整磁盘大小在Docker Desktop的Settings - Resources - Advanced中可以调整虚拟磁盘的大小上限。如果经常提示磁盘空间不足可以适当调大。4.3 常用命令速查与理解安装配置好后掌握几个最核心的命令就能开始工作了。镜像相关docker pull nginx:latest拉取指定镜像nginx是镜像名latest是标签。docker images列出本地所有镜像。docker rmi image_id删除指定的本地镜像。容器生命周期docker run -d -p 80:80 --name my-nginx nginx运行容器。-d后台运行detached mode。-p 80:80端口映射将宿主机的80端口映射到容器的80端口。--name给容器起个名字便于管理。docker ps查看正在运行的容器。加-a参数查看所有包括已停止的。docker stop container_name停止一个运行中的容器。docker start container_name启动一个已停止的容器。docker rm container_name删除一个已停止的容器。进入容器与查看日志docker exec -it my-nginx /bin/bash以交互模式进入一个正在运行的容器内部假设容器内有bash。docker logs -f my-nginx查看并持续跟踪-f容器的日志输出这是调试应用问题的首要手段。5. 高频问题排查与解决实录即使按照教程操作你也可能会遇到一些常见问题。这里记录了几个最典型的情况和解决方案。5.1 Docker Desktop启动失败虚拟化支持未检测到这是Windows用户安装后最常遇到的错误提示信息通常是“Docker Desktop failed to start because virtualization support wasnt detected”。根本原因你的电脑的硬件虚拟化功能Intel VT-x / AMD-V没有开启或者被其他软件如某些安卓模拟器、旧版Hyper-V占用了。排查与解决步骤检查BIOS/UEFI设置重启电脑进入BIOS/UEFI设置界面开机时按F2、Del、F10等键因品牌而异。在“Advanced”高级或“Security”安全或“Configuration”配置选项卡下找到“Intel Virtualization Technology”Intel VT-x或“AMD SVM”选项确保其状态为Enabled。保存并退出。检查Windows功能在Windows搜索框输入“启用或关闭Windows功能”确保以下两项只勾选一项避免冲突Hyper-V如果你使用的是Windows专业版及以上且计划使用Hyper-V后端则勾选此项。Windows Hypervisor Platform 和 虚拟机平台如果你使用WSL 2后端则勾选这两项并取消勾选Hyper-V。注意WSL 2和传统的Hyper-V虚拟机可以在启用“虚拟机平台”的前提下共存但为了减少潜在冲突如果只用DockerWSL2关闭Hyper-V是更干净的选择。关闭冲突软件某些第三方虚拟化软件如VMware Workstation、VirtualBox的某些版本或一些安卓模拟器如雷电模拟器可能与Hyper-V/WSL2不兼容。尝试暂时关闭或卸载它们。以管理员身份重置网络有时网络组件冲突也会导致启动失败。在管理员PowerShell中执行netsh winsock reset然后重启电脑。彻底重装如果以上都不行尝试使用官方提供的清理工具如“Docker Desktop Cleanup”工具彻底卸载Docker Desktop然后重新安装。5.2 拉取镜像速度慢或超时现象执行docker pull时速度极慢或最终报错net/http: request canceled (Client.Timeout exceeded)。解决方案首要检查镜像加速器确保已按照4.1节正确配置了国内镜像加速器并且执行docker info确认配置已生效。检查DNS尝试将系统的DNS服务器改为114.114.114.114或8.8.8.8排除DNS解析问题。使用特定镜像标签有些镜像的latest标签可能很大。尝试拉取一个更具体的、体积可能更小的标签如alpine版本。docker pull nginx:alpine手动下载镜像文件对于极端情况可以尝试在其他网络环境好的机器上拉取镜像然后导出为文件再传输到目标机器导入。在A机器docker save -o nginx.tar nginx:latest将nginx.tar复制到B机器docker load -i nginx.tar5.3 权限错误Got permission denied现象在Linux上执行docker ps或其他命令时报错Got permission denied while trying to connect to the Docker daemon socket。原因与解决当前用户不在docker用户组中因此无权访问Docker守护进程的Unix套接字。确认解决方案已执行回顾3.1 步骤6你是否执行了sudo usermod -aG docker $USER命令关键一步生效组权限执行上述命令后必须注销当前用户并重新登录或者重启电脑。仅仅新开一个终端标签页是没用的因为组信息是在用户登录时加载的。验证重新登录后执行groups命令查看输出中是否包含docker组。如果包含再执行docker ps应该就不会报权限错误了。5.4 端口已被占用现象运行容器时报错Error response from daemon: driver failed programming external connectivity on endpoint...: Bind for 0.0.0.0:80 failed: port is already allocated。排查这意味着宿主机你的电脑的80端口已经被其他程序可能是另一个nginx容器、Apache、IIS等占用了。解决更换宿主机端口这是最简单的办法。将映射关系改为一个未被占用的端口例如-p 8080:80这样你访问http://localhost:8080就能看到容器内的服务。停止占用端口的进程在Linux/macOS上使用sudo lsof -i:80或sudo netstat -tulpn | grep :80查找占用80端口的进程ID然后使用kill命令停止它确保你了解该进程的作用避免误杀系统服务。在Windows上使用netstat -ano | findstr :80查找PID然后在任务管理器中结束对应进程。先停止冲突的容器如果是另一个Docker容器占用了端口使用docker ps找到它然后用docker stop container_id停止它。6. 第一个实战用Docker运行一个Web应用理论说再多不如动手跑一个。我们来完成一个经典操作用Docker运行一个Nginx web服务器并定制一个简单的欢迎页面。目标启动一个Nginx容器将本地的HTML文件挂载到容器中实现通过浏览器访问自定义页面。步骤1准备一个自定义的HTML文件在你的工作目录例如~/docker-demo下创建一个简单的index.html文件。mkdir ~/docker-demo cd ~/docker-demo cat index.html EOF !DOCTYPE html html head titleMy First Docker App/title /head body h1Hello from inside a Docker Container!/h1 pThis page is served by Nginx running in Docker./p /body /html EOF步骤2运行Nginx容器并挂载本地文件Nginx容器默认的网页文件目录是/usr/share/nginx/html。我们通过-v参数将本地的~/docker-demo目录挂载到容器的这个目录。docker run -d \ --name my-web \ -p 8080:80 \ -v ~/docker-demo:/usr/share/nginx/html \ nginx:alpine-d后台运行。--name my-web容器命名为my-web。-p 8080:80将宿主机的8080端口映射到容器的80端口。-v ~/docker-demo:/usr/share/nginx/html这是关键。-v建立了数据卷挂载将本地目录同步到容器内。这样你在本地修改index.html容器内立即生效无需重建镜像。nginx:alpine使用体积更小的Alpine Linux版本的Nginx镜像。步骤3验证打开你的浏览器访问http://localhost:8080。你应该能看到刚才创建的“Hello from inside a Docker Container!”页面。步骤4动态更新内容现在尝试修改本地的index.html文件比如在body里加一行pUpdated in real time!/p。保存文件后刷新浏览器页面你会发现更改立即生效了。这展示了Docker数据卷挂载在开发中的巨大便利性。步骤5清理实验完成后停止并删除容器。docker stop my-web docker rm my-web这个简单的实战涵盖了Docker最核心的几种用法拉取镜像、运行容器、端口映射、数据卷挂载。通过这个流程你已经能体会到Docker如何将应用与环境封装并通过简单的命令进行部署和管理。
)
