异常教程

docker 进入容器（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在现代软件开发中，Docker 容器技术已成为构建、部署和运行应用的主流选择。然而，许多开发者在实际使用过程中会遇到一个问题：如何安全且高效地进入正在运行的容器，进行调试、日志查看或临时命令执行？本文将从零开始，以通俗易懂的方式讲解 docker 进入容器 的核心方法，并通过实际案例演示操作流程。无论你是编程新手还是有一定经验的开发者，都能从中获得实用技能。

基础概念：容器是什么？

在深入 docker 进入容器 的具体操作前，我们先用一个比喻理解容器的本质。
想象你有一间标准化的“集装箱房间”，房间内预装了特定的家具（软件环境）、电器（依赖库）和规则（配置文件），而每个集装箱房间完全隔离，互不影响。Docker 容器正是如此：它是一个独立的运行环境，包含应用所需的所有依赖，但占用资源极低。

当开发者需要调试容器内的应用时，就类似于需要“打开集装箱的门”，进入内部查看或调整设备。接下来，我们将学习如何打开这扇“门”。

方法一：使用 docker exec 命令

1.1 基本语法与原理

docker exec 是进入正在运行的容器最常用的方法。其核心原理是：在已启动的容器内执行新进程。
命令格式：

docker exec [OPTIONS] CONTAINER COMMAND
  • CONTAINER：容器名称或ID（可通过 docker ps 查看）
  • COMMAND：要在容器内执行的命令（如 bash 或 sh）

1.2 实例演示：进入 Nginx 容器

假设我们已运行一个 Nginx 容器：

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

要进入该容器，执行：

docker exec -it my-nginx /bin/bash
  • -i：保持 STDIN 打开，允许交互
  • -t：分配伪终端（TTY），提供类似 shell 的体验
  • /bin/bash：指定默认 shell（若容器镜像未安装 bash，可改用 /bin/sh）

此时，终端会切换到容器内部的 / 目录，你可以像操作本地系统一样执行命令，例如：

cat /etc/nginx/conf.d/default.conf  

echo "server_tokens off;" >> /etc/nginx/nginx.conf  
nginx -s reload

1.3 注意事项

  • 容器必须处于运行状态：若容器已停止，需先用 docker start 启动。
  • 进程隔离性：通过 exec 进入的 shell 会作为容器内一个独立进程存在，关闭终端不会影响容器运行。

方法二：通过 docker run 新建交互式容器

在某些场景下，比如需要进入一个未运行的容器，或希望以特定方式启动容器，可以借助 docker run 的交互模式。

2.1 基本用法

docker run -it --entrypoint /bin/bash IMAGE_NAME

此命令会：

  1. 以交互模式（-it）启动新容器；
  2. 覆盖原有入口点（--entrypoint），直接进入 bash；
  3. 使用指定镜像（如 nginx 或 ubuntu）。

例如，若想进入一个临时的 Ubuntu 容器：

docker run -it --name temp-ubuntu -d ubuntu  
docker exec -it temp-ubuntu bash

2.2 实际场景：修复损坏的容器

假设某容器因配置错误无法启动，可通过此方法修复：

docker run -it --name broken-app -v /host/path:/container/path my-app  

vim /app/config.json

方法三：利用 nsenter 工具（进阶）

对于高级用户，nsenter 可以通过直接操作命名空间（Namespace）进入容器，无需依赖 Docker API。

3.1 准备工作

  1. 确保宿主机已安装 util-linux 包（包含 nsenter）： 
    sudo apt-get install util-linux
  2. 获取容器的 PID（进程ID）： 
    CONTAINER_ID=$(docker ps -q -f name=my-container)  
PID=$(docker inspect --format '{{.State.Pid}}' $CONTAINER_ID)

3.2 执行进入命令

nsenter --target $PID --mount --uts --ipc --net --pid

此命令会将宿主机的 shell 会话“注入”到目标容器的命名空间中。

3.3 适用场景

  • 容器因权限问题无法使用 docker exec（例如未以特权模式运行）；
  • 需要直接访问容器的底层资源（如网络接口或挂载点）。

常见问题与解决方案

4.1 无法进入容器：exec: "bash": executable file not found

原因：容器镜像未安装 bash（如 Alpine 镜像默认使用 ash）。
解决方法：改用容器内可用的 shell：

docker exec -it my-alpine-container ash

4.2 进入容器后无法退出

按 Ctrl+D 或执行 exit 命令即可退出当前 shell，容器本身仍会继续运行。

4.3 容器停止后如何恢复？

若容器已停止，需先启动它：

docker start my-container  
docker exec -it my-container bash

实战案例：调试一个故障的 Node.js 应用

5.1 场景描述

假设我们有一个 Node.js 容器，日志显示应用启动失败，但具体原因不明。

5.2 操作步骤

  1. 启动并运行容器（若未运行）： 
    docker start my-node-app
  2. 进入容器： 
    docker exec -it my-node-app bash
  3. 检查日志和依赖： 
    # 查看应用日志  
cat /app/logs/error.log  

# 检查 Node.js 版本  
node -v  

# 安装缺失的依赖  
npm install
  4. 退出并重启容器以应用更改： 
    exit  
docker restart my-node-app

结论

通过本文的讲解，我们掌握了三种 docker 进入容器 的核心方法：docker exec 的直接进入、docker run 的交互启动，以及 nsenter 的底层操作。这些技能能帮助开发者快速定位问题、调试应用，并在复杂场景下灵活应对容器管理需求。

建议读者通过实际操作加深理解：尝试创建一个简单容器，然后使用上述方法进入并执行命令。随着经验的积累，你将能更高效地驾驭 Docker 这一强大的容器化工具，为开发和运维工作提供更坚实的保障。

关键词自然布局：

  • docker 进入容器
  • docker exec 命令
  • 容器调试
  • 容器交互式启动
  • nsenter 工具

最新发布

查看更多文章