Docker 零基础：镜像、容器、仓库一张图讲透 + docker run 参数逐字拆解

   你写的配方                     模具（只读模板）              蛋糕（活的实例）
┌────────────────   build   ┌────────────────┐   run    ┌──────────────────┐
│  Dockerfile    │ ────────► │    Image 镜像   │ ───────► │  Container 容器  │
│  (文本文件)     │  构建      │ (如 nginx:1.27) │  运行     │ (进程, 可多个)    │
└────────────────┘           └───────┬────────┘          └────────┬─────────┘
                                     │                             │
                                上传/下载                    一个镜像可以
                                     ▼                     跑出很多容器
                              ┌────────────────┐
                              │  Registry 仓库   │   例如：同一个 nginx:1.27
                              │ (如 Docker Hub) │        可以开 3 个容器
                              └────────────────┘        监听不同端口

# 1. 先更新一下系统包索引（建议，不是必须）
sudo apt update

# 2. 执行官方一键安装脚本（会提示输入你的 sudo 密码）
curl -fsSL https://get.docker.com | sudo bash

# 3. 安装完成，看版本验证（能输出版本号就说明装好了）
docker --version

Docker version 27.x.x, build xxxx

# 1. 更新包索引
sudo apt update

# 2. 安装前置依赖（允许 apt 使用 https 源）
sudo apt install -y ca-certificates curl gnupg

# 3. 添加 Docker 官方的 GPG 密钥
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 a+r /etc/apt/keyrings/docker.gpg

# 4. 把 Docker 仓库写入 apt 源
#    注意把 "noble" 换成你的发行版代号：
#    Ubuntu 24.04=noble, 22.04=jammy, 20.04=focal
#    Debian 12=bookworm, 11=bullseye
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. 更新索引并安装
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 6. 验证
docker --version

# 1. 把当前用户加入 docker 组
sudo usermod -aG docker $USER

# 2. 让组生效：必须退出当前终端重新登录（或执行下面这句立刻生效）
newgrp docker
# 或者更彻底：注销账号重新登录

# 3. 不加 sudo 直接跑，能输出版本即成功
docker --version

# 4. 终极验证（第四节细讲）
docker run hello-world

# 查看 docker 服务状态（正常应显示 active (running)）
sudo systemctl status docker

# 如果没在跑，启动它
sudo systemctl start docker

# 设置开机自启（一般默认已开）
sudo systemctl enable docker

docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
4f53...: Pull complete
Digest: sha256:xxxx...
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

# 看最近创建的所有容器（包括已停止的）
docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                      PORTS     NAMES
a1b2c3d4e5f6   hello-world    "/hello"                 2 minutes ago    Exited (0) 2 minutes ago                loving_turing

# 删掉这个已经退出的容器（它只占几 KB，不删也无所谓）
docker rm $(docker ps -a -q)
# 解释：ps -a -q 列出所有容器 ID（-q 只输出 ID），rm 删掉

# 先确保拉下 nginx 镜像（第一次会下载，约 50~100 MB）
docker pull nginx

# -d = --detach，后台运行
docker run -d --name web1 nginx

# 应该能看到 web1 在运行（STATUS 是 Up）
docker ps

# 访问它（宿主机 80 端口被 nginx 占用，浏览器打开 http://127.0.0.1 能看到 nginx 欢迎页）
curl http://127.0.0.1

# 先清掉上一个（释放 80 端口）
docker rm -f web1

# -p 8080:80  宿主机8080 → 容器80
docker run -d -p 8080:80 --name web2 nginx

# 访问 8080，而不是 80
curl http://127.0.0.1:8080
# 能看到 nginx 欢迎页 = 端口映射成功

# 宿主机建个目录（可选，不建 Docker 也会自动建）
sudo mkdir -p /data

# -v 宿主机路径:容器内路径
docker run -d -p 8080:80 -v /data:/data --name web3 nginx

# 进容器（第五节第 5 个参数会讲 exec，这里先直接用）
docker exec -it web3 sh -c 'echo "hello from container" > /data/test.txt'

# 在宿主机上看（应该能看到这个文件！）
cat /data/test.txt
# 输出: hello from container

# -e 传入多个环境变量，用空格分隔多个 -e
docker run -d -p 8080:80 \
  -e NGINX_PORT=80 \
  -e TZ=Asia/Shanghai \
  --name web4 nginx

# 容器里 echo 刚才设的变量
docker exec web4 sh -c 'echo $TZ'
# 输出: Asia/Shanghai

