Docker 容器内没有 vim/curl 怎么装调试工具？

Question

仓乃文 · Accepted Answer

生产容器通常基于 Alpine 或 distroless 等精简镜像，里面没有 vim、curl、ping 等调试工具。容器内 apt-get 或 apk 安装又经常失败，初学者往往束手无策。不同基础镜像的包管理器： ```bash # Alpine（apk） docker exec -it myapp sh apk add vim curl apk add --no-cache vim curl # 不缓存索引，镜像更小 # Debian/Ubuntu（apt） docker exec -it myapp bash apt-get update && apt-get install -y vim curl # CentOS/RHEL（yum） yum install -y vim curl # distroless（无包管理器，无法安装） # 只能用 docker cp 复制文件出来看 ``` Alpine 镜像安装常见问题： ```bash # 问题 1：apk 下载超时 # 原因：默认源在国外 # 修复：换国内源 sed -i "s/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g" /etc/apk/repositories apk add --no-cache vim curl # 问题 2：包名不一样 # Alpine 的包名和 Ubuntu 不同 apk add vim # 不是 vim-nox apk add curl # 和 Ubuntu 一样 apk add iputils # ping 命令在这个包里 apk add net-tools # ifconfig apk add bind-tools # nslookup、dig apk add tcpdump # 抓包 apk add mysql-client # mysql 命令行 apk add redis # redis-cli # 问题 3：安装后镜像变大 # 这些工具只在调试时用，不要写进 Dockerfile # 用 docker exec 临时安装即可 # 容器重建后工具就没了 ``` 不用进容器的替代方案： ```bash # 1. 查看文件内容 docker exec myapp cat /etc/nginx/nginx.conf docker exec myapp ls -la /app/logs/ # 2. 复制文件到宿主机查看 docker cp myapp:/app/config.yml ./config.yml docker cp myapp:/var/log/app.log ./app.log # 3. 在宿主机上调试网络 docker inspect myapp --format "{{.NetworkSettings.IPAddress}}" ping curl http://:8080/health # 4. 用临时调试容器（推荐） docker run --rm --network container:myapp alpine sh # 和 myapp 共享网络命名空间 # 可以用 curl/ping 访问 myapp 能访问的所有服务 apk add curl && curl http://localhost:8080/health ``` 调试专用 Dockerfile 技巧： ```dockerfile # 开发环境 Dockerfile（带调试工具） FROM node:18-alpine # 只在开发环境安装调试工具 ARG ENV=production RUN if [ "$ENV" != "production" ]; then \ apk add --no-cache vim curl bash; \ fi # 或用多阶段构建，调试镜像和生产镜像分开 FROM node:18-alpine AS dev RUN apk add --no-cache vim curl bash FROM node:18-alpine AS prod # 不装调试工具 ``` 补充说明： - 生产容器不建议装调试工具，增加攻击面和镜像体积 - 临时调试用 docker exec 安装，容器重建后自动清除 - distroless 镜像没有 shell，只能用 docker cp 或临时调试容器 - 规则：调试用临时容器或 docker cp，不要在生产镜像中装调试工具 - Alpine 换源是解决安装慢的关键