## 进入容器 ### 为什么需要进入容器 使用 `-d` 参数启动容器后，容器在后台运行。以下场景需要进入容器内部操作： | 场景 | 示例 | |------|------| | **调试问题** | 查看日志、检查配置、排查错误 | | **临时操作** | 执行数据库迁移、清理缓存 | | **检查状态** | 查看进程、网络连接、文件系统 | | **开发测试** | 交互式测试命令、验证环境 | ### 两种进入方式 Docker 提供两种进入容器的命令： | 命令 | 推荐程度 | 特点 | |------|---------|------| | `docker exec` | ✅ **推荐** | 启动新进程，退出不影响容器 | | `docker attach` | ⚠️ 谨慎使用 | 附加到主进程，退出可能停止容器 | --- ### docker exec（推荐） #### 基本用法 运行以下命令： ```bash ## 进入容器并启动交互式 shell $ docker exec -it 容器名 /bin/bash ## 或使用 sh（适用于 Alpine 等精简镜像） $ docker exec -it 容器名 /bin/sh ``` #### 参数说明 | 参数 | 作用 | |------|------| | `-i` | 保持标准输入打开（interactive） | | `-t` | 分配伪终端（TTY） | | `-it` | 两者组合，获得完整交互体验 | | `-u` | 指定用户（如 `-u root`） | | `-w` | 指定工作目录 | | `-e` | 设置环境变量 | #### 示例 运行以下命令： ```bash ## 启动一个后台容器 $ docker run -dit --name myubuntu ubuntu 69d137adef7a... ## 进入容器（交互式 shell） $ docker exec -it myubuntu bash root@69d137adef7a:/# ls bin boot dev etc home lib ... root@69d137adef7a:/# exit ## 容器仍在运行！ $ docker ps CONTAINER ID IMAGE STATUS NAMES 69d137adef7a ubuntu Up 2 minutes myubuntu ``` #### 执行单条命令 不进入交互模式，直接执行命令： ```bash ## 查看容器内进程 $ docker exec myubuntu ps aux ## 查看配置文件 $ docker exec myubuntu cat /etc/nginx/nginx.conf ## 以 root 用户执行 $ docker exec -u root myubuntu apt update ``` #### 只用 -i 不用 -t 的区别 运行以下命令： ```bash ## 只用 -i：可以执行命令，但没有提示符 $ docker exec -i myubuntu bash ls # 输入命令 bin # 输出结果 boot dev ... ## 用 -it：有完整的终端体验 $ docker exec -it myubuntu bash root@69d137adef7a:/# # 有提示符 ``` > 💡 通常使用 `-it` 组合。只有在脚本中需要通过管道传入命令时才只用 `-i`。 --- ### docker attach（谨慎使用） #### 基本用法 运行以下命令： ```bash $ docker attach 容器名 ``` #### 工作原理 `attach` 会附加到容器的**主进程**（PID 1）的标准输入输出： ``` ┌─────────────────────────────────────────┐ │ 容器 │ │ ┌─────────────────────────────────┐ │ │ │ PID 1: /bin/bash (主进程) │◄───┼─── docker attach 附加到这里 │ │ └─ 你的输入直接发送到主进程 │ │ │ └─────────────────────────────────┘ │ └─────────────────────────────────────────┘ ``` #### 示例 运行以下命令： ```bash ## 启动容器 $ docker run -dit --name myubuntu ubuntu 243c32535da7... ## 附加到容器 $ docker attach myubuntu root@243c32535da7:/# ``` #### ⚠️ 重要警告 **从 attach 会话中输入 `exit` 或按 `Ctrl+D` 会导致容器停止！** ```bash $ docker attach myubuntu root@243c32535da7:/# exit # 这会停止容器！ $ docker ps CONTAINER ID IMAGE STATUS NAMES 243c32535da7 ubuntu Exited (0) 2 seconds ago myubuntu ``` **原因**：attach 附加到主进程，退出主进程就等于退出容器。 #### 安全退出 attach 使用 `Ctrl+P` 然后 `Ctrl+Q` 可以从 attach 会话中**分离**，而不停止容器： ```bash $ docker attach myubuntu root@243c32535da7:/# ## 按 Ctrl+P 然后 Ctrl+Q read escape sequence $ docker ps # 容器仍在运行 CONTAINER ID IMAGE STATUS NAMES 243c32535da7 ubuntu Up 5 minutes myubuntu ``` --- ### exec vs attach 对比 | 特性 | docker exec | docker attach | |------|-------------|---------------| | **工作方式** | 在容器内启动新进程 | 附加到主进程 | | **退出影响** | 不影响容器 | 可能停止容器 | | **多终端** | 可以开多个 | 共享同一个会话 | | **适用场景** | 调试、临时操作 | 查看主进程输出 | | **推荐程度** | ✅ 推荐 | ⚠️ 特殊场景使用 | ``` docker exec docker attach ┌─────────────────────┐ ┌─────────────────────┐ │ 容器 │ │ 容器 │ │ ┌───────────────┐ │ │ ┌───────────────┐ │ │ │ PID 1: nginx │ │ │ │ PID 1: bash │◄─┼── 附加到主进程 │ ├───────────────┤ │ │ └───────────────┘ │ │ │ PID 50: bash │◄─┼── 新进程 │ │ │ └───────────────┘ │ │ │ └─────────────────────┘ └─────────────────────┘ 退出 bash 不影响 nginx 退出 bash 容器停止 ``` --- ### 最佳实践 #### 1. 首选 docker exec 运行以下命令： ```bash ## 进入容器调试 $ docker exec -it myapp bash ## 查看日志 $ docker exec myapp tail -f /var/log/app.log ## 执行数据库迁移 $ docker exec myapp python manage.py migrate ``` #### 2. 生产环境避免进入容器 笔者建议：生产环境应尽量避免进入容器直接操作，而是通过： - 日志系统查看日志（如 `docker logs` 或集中式日志） - 监控系统查看状态 - 重新部署而非手动修改 #### 3. 无 shell 镜像的处理 某些精简镜像（如基于 `scratch` 或 `distroless`）没有 shell： ```bash ## 这会失败 $ docker exec -it myapp bash OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found ## 解决方案：使用调试容器（Docker Desktop 或 Kubernetes debug） $ docker debug myapp ``` --- ### 常见问题 #### Q: exec 进入后看不到其他终端的操作 这是正常的。exec 启动的是独立进程，多个 exec 会话互不影响。 #### Q: 容器没有 bash 尝试使用 sh： ```bash $ docker exec -it myapp /bin/sh ``` #### Q: 需要 root 权限 运行以下命令： ```bash $ docker exec -u root -it myapp bash ``` --- ### 本章小结 | 需求 | 推荐命令 | |------|---------| | 进入容器调试 | `docker exec -it 容器名 bash` | | 执行单条命令 | `docker exec 容器名 命令` | | 查看主进程输出 | `docker attach 容器名`（慎用） | ### 延伸阅读 - [后台运行](5.2_daemon.md)：理解容器主进程 - [查看容器](ls.md)：列出和过滤容器 - [容器日志](logs.md)：查看容器输出