docker run -d -p 8080:80 --name my-nginx nginx

# 用名字操作，不用记 ID
docker stop my-nginx
docker logs -f my-nginx
docker rm my-nginx

# 注意：--rm 和 -d 一般一起用；前台模式下 Ctrl+C 后也会自动删
docker run --rm -p 8080:80 nginx

# 跑一个马上退出的容器，加 --rm
docker run --rm hello-world
# 跑完再看，应该找不到这个容器了（被自动删了）
docker ps -a | grep hello
# （无输出 = 已被自动清理）

docker run -d -p 8080:80 --name web5 --restart always nginx

# 找到容器内 nginx 主进程 PID 并杀掉
docker exec web5 sh -c 'kill 1'

# 过 1~2 秒再看，容器又活了（被自动重启）
docker ps | grep web5
# STATUS 会显示 Up 2 seconds（重启时间很短）

docker run -d \
  -p 8080:80 \
  -v /opt/nginx/html:/usr/share/nginx/html \
  -e TZ=Asia/Shanghai \
  --name prod-nginx \
  --restart always \
  nginx

docker exec -it my-nginx sh

pull（拉镜像） → run（起容器） → ps（看状态） → logs（看日志） → exec（进去调） → stop（停） → rm（删容器） → rmi（删镜像）

[仓库地址/]/[命名空间/]/镜像名[:标签]
       ↓                ↓        ↓      ↓
   hub.docker.com  library   nginx   latest   （可省略，默认 latest）

# 拉取最新版 nginx（:latest 可省略）
docker pull nginx

# 拉取指定版本（强烈建议生产环境锁版本！）
docker pull nginx:1.27

# 拉取一个完整地址的镜像（社区镜像）
docker pull bitnami/mysql:8.0

# 搜索名字里含 "nginx" 的镜像
docker search nginx

# 只看官方（带 "OFFICIAL" 标记）且星标数高的
docker search --filter is-official=true --filter stars=1000 nginx

NAME      DESCRIPTION                                           STARS     OFFICIAL
nginx     Official build of Nginx.                              20000+    [OK]
tutum/nginx  nginx with SSL for HTTPS (uses nginx:stable)        120
...

# 看同一个镜像的所有 tag（去 hub.docker.com 页面看，或）
docker pull nginx:1.27
docker pull nginx:1.25
docker pull nginx:stable

# 现在本地有了三个不同标签的 nginx
docker images | grep nginx

# 把本地 nginx:1.27 复制一份标签，叫 my-nginx:v1
# （注意：不是"移动"，原标签还在，相当于多起一个别名）
docker tag nginx:1.27 my-nginx:v1

# 之后 push 到私有仓库时会用到这个 tag
docker images | grep my-nginx

# 1. 编辑 daemon 配置（没有就新建）
sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://你的专属加速地址",
    "https://备用加速地址"
  ]
}
EOF

# 2. 重载配置并重启 docker
sudo systemctl daemon-reload
sudo systemctl restart docker

# 3. 验证（能看到 Mirrors 字段即生效）
docker info | grep -A 5 "Registry Mirrors"

# 4. 再拉一个镜像试试
docker pull nginx

容器 = 镜像（只读） + 容器读写层（临时） + 配置
                ↑ 这部分是临时的，删容器就没了

┌─────────────── 宿主机 ───────────────┐
│  /opt/mydata/                        │  ← 真实数据存在这儿
│      ├── db/                         │
│      └── conf/                       │
│            │                          │
│            ▼ （-v 挂载绑定）            │
├─────────── Docker ───────────────────┤
│  ┌─── 容器 ───┐                      │
│  │  /data     │◄── 容器里看到的就是它  │
│  │  (读写)    │    删容器不影响        │
│  └────────────┘                      │
└──────────────────────────────────────┘

# 建一个目录放网页
sudo mkdir -p /opt/nginx/html

# 写一个首页
sudo tee /opt/nginx/html/index.html <<'EOF'
<!DOCTYPE html>
<html lang="zh">
<head><meta charset="utf-8"><title>我的第一个 Docker 网站</title></head>
<body>
  <h1>Hello, Docker!</h1>
  <p>我是从宿主机 /opt/nginx/html 挂载进来的。</p>
</body>
</html>
EOF

