amarcu5/7zip

镜像概述

7-Zip多平台命令行版本Docker镜像是一个轻量级容器化解决方案，提供7-Zip命令行工具的容器化运行环境。该镜像支持在多种操作系统平台上便捷执行文件压缩与解压操作，无需在主机系统中直接安装7-Zip，适用于容器化环境或跨平台场景。

核心功能和特性

• 多平台支持：适配多种操作系统架构，可在Linux、Windows、macOS等支持Docker的平台上运行。
• 命令行界面：提供完整的7-Zip命令行功能，支持7-Zip所有标准压缩/解压命令及参数（如压缩、解压、测试归档文件等）。
• 用户权限控制：通过环境变量配置用户ID（PUID）和用户组ID（PGID），确保容器内文件操作与主机用户权限一致，避免权限冲突。
• 轻量级设计：镜像体积小巧，启动快速，资源占用低，专注于核心压缩/解压功能。

使用场景

• 在容器化环境（如Docker、Kubernetes）中处理压缩文件，避免主机系统依赖。
• 跨平台开发或部署流程中统一使用7-Zip命令行工具，确保操作一致性。
• 临时需要使用7-Zip功能但不想在主机安装7-Zip的场景。
• 自动化脚本或CI/CD流水线中集成文件压缩/解压步骤（如构建产物打包、日志压缩等）。

使用方法

基本命令格式

通过docker run命令运行容器，基本格式如下：

shell
docker run \
  --rm -i \
  --pull=always \
  -e PGID=$(id -g) \
  -e PUID=$(id -u) \
  -v [主机目录]:[容器目录]:rw \
  -w [容器工作目录] \
  amarcu5/7zip:latest \
  [7-Zip命令及参数]

参数说明

示例：解压归档文件

解压当前目录下的example.7z归档文件到当前目录：

shell
docker run \
  --rm -i \
  --pull=always \
  -e PGID=$(id -g) \
  -e PUID=$(id -u) \
  -v $(pwd):$(pwd):rw \
  -w $(pwd) \
  amarcu5/7zip:latest \
  x example.7z

示例：创建归档文件

将当前目录下的data/文件夹压缩为data.7z：

shell
docker run \
  --rm -i \
  --pull=always \
  -e PGID=$(id -g) \
  -e PUID=$(id -u) \
  -v $(pwd):$(pwd):rw \
  -w $(pwd) \
  amarcu5/7zip:latest \
  a data.7z data/

配置说明

环境变量

• PUID：用户ID，用于指定容器内运行进程的用户ID。建议设置为$(id -u)（主机当前用户ID），确保容器内创建/修改的文件与主机用户权限一致。
• PGID：用户组ID，用于指定容器内运行进程的用户组ID。建议设置为$(id -g)（主机当前用户组ID），避免文件权限冲突。

挂载目录

需将主机中包含目标文件的目录挂载到容器，格式为-v [主机目录]:[容器目录]:rw。示例中-v $(pwd):$(pwd):rw表示将主机当前目录挂载到容器内相同路径，并授予读写权限，方便直接操作当前目录下的文件。

工作目录

通过-w [容器工作目录]设置容器内工作目录，建议与挂载的主机目录保持一致（如示例中-w $(pwd)），可直接使用相对路径访问目标文件，无需输入完整路径。

7-Zip命令参考

常用7-Zip命令参数（完整命令列表可通过docker run amarcu5/7zip:latest --help查看）：

• x [归档文件]：解压归档文件到当前目录（保留目录结构）。
• a [归档文件] [源文件/目录]：创建归档文件并添加指定文件/目录。
• t [归档文件]：测试归档文件完整性。
• l [归档文件]：列出归档文件内容。