0xdmarket/tools

镜像概述

本Docker镜像为开发者提供了一个集成多种常用命令行工具(CLI)的统一环境，旨在解决不同开发环境中工具版本不一致、依赖缺失等问题，确保开发者可在任何支持Docker的环境中便捷使用标准化的命令行工具集。

核心功能与特性

工具集成

包含开发者日常高频使用的CLI工具，主要包括：

• 版本控制工具：Git
• 网络工具：curl、wget、ping、telnet
• 数据处理工具：jq（JSON处理）、csvkit（CSV处理）
• 文本编辑工具：vim、nano
• 系统工具：ssh-client、rsync、tar、gzip
• 容器相关工具：docker-cli（可选）

核心特性

• 版本统一：所有工具版本预配置且固定，避免因版本差异导致的兼容性问题
• 轻量级基础：基于Alpine或Debian Slim基础镜像构建，减少镜像体积（通常<200MB）
• 即开即用：无需手动安装依赖，拉取镜像后可直接使用所有集成工具
• 跨平台兼容：支持Linux/Windows/macOS等所有Docker兼容系统

使用场景

1. 开发环境标准化：团队统一使用该镜像作为命令行工具环境，消除"本地能运行，线上跑不通"的环境差异问题
2. CI/CD流程集成：在Jenkins、GitHub Actions等CI/CD管道中作为命令行执行环境，执行构建、部署、测试等脚本
3. 临时工具环境：快速搭建包含特定工具的临时命令行环境，用完即毁，不污染本地系统
4. 跨平台工具使用：在不原生支持某些工具的操作系统（如Windows）中，通过该镜像使用类Unix命令行工具

使用方法

基本使用

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像名称]:[标签]  # 替换为实际镜像名称和标签，如未指定标签通常使用latest

2. 启动交互式命令行

bash
docker run -it --rm [镜像名称] /bin/bash

• -it：启用交互式终端
• --rm：退出后自动删除容器，避免残留
• /bin/bash：启动Bash shell（部分基础镜像可能使用/bin/sh）

高级用法

1. 挂载本地目录

将本地项目目录挂载到容器中，使用工具处理本地文件：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像名称] /bin/bash

• -v $(pwd):/workspace：将当前目录挂载到容器的/workspace
• -w /workspace：设置工作目录为/workspace

2. 直接执行命令

无需进入交互模式，直接执行单条命令：

bash
# 示例：使用curl下载文件到本地当前目录
docker run -it --rm -v $(pwd):/data -w /data [镜像名称] curl -O https://example.com/file.txt

# 示例：使用jq处理JSON文件
docker run -it --rm -v $(pwd):/data -w /data [镜像名称] jq '.key' data.json

3. 自定义工具配置

如需持久化工具配置（如Git配置、vimrc），可挂载配置目录：

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -v ~/.gitconfig:/root/.gitconfig \
  -v ~/.vimrc:/root/.vimrc \
  -w /workspace \
  [镜像名称] /bin/bash

环境变量（可选）

如镜像支持自定义配置，可通过环境变量调整工具行为（具体变量需参考镜像详细说明）：

bash
# 示例：设置默认时区
docker run -it --rm -e TZ=Asia/Shanghai [镜像名称] /bin/bash

注意事项

• 敏感操作（如SSH密钥使用）建议通过挂载方式传入，避免将敏感信息内置到容器中
• 如需要添加额外工具，可基于本镜像构建自定义镜像（示例Dockerfile）：

  dockerfile
  FROM [镜像名称]:latest
  RUN apk add --no-cache [额外工具名称]  # 如使用Alpine基础
  # 或 RUN apt-get update && apt-get install -y [额外工具名称]  # 如使用Debian基础