第一次认真接触Docker大概率是碰上了这种场景照着网上的帖子部署一个MySQL先要装依赖、解压安装包、改配置文件折腾一下午最后发现系统版本不对、依赖冲突全都白干。后来听说有个东西叫Docker一条命令就能把MySQL跑起来于是开始搜“Docker安装教程”。结果打开教程又懵了——Docker Desktop报错、虚拟化未开启、镜像下载龟速、一堆某某某的概念名词轮番轰炸。这篇文章就是我整理出来的完整学习路径把安装、镜像加速、部署实战、Compose编排、常见报错这几块全部串起来。内容覆盖Windows和Ubuntu两套环境含具体命令和排查思路适合完全零基础的新手也适合已经装了Docker但不知道下一步该干什么的读者。1. Docker为什么值得学从环境一致性到交付标准的底层逻辑1.1 镜像像模板容器像实例一个类比讲透理解Docker最难的点其实是那几个名字。这里用最直白的话讲清楚。镜像Image就像一台电脑装好系统和软件之后做的Ghost备份它是一个只读的、静态的文件集合。容器Container则是这个镜像被运行起来之后形成的实体有自己的进程、网络和文件系统读写层。打个类比镜像是一份蛋糕配方加模具的录像容器是按这个录像实际烤出来的每一块蛋糕。同一个镜像可以同时启动多个容器互相之间完全隔离。仓库Repository则是存放镜像的地方。最常用的公共仓库是Docker Hub类似GitHub之于代码。日常说的“拉镜像”就是执行docker pull从仓库下载镜像到本地之后基于这个镜像反复运行容器。这套机制解决了一个被吐槽了无数年的问题——软件运行环境的差异。传统方式下开发者在自己的电脑上跑得好好的代码到服务器上因为系统版本、缺少动态库、端口占用等问题起不来问答社区里最常见的甩锅句式就是“在我电脑上明明能跑”。Docker把应用连同它依赖的库、配置、运行环境一起打包进镜像在任何装了Docker的机器上运行结果一致这个“在我电脑上能跑”的问题从根本上消失了。1.2 环境一致性为什么“在我电脑上能跑”是个伪命题传统部署方式中应用和运行环境是耦合的。MySQL的版本差异、PHP的扩展缺失、Node.js的版本不同、系统缺少某个底层库任何一个环节出问题应用就起不来。这些问题一旦到了生产环境会成倍放大因为生产环境有严格的变更审批流程你不可能随意安装依赖。Docker的镜像打包机制相当于把整个“运行环境”也做进了交付物里。开发环境、测试环境、生产环境面对的是同一个镜像运行的是同一套代码和依赖。这是Docker在工程化层面的最大价值也是为什么很多团队即使单机部署也会选择Docker而不是直接装软件——升级回滚极其方便镜像的tag就是版本号想回滚直接run旧tag的镜像。1.3 Docker、虚拟机、裸机的取舍对比理解了Docker最大的价值之后还要搞清楚它和虚拟机的区别因为这是初学者最纠结的问题。维度虚拟机Docker容器裸机部署隔离级别硬件级虚拟化每个VM有独立内核操作系统级隔离共享宿主机内核无隔离启动速度冷启动通常几十秒到几分钟秒级启动取决于服务和系统资源占用完整Guest OS占用GB级内存仅包含应用及其依赖占用MB到几百MB依赖具体应用环境一致性镜像分发相对笨重镜像分层复用分发极快需要自己保证一致适用场景需要运行异构操作系统如Windows和Linux混布同内核下的微服务、中间件、应用打包简单固定环境具体到选型如果只是想跑一个MySQL或者一个Web应用Docker是最合适的因为共享内核带来的开销极小一台2核4G的云服务器可以同时跑十来个容器服务。如果需要在同一台物理机上跑Windows和Linux两套系统或者需要更彻底的内核隔离那才需要上虚拟机。这两者之间没有绝对替代关系很多生产架构实际上是虚拟机里再跑Docker既保证底层多租户隔离又保证上层部署的灵活性。提示Docker容器共享宿主机内核这意味着容器里的应用必须与宿主机内核兼容。例如一台Linux 3.10内核的机器无法运行需要Linux 4.x特性的容器应用除非升级宿主机内核。2. Windows和Ubuntu装Docker的完整实操从安装到排错2.1 Windows下Docker Desktop安装全流程与前置条件Windows上装Docker绝大多数人的选择是Docker Desktop它自带图形界面、内置Docker Engine和Compose插件适合日常学习和开发。但是装它之前有几个前置条件必须先确认否则安装过程中会不断踩坑。前置条件按重要程度排Windows 10 64位专业版/企业版/教育版21H2以上或Windows 11所有版本。家庭版也能装但在Hyper-V和WSL2支持上会有额外的折腾。CPU支持虚拟化并在BIOS中开启对应Intel的VT-x或AMD的SVM。BIOS中开启虚拟化后Windows功能中需要启用“虚拟机平台”和“适用于Linux的Windows子系统”两条缺一条Docker Desktop都会起不来。内存建议8GB以上实际体验下来4GB机器跑Docker Desktop会比较吃力光WSL2的虚拟机就要吃掉2GB左右。官方安装包的获取路径是docker.com官网的Products页面下载Docker Desktop for Windows。下载下来是一个Docker Desktop Installer.exe双击运行即可。安装过程中有一个重要勾选项“Use WSL 2 instead of Hyper-V”推荐勾选因为WSL2的启动速度和资源占用都优于Hyper-V方案。装完之后不需要急着打开。先确认两个Windows功能状态在PowerShell管理员中执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完重启电脑再执行下面的命令把WSL2设置为默认版本wsl --set-default-version 2这套流程走完再启动Docker Desktop基本能一次成功。启动后右下角鲸鱼图标显示为绿色Running状态再执行docker version能看到Client和Server两段信息其中Server段有输出说明Docker Engine已经正常工作。2.2 报错Virtualization support not detected的全排查链路Docker Desktop启动时报Virtualization support not detected是Windows环境被问得最多的一个错误。这个提示的字面意思是没有检测到虚拟化支持但实际原因通常有以下几种按出现频率从高到低排查第一步确认BIOS里有没有开启虚拟化。重启电脑进BIOS一般是按Del或F2找到Intel Virtualization Technology或SVM Mode设为Enabled。很多主板默认是关闭的这一步最容易被忽略。第二步确认Windows的虚拟化相关功能是否完整。在PowerShell管理员中执行systeminfo看输出中的“Hyper-V要求”一项如果显示“已检测到虚拟机监控程序。将不显示Hyper-V所需的功能。”说明虚拟化已生效。如果显示“固件中已启用虚拟化: 否”说明BIOS那步没生效。第三步确认Windows功能面板中“虚拟机平台”“适用于Linux的Windows子系统”两项都已勾选。可以在PowerShell中执行Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-LinuxState显示Enabled就说明正常。第四步检查WSL2内核是否过旧。在PowerShell中执行wsl --update更新到最新版然后再wsl --status查看默认版本是否为2。这套链路走完90%以上的“虚拟化未检测到”问题都能解决。如果都排查完了还是报错最后一个尝试是卸载Docker Desktop后用管理员权限重新运行安装包并在安装界面勾选“Install required Windows components for WSL 2”装完重启。2.3 Ubuntu服务器用apt安装Docker Engine的推荐步骤Linux服务器上不存在Docker Desktop装的是Docker Engine即纯粹的Docker服务端和命令行工具。以Ubuntu 22.04/24.04为例推荐用官方apt源安装这样后续升级方便。先安装依赖并添加Docker官方GPG密钥sudo apt update sudo apt install -y ca-certificates curl gnupg sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod ar /etc/apt/keyrings/docker.gpg再添加软件源注意$(. /etc/os-release echo $VERSION_CODENAME)会自动匹配Ubuntu版本代号echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release echo $VERSION_CODENAME) stable | \ sudo tee /etc/apt/sources.list.d/docker.list /dev/null然后安装Docker Engine、命令行工具和Compose插件sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin启动并设置开机自启sudo systemctl enable --now docker安装完成后执行sudo docker run hello-world验证。如果不想每次输入sudo可以把当前用户加入docker组sudo usermod -aG docker $USER这条命令执行后需要重新登录会话才会生效。需要注意的是加入docker组相当于把该用户的权限提升到了root级别因为这等于赋予了用户操作宿主机内核能力的机会。生产环境要谨慎考虑是否给普通用户加这个组。2.4 空间规划Docker数据如何迁移到非系统盘“Docker可以安装到其他盘吗”是Windows用户高频搜索的问题。Docker Desktop程序本身安装在C盘Program Files占用的空间不大真正占空间的是镜像和容器数据默认存放在C:\Users\用户名\AppData\Local\Docker\wsl对应的是发行版docker-desktop-data的虚拟磁盘文件这块虚拟磁盘会随着拉取的镜像越来越多而膨胀动辄几十GB。在Docker Desktop的Settings - Resources - Advanced中可以看到Disk image location设置项直接改到一个大容量磁盘的目录然后点击Apply Restart即可。Docker Desktop会自动将现有的虚拟磁盘移动到新位置不需要手动复制文件。Linux服务器上的Docker数据默认存放在/var/lib/docker如果根分区不大建议将数据目录迁移到数据盘。推荐做法不是直接软链而是修改Docker的daemon配置{ data-root: /data/docker }写入/etc/docker/daemon.json后执行sudo systemctl restart docker。迁移前记得先停掉所有容器否则运行中的容器会使用旧路径的文件导致数据不一致。提示修改>{ registry-mirrors: [ https://docker.m.daocloud.io, https://dockerproxy.com, https://mirror.ccs.tencentyun.com ] }修改后重启Docker服务sudo systemctl daemon-reload sudo systemctl restart docker重启完成后用docker info查看输出中的Registry Mirrors字段能看到配置的加速器列表就说明生效了。Docker Desktop的配置位置在Settings - Docker Engine同样是在daemon配置的JSON里加registry-mirrors保存并重启Docker Desktop即可。这里要特别提一个坑网上很多教程给的加速器地址已经失效或需要登录才能使用。用在阿里云容器镜像服务控制台生成的专属加速器地址仍然是最稳定的方案登录后每个账号有一个独立的HTTPS地址形如https://编号.mirror.aliyuncs.com这个地址不需要额外的客户端配置到daemon.json里就能用。如果动手能力允许也可以自己部署一个轻量级镜像缓存但这属于进阶玩法日常加速用现成的免费地址就够了。配置完加速器再拉一次之前卡住的镜像速度通常会有质的提升。3.3 搭建私有镜像仓库一步步push你自己的镜像镜像加速解决的是拉取公共镜像的问题当项目沉淀出自己的镜像之后更重要的问题是“自己构建的镜像如何分发”。这时候就需要私有镜像仓库。最轻量级的方案是运行一个Registry容器docker run -d -p 5000:5000 --name registry --restartalways -v /opt/registry:/var/lib/registry registry:2然后把本地镜像打上私有仓库的tag并pushdocker tag nginx:latest localhost:5000/nginx:latest docker push localhost:5000/nginx:latest在另一台机器上拉取的话把localhost替换为服务器IP并确保5000端口开放。另外使用非HTTPS的私有仓库时需要在客户端机器的daemon.json中配置insecure-registries: [192.168.1.100:5000]否则Docker会拒绝推送。这个配置对学习环境来说完全够用生产环境则建议部署带认证和HTTPS的Harbor。4. 三个高频部署实战MySQL 8.0、Redis主从、GitLab4.1 用一条命令把MySQL 8.0跑起来并让外部能连MySQL是Docker初学者第一个必须亲手部署的中间件因为它的关键参数足够多能一次性覆盖端口映射、环境变量、数据卷这些核心概念。最简化的启动命令docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -v mysql-data:/var/lib/mysql \ mysql:8.0几个参数逐一说一下-d后台运行容器不会占据当前终端。--name mysql8容器别名后续操作容器时不用记ID直接docker logs mysql8、docker exec -it mysql8 bash。-p 3306:3306把宿主机的3306端口映射到容器的3306端口。外部程序连接时连的是宿主机IP的3306实际上数据进入容器内的MySQL。-e MYSQL_ROOT_PASSWORD初始化时设置root密码。这是MySQL官方镜像支持的配置项如果不设置容器会在启动时随机生成密码。-v mysql-data:/var/lib/MySQL命名卷挂载MySQL的数据文件写入宿主机的mysql-data卷中。这样即使容器被删除重建数据也不会丢。很多新手在这一步会遇到外部连不上MySQL的问题。原因是只对127.0.0.1做了端口映射或者MySQL容器内的root账号只允许localhost登录。解决方法是启动时增加一条环境变量-e MYSQL_ROOT_HOST%%表示允许任意host使用root账号登录。这适合开发环境生产环境建议单独建账号并设置白名单。用Docker跑MySQL时还需要注意字符集问题。虽然MySQL 8.0的默认字符集已经是utf8mb4但实际使用中建议显式指定避免今后因默认值变化导致行为不一致docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -e MYSQL_ROOT_HOST% \ -v mysql-data:/var/lib/mysql \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci \ mysql:8.0验证部署是否成功docker exec -it mysql8 mysql -uroot -p输入密码后能进入MySQL命令行说明部署成功。再用SHOW VARIABLES LIKE character_set_server;确认字符集配置。4.2 Redis主从同步在同一宿主机上的搭建细节Redis主从部署在Docker下非常方便因为不需要像传统方式那样调配置文件、装依赖直接用redis-server命令加参数即可。这里演示在同一台宿主机上搭建一主一从通过redis镜像自带的命令行参数完成配置。先启动主节点端口映射到6380docker run -d \ --name redis-master \ -p 6380:6379 \ -v redis-master-data:/data \ redis:7 redis-server --appendonly yes再启动从节点端口映射到6381并指定主节点地址docker run -d \ --name redis-slave \ -p 6381:6379 \ -v redis-slave-data:/data \ redis:7 redis-server --appendonly yes --replicaof 宿主机IP 6380注意从Redis 5.0开始官方推荐使用replicaof替代旧版slaveof虽然旧命令仍然兼容但新项目建议直接用replicaof。参数后面跟的是主节点的IP和端口这里不能写127.0.0.1因为从节点容器内部的127.0.0.1指向它自己需要填写宿主机的局域网IP。验证主从是否正常docker exec -it redis-master redis-cli -p 6379 info replication docker exec -it redis-slave redis-cli -p 6379 info replication关注主节点输出中的connected_slaves和从节点输出中的master_link_status:up两者都正常说明主从同步已建立。在实际操作中我发现一个容易踩的坑如果从节点容器启动早于主节点或者网络抖动导致主从断连Redis会自动重连并继续同步这没问题。但如果主节点启用了密码从节点必须用--masterauth参数指定密码否则同步会一直失败。4.3 部署GitLab前必须清楚的内存和端口规划GitLab是Docker部署中比较吃资源的典型代表很多人拉下来跑起来发现服务器直接卡死就是因为没做好内存规划。GitLab官方镜像要求最低4GB内存这是底线低于这个值在运行中很容易出现500错误或容器被OOM杀掉。推荐配置是宿主机8GB内存以上并给GitLab容器分配4GB以上。如果只是学习用途建议在部署前用free -h确认内存余量。部署命令docker run -d \ --hostname gitlab.example.com \ -p 8090:80 \ -p 8422:22 \ --name gitlab \ --restart always \ -v gitlab-config:/etc/gitlab \ -v gitlab-logs:/var/log/gitlab \ -v gitlab-data:/var/opt/gitlab \ gitlab/gitlab-ce:latest三个数据卷分别存放配置、日志和实际仓库数据删除容器时这些数据不会丢失。这里的--hostname参数比较关键它决定了GitLab生成的仓库地址前缀。如果ip访问直接填IP即可。启动过程会比较久首次启动可能需要几分钟进行初始化查看进度用docker logs -f gitlab看到gitlab Reconfigured!字样说明初始化完成。然后访问http://宿主机IP:8090首次访问会让设置root密码。提示GitLab容器如果起不来优先检查内存是否足够其次检查端口是否被占用。docker logs gitlab里能看到具体的报错信息这是排错的第一入口。5. Docker Compose编排多容器从单容器命令到项目化部署5.1 Compose文件的核心结构拆解单容器用docker run还勉强够用但一个项目往往需要MySQL、Redis、应用服务、定时任务等多个容器配合用docker run一条条敲会非常繁琐而且无法固化版本和配置。这时候就应该用Docker Compose。Compose的核心是一个YAML文件默认叫docker-compose.yml。从Docker Engine 25开始Compose V2插件内置在Docker CLI中直接用docker compose命令即可不需要单独安装docker-compose。一个Compose文件的最基本骨架长这样version: 3.8 services: mysql: image: mysql:8.0 container_name: app-mysql restart: always environment: MYSQL_ROOT_PASSWORD: rootpass ports: - 3306:3306 volumes: - mysql-data:/var/lib/mysql volumes: mysql-data:里面的services就是一组容器每个服务可以理解为一条docker run命令。environment对应-e参数ports对应-p参数volumes对应-v参数。启动整个项目只需要一条命令docker compose up -d停止并删除所有容器docker compose down查看所有服务的日志docker compose logs -f这套抽象最大的价值是“基础设施即代码”整个环境的环境变量、端口、数据卷全部写在文件里换一台机器拉下来直接up -d就能复现同样的环境。5.2 一个Web项目MySQLRedis的Compose实例以一个典型的Web应用为例演示完整的Compose编排方式。假设应用是一个Spring Boot或Node.js项目依赖MySQL和Redis。version: 3.8 services: mysql: image: mysql:8.0 container_name: app-mysql restart: always environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: appdb MYSQL_USER: appuser MYSQL_PASSWORD: apppass ports: - 3306:3306 volumes: - mysql-data:/var/lib/mysql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s retries: 10 redis: image: redis:7 container_name: app-redis restart: always ports: - 6379:6379 volumes: - redis-data:/data app: build: ./app container_name: app-server restart: always depends_on: mysql: condition: service_healthy redis: condition: service_started environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/appdb SPRING_REDIS_HOST: redis ports: - 8080:8080 volumes: mysql-data: redis-data:这里有两个知识点需要拆开讲。第一个是服务间通信。容器之间可以通过服务名直接访问app服务连接数据库时用的host不是localhost也不是宿主机IP而是mysql——这就是服务名在Compose内部网络中充当了DNS解析。这一点直接影响了应用配置的写法很多人在容器化之后还习惯写localhost导致连不上数据库就是这个原因。第二个是depends_on的进阶用法。只写depends_on只能保证容器启动顺序但MySQL容器启动了不代表它已经准备好接受连接。上面的配置用了healthcheck让MySQL容器报告自己健康之后app才启动。这是一个生产环境必用的细节。启动命令仍然只有一条docker compose up -d整个项目起来之后应用在宿主机8080端口访问MySQL在3306端口Redis在6379端口。开发和测试环境只要这一份文件就能完成整套环境的搭建。5.3 青龙面板、Kodbox这类开源项目如何用Compose快速部署很多开源项目尤其是国产开源项目官方文档都提供了Docker或Compose部署方式。以青龙面板一个定时任务管理和执行面板为例它的官方推荐就是Docker部署docker run -d \ --name qinglong \ -p 5700:5700 \ -v /opt/ql/config:/ql/config \ -v /opt/ql/log:/ql/log \ -v /opt/ql/db:/ql/db \ whyour/qinglong:latest如果希望把青龙面板和它依赖的数据库等一起管理可以写成Compose文件version: 3.8 services: qinglong: image: whyour/qinglong:latest container_name: qinglong restart: always ports: - 5700:5700 volumes: - /opt/ql/config:/ql/config - /opt/ql/log:/ql/log - /opt/ql/db:/ql/db启动后访问http://宿主机IP:5700按提示初始化即可。之后面板上的任务调度、日志记录都会写进挂载的volume中升级只需要重新拉镜像再docker compose up -d数据不会丢。Kodbox可道云的Compose部署类似它需要一个MySQL数据库配合所以Compose文件里会多一个数据库服务version: 3.8 services: db: image: mysql:5.7 container_name: kodbox-db restart: always environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: kodbox volumes: - kodbox-db:/var/lib/mysql kodbox: image: kodbox/kodbox:latest container_name: kodbox-web restart: always depends_on: - db ports: - 8081:80 volumes: - kodbox-data:/var/www/html volumes: kodbox-db: kodbox-data:通过这两个例子可以看到只要是支持Docker部署的开源项目用Compose把容器配置固化下来之后无论换服务器还是重装系统只需要执行docker compose up -d就能恢复服务。6. 常用命令学习路径与高频报错排查实录6.1 按生命周期掌握最常用的Docker命令Docker命令看着多其实可以按生命周期分组记忆每一组理解清楚之后遇到不熟悉的命令也能根据规律推测用法。镜像生命周期相关的命令docker search nginx # 搜索镜像 docker pull nginx:latest # 拉取镜像 docker images # 查看本地镜像列表 docker tag nginx:latest myrepo/nginx:v1 # 给镜像打标签 docker rmi nginx:latest # 删除镜像 docker build -t myapp:v1 . # 构建镜像 docker push myrepo/nginx:v1 # 推送镜像到仓库容器生命周期相关的命令docker run -d --name nginx-test -p 8080:80 nginx # 创建并启动容器 docker ps # 查看运行中的容器 docker ps -a # 查看所有容器包括已停止的 docker start nginx-test # 启动已停止的容器 docker stop nginx-test # 停止容器 docker restart nginx-test # 重启容器 docker rm -f nginx-test # 强制删除容器进入容器的调试常用命令docker exec -it nginx-test bash # 进入容器内部 docker logs -f nginx-test # 查看容器日志 docker cp test.txt nginx-test:/tmp/ # 复制文件到容器 docker stats # 查看容器资源占用网络和磁盘相关docker network ls # 查看网络 docker network create mynet # 创建网络 docker volume ls # 查看数据卷 docker system df # 查看磁盘占用 docker system prune # 清理未使用的资源我的学习建议是不用刻意背命令先保证能熟练使用docker run、docker ps、docker logs、docker exec这四个最核心的命令80%的日常操作都靠它们完成。遇到新需求再查具体命令用多了自然就记住了。6.2 failed to connect to the Docker API系列报错Windows环境下最典型的一个报错是error during connect: this error may indicate that the docker daemon is not running: failed to connect to the docker api at npipe:////./pipe/docker_engine: Get http://%2F%2F%2F%2F./pipe/docker_engine: open //./pipe/docker_engine: The system cannot find the file specified.这个报错的核心信息就一句话Docker Engine没在运行命令行客户端找不到Docker服务。常见的处理步骤确认Docker Desktop是否启动右下角托盘有没有鲸鱼图标启动后等几秒再执行命令。确认启动后依然报错打开PowerShell管理员执行wsl --shutdown等WSL完全停止后重新启动Docker Desktop。检查docker context当前指向哪个上下文docker context ls如果显示的不是default需要切换回defaultdocker context use default。如果以上都无效大概率是Docker Desktop的服务状态异常卸载重装最省心。Linux下也有类似的报错场景通常表现为Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?处理方式先看服务状态sudo systemctl status docker如果报错说active (running)但仍然无法连接大概率是当前用户没有权限访问docker.sock执行sudo usermod -aG docker $USER并重新登录。如果服务没有启动执行sudo systemctl start docker sudo systemctl enable dockerdocker服务启动失败在Linux上常见原因是daemon.json配置格式错误。用sudo dockerd前台启动能看到具体报错信息排查清楚再恢复。6.3 Kafka元数据获取失败等容器网络问题排查思路集群类组件在Docker中的网络配置是一个典型的高频坑以Kafka为例最常见的报错是Error while fetching metadata with correlation id 1 : {test-topicLEADER_NOT_AVAILABLE}这个报错通常不是因为Kafka本身崩溃而是客户端连上了错误的地址。Kafka的机制是客户端先连上Kafka服务端获取元数据服务端会返回每个分区的leader所在broker的地址客户端根据这个地址去建立真正的连接。关键就在这个返回地址上。如果Kafka跑在Docker容器里容器内部看到自己的hostname是容器ID而客户端在宿主机上拿到一个容器内部的hostname根本没有办法解析自然报LEADER_NOT_AVAILABLE或Connection refused。正确做法是在启动Kafka时配置KAFKA_ADVERTISED_LISTENERS告诉客户端真正可用的地址docker run -d \ --name kafka \ -p 9092:9092 \ -e KAFKA_ADVERTISED_LISTENERSPLAINTEXT://宿主机IP:9092 \ -e KAFKA_LISTENERSPLAINTEXT://0.0.0.0:9092 \ -e KAFKA_ZOOKEEPER_CONNECT宿主机IP:2181 \ apache/kafka:3.7.0这里的ADVERTISED_LISTENERS是给客户端看的地址LISTENERS是Kafka自己监听的地址。容器内外地址不一致时这两个字段必须分开配置这也是所有Kafka容器化部署的核心知识点。这个排查思路能迁移到很多容器网络问题上服务本身没有起错是客户端拿到的“服务地址”对不上。遇到类似报错先问自己一个问题——“客户端访问服务时它拿到的地址到底是谁在什么视角下广播的”想明白这一点容器网络的很多坑就都能绕开了。用Docker搭建DVWA靶场、Hadoop集群、人大金仓数据库这类学习环境也是同样的套路拉镜像、配端口、调网络参数本质上是在练习“怎么把一个有依赖关系的服务跑在容器里”这件事。把这一套搞通了Docker的学习也就算真正入门了。如果让我给一条学习路径建议会是这样先别急着背全部命令也不用管什么K8s、Swarm这些编排平台。第一步亲手把MySQL和Redis两个容器跑起来理解镜像拉取、端口映射、数据卷挂载这三个概念第二步用Compose把一个完整Web项目编排起来理解容器间网络和服务依赖第三步学会看日志、看docker stats定位问题。这三步走完Docker的基本功就扎实了剩下的都是在积累经验。 Docker零基础实战指南：从安装部署到Compose编排与高频排错
第一次认真接触Docker大概率是碰上了这种场景照着网上的帖子部署一个MySQL先要装依赖、解压安装包、改配置文件折腾一下午最后发现系统版本不对、依赖冲突全都白干。后来听说有个东西叫Docker一条命令就能把MySQL跑起来于是开始搜“Docker安装教程”。结果打开教程又懵了——Docker Desktop报错、虚拟化未开启、镜像下载龟速、一堆某某某的概念名词轮番轰炸。这篇文章就是我整理出来的完整学习路径把安装、镜像加速、部署实战、Compose编排、常见报错这几块全部串起来。内容覆盖Windows和Ubuntu两套环境含具体命令和排查思路适合完全零基础的新手也适合已经装了Docker但不知道下一步该干什么的读者。1. Docker为什么值得学从环境一致性到交付标准的底层逻辑1.1 镜像像模板容器像实例一个类比讲透理解Docker最难的点其实是那几个名字。这里用最直白的话讲清楚。镜像Image就像一台电脑装好系统和软件之后做的Ghost备份它是一个只读的、静态的文件集合。容器Container则是这个镜像被运行起来之后形成的实体有自己的进程、网络和文件系统读写层。打个类比镜像是一份蛋糕配方加模具的录像容器是按这个录像实际烤出来的每一块蛋糕。同一个镜像可以同时启动多个容器互相之间完全隔离。仓库Repository则是存放镜像的地方。最常用的公共仓库是Docker Hub类似GitHub之于代码。日常说的“拉镜像”就是执行docker pull从仓库下载镜像到本地之后基于这个镜像反复运行容器。这套机制解决了一个被吐槽了无数年的问题——软件运行环境的差异。传统方式下开发者在自己的电脑上跑得好好的代码到服务器上因为系统版本、缺少动态库、端口占用等问题起不来问答社区里最常见的甩锅句式就是“在我电脑上明明能跑”。Docker把应用连同它依赖的库、配置、运行环境一起打包进镜像在任何装了Docker的机器上运行结果一致这个“在我电脑上能跑”的问题从根本上消失了。1.2 环境一致性为什么“在我电脑上能跑”是个伪命题传统部署方式中应用和运行环境是耦合的。MySQL的版本差异、PHP的扩展缺失、Node.js的版本不同、系统缺少某个底层库任何一个环节出问题应用就起不来。这些问题一旦到了生产环境会成倍放大因为生产环境有严格的变更审批流程你不可能随意安装依赖。Docker的镜像打包机制相当于把整个“运行环境”也做进了交付物里。开发环境、测试环境、生产环境面对的是同一个镜像运行的是同一套代码和依赖。这是Docker在工程化层面的最大价值也是为什么很多团队即使单机部署也会选择Docker而不是直接装软件——升级回滚极其方便镜像的tag就是版本号想回滚直接run旧tag的镜像。1.3 Docker、虚拟机、裸机的取舍对比理解了Docker最大的价值之后还要搞清楚它和虚拟机的区别因为这是初学者最纠结的问题。维度虚拟机Docker容器裸机部署隔离级别硬件级虚拟化每个VM有独立内核操作系统级隔离共享宿主机内核无隔离启动速度冷启动通常几十秒到几分钟秒级启动取决于服务和系统资源占用完整Guest OS占用GB级内存仅包含应用及其依赖占用MB到几百MB依赖具体应用环境一致性镜像分发相对笨重镜像分层复用分发极快需要自己保证一致适用场景需要运行异构操作系统如Windows和Linux混布同内核下的微服务、中间件、应用打包简单固定环境具体到选型如果只是想跑一个MySQL或者一个Web应用Docker是最合适的因为共享内核带来的开销极小一台2核4G的云服务器可以同时跑十来个容器服务。如果需要在同一台物理机上跑Windows和Linux两套系统或者需要更彻底的内核隔离那才需要上虚拟机。这两者之间没有绝对替代关系很多生产架构实际上是虚拟机里再跑Docker既保证底层多租户隔离又保证上层部署的灵活性。提示Docker容器共享宿主机内核这意味着容器里的应用必须与宿主机内核兼容。例如一台Linux 3.10内核的机器无法运行需要Linux 4.x特性的容器应用除非升级宿主机内核。2. Windows和Ubuntu装Docker的完整实操从安装到排错2.1 Windows下Docker Desktop安装全流程与前置条件Windows上装Docker绝大多数人的选择是Docker Desktop它自带图形界面、内置Docker Engine和Compose插件适合日常学习和开发。但是装它之前有几个前置条件必须先确认否则安装过程中会不断踩坑。前置条件按重要程度排Windows 10 64位专业版/企业版/教育版21H2以上或Windows 11所有版本。家庭版也能装但在Hyper-V和WSL2支持上会有额外的折腾。CPU支持虚拟化并在BIOS中开启对应Intel的VT-x或AMD的SVM。BIOS中开启虚拟化后Windows功能中需要启用“虚拟机平台”和“适用于Linux的Windows子系统”两条缺一条Docker Desktop都会起不来。内存建议8GB以上实际体验下来4GB机器跑Docker Desktop会比较吃力光WSL2的虚拟机就要吃掉2GB左右。官方安装包的获取路径是docker.com官网的Products页面下载Docker Desktop for Windows。下载下来是一个Docker Desktop Installer.exe双击运行即可。安装过程中有一个重要勾选项“Use WSL 2 instead of Hyper-V”推荐勾选因为WSL2的启动速度和资源占用都优于Hyper-V方案。装完之后不需要急着打开。先确认两个Windows功能状态在PowerShell管理员中执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完重启电脑再执行下面的命令把WSL2设置为默认版本wsl --set-default-version 2这套流程走完再启动Docker Desktop基本能一次成功。启动后右下角鲸鱼图标显示为绿色Running状态再执行docker version能看到Client和Server两段信息其中Server段有输出说明Docker Engine已经正常工作。2.2 报错Virtualization support not detected的全排查链路Docker Desktop启动时报Virtualization support not detected是Windows环境被问得最多的一个错误。这个提示的字面意思是没有检测到虚拟化支持但实际原因通常有以下几种按出现频率从高到低排查第一步确认BIOS里有没有开启虚拟化。重启电脑进BIOS一般是按Del或F2找到Intel Virtualization Technology或SVM Mode设为Enabled。很多主板默认是关闭的这一步最容易被忽略。第二步确认Windows的虚拟化相关功能是否完整。在PowerShell管理员中执行systeminfo看输出中的“Hyper-V要求”一项如果显示“已检测到虚拟机监控程序。将不显示Hyper-V所需的功能。”说明虚拟化已生效。如果显示“固件中已启用虚拟化: 否”说明BIOS那步没生效。第三步确认Windows功能面板中“虚拟机平台”“适用于Linux的Windows子系统”两项都已勾选。可以在PowerShell中执行Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-LinuxState显示Enabled就说明正常。第四步检查WSL2内核是否过旧。在PowerShell中执行wsl --update更新到最新版然后再wsl --status查看默认版本是否为2。这套链路走完90%以上的“虚拟化未检测到”问题都能解决。如果都排查完了还是报错最后一个尝试是卸载Docker Desktop后用管理员权限重新运行安装包并在安装界面勾选“Install required Windows components for WSL 2”装完重启。2.3 Ubuntu服务器用apt安装Docker Engine的推荐步骤Linux服务器上不存在Docker Desktop装的是Docker Engine即纯粹的Docker服务端和命令行工具。以Ubuntu 22.04/24.04为例推荐用官方apt源安装这样后续升级方便。先安装依赖并添加Docker官方GPG密钥sudo apt update sudo apt install -y ca-certificates curl gnupg sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod ar /etc/apt/keyrings/docker.gpg再添加软件源注意$(. /etc/os-release echo $VERSION_CODENAME)会自动匹配Ubuntu版本代号echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release echo $VERSION_CODENAME) stable | \ sudo tee /etc/apt/sources.list.d/docker.list /dev/null然后安装Docker Engine、命令行工具和Compose插件sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin启动并设置开机自启sudo systemctl enable --now docker安装完成后执行sudo docker run hello-world验证。如果不想每次输入sudo可以把当前用户加入docker组sudo usermod -aG docker $USER这条命令执行后需要重新登录会话才会生效。需要注意的是加入docker组相当于把该用户的权限提升到了root级别因为这等于赋予了用户操作宿主机内核能力的机会。生产环境要谨慎考虑是否给普通用户加这个组。2.4 空间规划Docker数据如何迁移到非系统盘“Docker可以安装到其他盘吗”是Windows用户高频搜索的问题。Docker Desktop程序本身安装在C盘Program Files占用的空间不大真正占空间的是镜像和容器数据默认存放在C:\Users\用户名\AppData\Local\Docker\wsl对应的是发行版docker-desktop-data的虚拟磁盘文件这块虚拟磁盘会随着拉取的镜像越来越多而膨胀动辄几十GB。在Docker Desktop的Settings - Resources - Advanced中可以看到Disk image location设置项直接改到一个大容量磁盘的目录然后点击Apply Restart即可。Docker Desktop会自动将现有的虚拟磁盘移动到新位置不需要手动复制文件。Linux服务器上的Docker数据默认存放在/var/lib/docker如果根分区不大建议将数据目录迁移到数据盘。推荐做法不是直接软链而是修改Docker的daemon配置{ data-root: /data/docker }写入/etc/docker/daemon.json后执行sudo systemctl restart docker。迁移前记得先停掉所有容器否则运行中的容器会使用旧路径的文件导致数据不一致。提示修改>{ registry-mirrors: [ https://docker.m.daocloud.io, https://dockerproxy.com, https://mirror.ccs.tencentyun.com ] }修改后重启Docker服务sudo systemctl daemon-reload sudo systemctl restart docker重启完成后用docker info查看输出中的Registry Mirrors字段能看到配置的加速器列表就说明生效了。Docker Desktop的配置位置在Settings - Docker Engine同样是在daemon配置的JSON里加registry-mirrors保存并重启Docker Desktop即可。这里要特别提一个坑网上很多教程给的加速器地址已经失效或需要登录才能使用。用在阿里云容器镜像服务控制台生成的专属加速器地址仍然是最稳定的方案登录后每个账号有一个独立的HTTPS地址形如https://编号.mirror.aliyuncs.com这个地址不需要额外的客户端配置到daemon.json里就能用。如果动手能力允许也可以自己部署一个轻量级镜像缓存但这属于进阶玩法日常加速用现成的免费地址就够了。配置完加速器再拉一次之前卡住的镜像速度通常会有质的提升。3.3 搭建私有镜像仓库一步步push你自己的镜像镜像加速解决的是拉取公共镜像的问题当项目沉淀出自己的镜像之后更重要的问题是“自己构建的镜像如何分发”。这时候就需要私有镜像仓库。最轻量级的方案是运行一个Registry容器docker run -d -p 5000:5000 --name registry --restartalways -v /opt/registry:/var/lib/registry registry:2然后把本地镜像打上私有仓库的tag并pushdocker tag nginx:latest localhost:5000/nginx:latest docker push localhost:5000/nginx:latest在另一台机器上拉取的话把localhost替换为服务器IP并确保5000端口开放。另外使用非HTTPS的私有仓库时需要在客户端机器的daemon.json中配置insecure-registries: [192.168.1.100:5000]否则Docker会拒绝推送。这个配置对学习环境来说完全够用生产环境则建议部署带认证和HTTPS的Harbor。4. 三个高频部署实战MySQL 8.0、Redis主从、GitLab4.1 用一条命令把MySQL 8.0跑起来并让外部能连MySQL是Docker初学者第一个必须亲手部署的中间件因为它的关键参数足够多能一次性覆盖端口映射、环境变量、数据卷这些核心概念。最简化的启动命令docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -v mysql-data:/var/lib/mysql \ mysql:8.0几个参数逐一说一下-d后台运行容器不会占据当前终端。--name mysql8容器别名后续操作容器时不用记ID直接docker logs mysql8、docker exec -it mysql8 bash。-p 3306:3306把宿主机的3306端口映射到容器的3306端口。外部程序连接时连的是宿主机IP的3306实际上数据进入容器内的MySQL。-e MYSQL_ROOT_PASSWORD初始化时设置root密码。这是MySQL官方镜像支持的配置项如果不设置容器会在启动时随机生成密码。-v mysql-data:/var/lib/MySQL命名卷挂载MySQL的数据文件写入宿主机的mysql-data卷中。这样即使容器被删除重建数据也不会丢。很多新手在这一步会遇到外部连不上MySQL的问题。原因是只对127.0.0.1做了端口映射或者MySQL容器内的root账号只允许localhost登录。解决方法是启动时增加一条环境变量-e MYSQL_ROOT_HOST%%表示允许任意host使用root账号登录。这适合开发环境生产环境建议单独建账号并设置白名单。用Docker跑MySQL时还需要注意字符集问题。虽然MySQL 8.0的默认字符集已经是utf8mb4但实际使用中建议显式指定避免今后因默认值变化导致行为不一致docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -e MYSQL_ROOT_HOST% \ -v mysql-data:/var/lib/mysql \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci \ mysql:8.0验证部署是否成功docker exec -it mysql8 mysql -uroot -p输入密码后能进入MySQL命令行说明部署成功。再用SHOW VARIABLES LIKE character_set_server;确认字符集配置。4.2 Redis主从同步在同一宿主机上的搭建细节Redis主从部署在Docker下非常方便因为不需要像传统方式那样调配置文件、装依赖直接用redis-server命令加参数即可。这里演示在同一台宿主机上搭建一主一从通过redis镜像自带的命令行参数完成配置。先启动主节点端口映射到6380docker run -d \ --name redis-master \ -p 6380:6379 \ -v redis-master-data:/data \ redis:7 redis-server --appendonly yes再启动从节点端口映射到6381并指定主节点地址docker run -d \ --name redis-slave \ -p 6381:6379 \ -v redis-slave-data:/data \ redis:7 redis-server --appendonly yes --replicaof 宿主机IP 6380注意从Redis 5.0开始官方推荐使用replicaof替代旧版slaveof虽然旧命令仍然兼容但新项目建议直接用replicaof。参数后面跟的是主节点的IP和端口这里不能写127.0.0.1因为从节点容器内部的127.0.0.1指向它自己需要填写宿主机的局域网IP。验证主从是否正常docker exec -it redis-master redis-cli -p 6379 info replication docker exec -it redis-slave redis-cli -p 6379 info replication关注主节点输出中的connected_slaves和从节点输出中的master_link_status:up两者都正常说明主从同步已建立。在实际操作中我发现一个容易踩的坑如果从节点容器启动早于主节点或者网络抖动导致主从断连Redis会自动重连并继续同步这没问题。但如果主节点启用了密码从节点必须用--masterauth参数指定密码否则同步会一直失败。4.3 部署GitLab前必须清楚的内存和端口规划GitLab是Docker部署中比较吃资源的典型代表很多人拉下来跑起来发现服务器直接卡死就是因为没做好内存规划。GitLab官方镜像要求最低4GB内存这是底线低于这个值在运行中很容易出现500错误或容器被OOM杀掉。推荐配置是宿主机8GB内存以上并给GitLab容器分配4GB以上。如果只是学习用途建议在部署前用free -h确认内存余量。部署命令docker run -d \ --hostname gitlab.example.com \ -p 8090:80 \ -p 8422:22 \ --name gitlab \ --restart always \ -v gitlab-config:/etc/gitlab \ -v gitlab-logs:/var/log/gitlab \ -v gitlab-data:/var/opt/gitlab \ gitlab/gitlab-ce:latest三个数据卷分别存放配置、日志和实际仓库数据删除容器时这些数据不会丢失。这里的--hostname参数比较关键它决定了GitLab生成的仓库地址前缀。如果ip访问直接填IP即可。启动过程会比较久首次启动可能需要几分钟进行初始化查看进度用docker logs -f gitlab看到gitlab Reconfigured!字样说明初始化完成。然后访问http://宿主机IP:8090首次访问会让设置root密码。提示GitLab容器如果起不来优先检查内存是否足够其次检查端口是否被占用。docker logs gitlab里能看到具体的报错信息这是排错的第一入口。5. Docker Compose编排多容器从单容器命令到项目化部署5.1 Compose文件的核心结构拆解单容器用docker run还勉强够用但一个项目往往需要MySQL、Redis、应用服务、定时任务等多个容器配合用docker run一条条敲会非常繁琐而且无法固化版本和配置。这时候就应该用Docker Compose。Compose的核心是一个YAML文件默认叫docker-compose.yml。从Docker Engine 25开始Compose V2插件内置在Docker CLI中直接用docker compose命令即可不需要单独安装docker-compose。一个Compose文件的最基本骨架长这样version: 3.8 services: mysql: image: mysql:8.0 container_name: app-mysql restart: always environment: MYSQL_ROOT_PASSWORD: rootpass ports: - 3306:3306 volumes: - mysql-data:/var/lib/mysql volumes: mysql-data:里面的services就是一组容器每个服务可以理解为一条docker run命令。environment对应-e参数ports对应-p参数volumes对应-v参数。启动整个项目只需要一条命令docker compose up -d停止并删除所有容器docker compose down查看所有服务的日志docker compose logs -f这套抽象最大的价值是“基础设施即代码”整个环境的环境变量、端口、数据卷全部写在文件里换一台机器拉下来直接up -d就能复现同样的环境。5.2 一个Web项目MySQLRedis的Compose实例以一个典型的Web应用为例演示完整的Compose编排方式。假设应用是一个Spring Boot或Node.js项目依赖MySQL和Redis。version: 3.8 services: mysql: image: mysql:8.0 container_name: app-mysql restart: always environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: appdb MYSQL_USER: appuser MYSQL_PASSWORD: apppass ports: - 3306:3306 volumes: - mysql-data:/var/lib/mysql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s retries: 10 redis: image: redis:7 container_name: app-redis restart: always ports: - 6379:6379 volumes: - redis-data:/data app: build: ./app container_name: app-server restart: always depends_on: mysql: condition: service_healthy redis: condition: service_started environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/appdb SPRING_REDIS_HOST: redis ports: - 8080:8080 volumes: mysql-data: redis-data:这里有两个知识点需要拆开讲。第一个是服务间通信。容器之间可以通过服务名直接访问app服务连接数据库时用的host不是localhost也不是宿主机IP而是mysql——这就是服务名在Compose内部网络中充当了DNS解析。这一点直接影响了应用配置的写法很多人在容器化之后还习惯写localhost导致连不上数据库就是这个原因。第二个是depends_on的进阶用法。只写depends_on只能保证容器启动顺序但MySQL容器启动了不代表它已经准备好接受连接。上面的配置用了healthcheck让MySQL容器报告自己健康之后app才启动。这是一个生产环境必用的细节。启动命令仍然只有一条docker compose up -d整个项目起来之后应用在宿主机8080端口访问MySQL在3306端口Redis在6379端口。开发和测试环境只要这一份文件就能完成整套环境的搭建。5.3 青龙面板、Kodbox这类开源项目如何用Compose快速部署很多开源项目尤其是国产开源项目官方文档都提供了Docker或Compose部署方式。以青龙面板一个定时任务管理和执行面板为例它的官方推荐就是Docker部署docker run -d \ --name qinglong \ -p 5700:5700 \ -v /opt/ql/config:/ql/config \ -v /opt/ql/log:/ql/log \ -v /opt/ql/db:/ql/db \ whyour/qinglong:latest如果希望把青龙面板和它依赖的数据库等一起管理可以写成Compose文件version: 3.8 services: qinglong: image: whyour/qinglong:latest container_name: qinglong restart: always ports: - 5700:5700 volumes: - /opt/ql/config:/ql/config - /opt/ql/log:/ql/log - /opt/ql/db:/ql/db启动后访问http://宿主机IP:5700按提示初始化即可。之后面板上的任务调度、日志记录都会写进挂载的volume中升级只需要重新拉镜像再docker compose up -d数据不会丢。Kodbox可道云的Compose部署类似它需要一个MySQL数据库配合所以Compose文件里会多一个数据库服务version: 3.8 services: db: image: mysql:5.7 container_name: kodbox-db restart: always environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: kodbox volumes: - kodbox-db:/var/lib/mysql kodbox: image: kodbox/kodbox:latest container_name: kodbox-web restart: always depends_on: - db ports: - 8081:80 volumes: - kodbox-data:/var/www/html volumes: kodbox-db: kodbox-data:通过这两个例子可以看到只要是支持Docker部署的开源项目用Compose把容器配置固化下来之后无论换服务器还是重装系统只需要执行docker compose up -d就能恢复服务。6. 常用命令学习路径与高频报错排查实录6.1 按生命周期掌握最常用的Docker命令Docker命令看着多其实可以按生命周期分组记忆每一组理解清楚之后遇到不熟悉的命令也能根据规律推测用法。镜像生命周期相关的命令docker search nginx # 搜索镜像 docker pull nginx:latest # 拉取镜像 docker images # 查看本地镜像列表 docker tag nginx:latest myrepo/nginx:v1 # 给镜像打标签 docker rmi nginx:latest # 删除镜像 docker build -t myapp:v1 . # 构建镜像 docker push myrepo/nginx:v1 # 推送镜像到仓库容器生命周期相关的命令docker run -d --name nginx-test -p 8080:80 nginx # 创建并启动容器 docker ps # 查看运行中的容器 docker ps -a # 查看所有容器包括已停止的 docker start nginx-test # 启动已停止的容器 docker stop nginx-test # 停止容器 docker restart nginx-test # 重启容器 docker rm -f nginx-test # 强制删除容器进入容器的调试常用命令docker exec -it nginx-test bash # 进入容器内部 docker logs -f nginx-test # 查看容器日志 docker cp test.txt nginx-test:/tmp/ # 复制文件到容器 docker stats # 查看容器资源占用网络和磁盘相关docker network ls # 查看网络 docker network create mynet # 创建网络 docker volume ls # 查看数据卷 docker system df # 查看磁盘占用 docker system prune # 清理未使用的资源我的学习建议是不用刻意背命令先保证能熟练使用docker run、docker ps、docker logs、docker exec这四个最核心的命令80%的日常操作都靠它们完成。遇到新需求再查具体命令用多了自然就记住了。6.2 failed to connect to the Docker API系列报错Windows环境下最典型的一个报错是error during connect: this error may indicate that the docker daemon is not running: failed to connect to the docker api at npipe:////./pipe/docker_engine: Get http://%2F%2F%2F%2F./pipe/docker_engine: open //./pipe/docker_engine: The system cannot find the file specified.这个报错的核心信息就一句话Docker Engine没在运行命令行客户端找不到Docker服务。常见的处理步骤确认Docker Desktop是否启动右下角托盘有没有鲸鱼图标启动后等几秒再执行命令。确认启动后依然报错打开PowerShell管理员执行wsl --shutdown等WSL完全停止后重新启动Docker Desktop。检查docker context当前指向哪个上下文docker context ls如果显示的不是default需要切换回defaultdocker context use default。如果以上都无效大概率是Docker Desktop的服务状态异常卸载重装最省心。Linux下也有类似的报错场景通常表现为Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?处理方式先看服务状态sudo systemctl status docker如果报错说active (running)但仍然无法连接大概率是当前用户没有权限访问docker.sock执行sudo usermod -aG docker $USER并重新登录。如果服务没有启动执行sudo systemctl start docker sudo systemctl enable dockerdocker服务启动失败在Linux上常见原因是daemon.json配置格式错误。用sudo dockerd前台启动能看到具体报错信息排查清楚再恢复。6.3 Kafka元数据获取失败等容器网络问题排查思路集群类组件在Docker中的网络配置是一个典型的高频坑以Kafka为例最常见的报错是Error while fetching metadata with correlation id 1 : {test-topicLEADER_NOT_AVAILABLE}这个报错通常不是因为Kafka本身崩溃而是客户端连上了错误的地址。Kafka的机制是客户端先连上Kafka服务端获取元数据服务端会返回每个分区的leader所在broker的地址客户端根据这个地址去建立真正的连接。关键就在这个返回地址上。如果Kafka跑在Docker容器里容器内部看到自己的hostname是容器ID而客户端在宿主机上拿到一个容器内部的hostname根本没有办法解析自然报LEADER_NOT_AVAILABLE或Connection refused。正确做法是在启动Kafka时配置KAFKA_ADVERTISED_LISTENERS告诉客户端真正可用的地址docker run -d \ --name kafka \ -p 9092:9092 \ -e KAFKA_ADVERTISED_LISTENERSPLAINTEXT://宿主机IP:9092 \ -e KAFKA_LISTENERSPLAINTEXT://0.0.0.0:9092 \ -e KAFKA_ZOOKEEPER_CONNECT宿主机IP:2181 \ apache/kafka:3.7.0这里的ADVERTISED_LISTENERS是给客户端看的地址LISTENERS是Kafka自己监听的地址。容器内外地址不一致时这两个字段必须分开配置这也是所有Kafka容器化部署的核心知识点。这个排查思路能迁移到很多容器网络问题上服务本身没有起错是客户端拿到的“服务地址”对不上。遇到类似报错先问自己一个问题——“客户端访问服务时它拿到的地址到底是谁在什么视角下广播的”想明白这一点容器网络的很多坑就都能绕开了。用Docker搭建DVWA靶场、Hadoop集群、人大金仓数据库这类学习环境也是同样的套路拉镜像、配端口、调网络参数本质上是在练习“怎么把一个有依赖关系的服务跑在容器里”这件事。把这一套搞通了Docker的学习也就算真正入门了。如果让我给一条学习路径建议会是这样先别急着背全部命令也不用管什么K8s、Swarm这些编排平台。第一步亲手把MySQL和Redis两个容器跑起来理解镜像拉取、端口映射、数据卷挂载这三个概念第二步用Compose把一个完整Web项目编排起来理解容器间网络和服务依赖第三步学会看日志、看docker stats定位问题。这三步走完Docker的基本功就扎实了剩下的都是在积累经验。