jpetazzo/nsenter

jpetazzo/nsenter镜像说明

镜像概述

该镜像旨在构建并安装nsenter工具，曾是Docker早期版本（1.3前）进入容器命名空间的常用方案。随着Ubuntu 16.04+等现代发行版内置nsenter，此镜像已停止维护，仅作历史参考或学习用途。

核心功能

1. 构建nsenter二进制文件并快速安装到系统
2. 提供docker-enter脚本简化容器进入操作
3. 支持安全提取二进制文件（无需直接挂载系统路径）

使用场景

• 调试容器（绕过cgroups资源限制）
• 容器外部审计
• 学习容器命名空间原理

配置说明

安装nsenter

方法1：直接安装到系统路径

bash
docker run --rm -v /usr/local/bin:/target jpetazzo/nsenter

方法2：提取二进制文件（更安全）

bash
docker run --rm jpetazzo/nsenter cat /nsenter > /tmp/nsenter && chmod +x /tmp/nsenter

使用nsenter进入容器

1. 获取容器PID：

bash
PID=$(docker inspect --format {{.State.Pid}} <容器名称/ID>)

2. 进入容器命名空间：

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

使用docker-enter脚本

直接进入容器（无需手动获取PID）：

bash
# 进入容器shell
docker-enter <容器名称/ID>
# 执行指定命令
docker-enter <容器名称/ID> ls /var/log

Docker Toolbox（OS X/Windows）使用

1. SSH到虚拟机：

bash
docker-machine ssh default

2. 安装nsenter：

bash
docker run --rm -v /usr/local/bin:/target jpetazzo/nsenter

3. 进入容器：

bash
PID=$(docker inspect --format {{.State.Pid}} <容器ID>)
sudo nsenter --target $PID --mount --uts --ipc --net --pid

Boot2docker使用

添加以下函数到本地shell配置文件（如~/.bashrc）：

bash
docker-enter() {
  boot2docker ssh '[ -f /var/lib/boot2docker/nsenter ] || docker run --rm -v /var/lib/boot2docker/:/target jpetazzo/nsenter'
  boot2docker ssh -t sudo /var/lib/boot2docker/docker-enter "$@"
}

之后可直接在本地执行：

bash
docker-enter <容器名称/ID>

注意事项

• 仅支持Intel 64位平台
• nsenter需在主机运行，暂不支持容器内执行
• 现代发行版已内置nsenter，此镜像仅作历史参考