# nginx 镜像里默认网页根目录是 /usr/share/nginx/html
# 把宿主机的 /opt/nginx/html 挂过去
docker run -d \
  -p 8080:80 \
  -v /opt/nginx/html:/usr/share/nginx/html \
  --name site \
  --restart always \
  nginx

# 访问，能看到你写的中文页面
curl http://127.0.0.1:8080
# 输出里包含 "Hello, Docker!"

# 改宿主机里的文件（加一行）
sudo bash -c 'echo "<p>—— 刚刚加的，秒生效！</p>" >> /opt/nginx/html/index.html'

# 再访问，立刻看到新内容（不用 restart，不用重建容器）
curl http://127.0.0.1:8080

# 删掉容器
docker rm -f site

# 宿主机上的文件还在
ls /opt/nginx/html/
# index.html 还在

# 重新起容器，挂回同一目录，网站秒恢复
docker run -d -p 8080:80 -v /opt/nginx/html:/usr/share/nginx/html --name site nginx
curl http://127.0.0.1:8080   # 内容还在！

docker volume inspect mydata
# 看 "Mountpoint" 字段

Dockerfile（配方） --docker build--> 镜像（成品） --docker run--> 容器（运行的实例）

mkdir -p ~/docker-site && cd ~/docker-site

cat > index.html <<'EOF'
<!DOCTYPE html>
<html lang="zh">
<head><meta charset="utf-8"><title>Dockerfile 实战</title></head>
<body><h1>这个页面是被 COPY 进镜像的！</h1></body>
</html>
EOF

cat > Dockerfile <<'EOF'
# 1. 基础镜像：从官方 nginx 开始（拉 nginx:1.27 作为底子）
FROM nginx:1.27

# 2. 把本机的 index.html 拷进镜像的网页根目录
#    （覆盖掉镜像里自带的默认欢迎页）
COPY index.html /usr/share/nginx/html/index.html

# 3. 声明容器会用到 80 端口（文档作用，真正映射靠 -p）
EXPOSE 80

# 4. 容器启动时默认执行的命令
#    （nginx 官方镜像的默认 CMD 就是启动 nginx，这里显式写出来教学）
CMD ["nginx", "-g", "daemon off;"]
EOF

# 在 Dockerfile 所在目录执行
# -t 给镜像打标签：名字叫 my-site，版本 v1
docker build -t my-site:v1 .

Step 1/4 : FROM nginx:1.27
 ---> xxxxxxx
Step 2/4 : COPY index.html /usr/share/nginx/html/index.html
 ---> yyyyyyy
Step 3/4 : EXPOSE 80
 ---> zzzzzzz
Step 4/4 : CMD ["nginx","-g","daemon off;"]
 ---> [Building] aaaaaaa
Successfully built aaaaaaa
Successfully tagged my-site:v1

docker run -d -p 8080:80 --name my-site my-site:v1

# 访问，看到你被 COPY 进去的页面
curl http://127.0.0.1:8080
# 输出包含 "这个页面是被 COPY 进镜像的！"

# 进容器看文件
docker exec my-site cat /usr/share/nginx/html/index.html
# 能看到你写的 HTML 内容

# 好习惯：变化少的放前面，变化多的放后面
FROM nginx:1.27
RUN apt-get update && apt-get install -y xxx   # 很少变，靠后变化少时命中缓存
COPY index.html /usr/share/nginx/html/          # 经常变，放后面
CMD ["nginx","-g","daemon off;"]

# 第一斧：看日志（80% 的问题这里就有答案）
docker logs --tail 100 -f 容器名

# 第二斧：看容器详情（状态、退出码、挂载、网络、Error 字段）
docker inspect 容器名

# 第三斧：进去看（容器还在跑时，进到里面亲自检查）
docker exec -it 容器名 sh
# 进去后：ps aux（进程在不在？） / cat 配置文件 / 手动跑启动命令看报错

        ┌──────────────┐
        │  痛点：环境不一致  │
        └─────────────┘
               ▼
        ┌──────────────┐   构建     ┌──────────────┐
        │  Dockerfile   │ ────────► │  Image 镜像    │
        │  （配方）       │ build     │  （只读模板）   │
        └──────────────┘           └──────┬───────┘
                                          │ run
                                          ▼
        ┌──────────────┐   pull/push  ┌──────────────┐
        │  Registry 仓库 │ ◄─────────── │ Container 容器 │
        │  （镜像商店）   │              │  （活的进程）   │
        └──────────────┘              └──────────────┘
                                          │ -v 挂载
                                          ▼
                                   宿主机目录（数据持久化）