glenschler/nodejs-inspector

镜像概述

本镜像基于Node.js官方版本构建，集成node-inspector调试工具，提供5.x、4.x、0.12、0.10等多版本支持，旨在帮助开发者在隔离的Docker环境中快速调试Node.js应用，避免修改本地环境。

核心功能

• 支持多版本Node.js调试环境
• 利用Docker缓存层快速构建应用镜像
• 支持容器内调试与本地目录挂载调试
• 提供灵活的容器控制命令（重启、日志查看、进入容器等）

使用场景

• 本地Node.js应用的隔离调试
• 多版本Node.js兼容性测试
• 无需改变本地Node.js环境的临时调试需求

配置说明

1. 准备环境

克隆仓库到本地应用目录并复制配置文件：

bash
cd ./yourapplication
git clone https://github.com/glennschler/docker-debugnode
cp -n ./docker-debugnode/.dockerignore .

2. 构建或拉取镜像

版本5.x

bash
# 构建镜像
docker build -t nodejs-inspector:5 ./docker-debugnode/nodejs-inspector/v5
# 或拉取镜像并重命名
docker pull glenschler/nodejs-inspector:5
docker tag glenschler/nodejs-inspector:5 nodejs-inspector:5
docker rmi glenschler/nodejs-inspector:5

版本4.x

bash
docker build -t nodejs-inspector:4 ./docker-debugnode/nodejs-inspector/v4
# 或拉取
docker pull glenschler/nodejs-inspector:4
docker tag glenschler/nodejs-inspector:4 nodejs-inspector:4
docker rmi glenschler/nodejs-inspector:4

版本0.12

bash
docker build -t nodejs-inspector:0.12 ./docker-debugnode/nodejs-inspector/v0.12.LTS
# 或拉取
docker pull glenschler/nodejs-inspector:0.12
docker tag glenschler/nodejs-inspector:0.12 nodejs-inspector:0.12
docker rmi glenschler/nodejs-inspector:0.12

版本0.10

bash
docker build -t nodejs-inspector:0.10 ./docker-debugnode/nodejs-inspector/v0.10.LTS
# 或拉取
docker pull glenschler/nodejs-inspector:0.10
docker tag glenschler/nodejs-inspector:0.10 nodejs-inspector:0.10
docker rmi glenschler/nodejs-inspector:0.10

3. 构建应用调试镜像

以版本5.x为例：

bash
docker build -t nodeapp-debug:5 --file=./docker-debugnode/debugapp/v5/Dockerfile .

替换版本号和路径可构建其他版本。

4. 运行调试容器

bash
# 版本5.x
docker run --name nodeapp-v5 -p 8080:8080 nodeapp-debug:5
# 版本4.x
docker run --name nodeapp-v4 -p 8080:8080 nodeapp-debug:4
# 版本0.12
docker run --name nodeapp-v0.12 -p 8080:8080 nodeapp-debug:0.12
# 版本0.10
docker run --name nodeapp-v0.10 -p 8080:8080 nodeapp-debug:0.10

5. 开始调试

1. 获取容器IP：

bash
docker-machine ip docker-01 # 替换为你的Docker机器名称

2. 在浏览器访问：http://[容器IP]:8080/?port=5858开始调试。

额外控制命令

• 重启容器：docker restart nodeapp-v4
• 查看日志：docker logs nodeapp-v4
• 进入容器：docker exec -i -t nodeapp-v4 bash
• 挂载本地目录调试：

bash
docker run --name nodeapp-v4 -p 8080:8080 -v ${PWD}:/opt/app/node nodeapp-debug:4 ./test/test2.js arg1 arg2