vladgh/gpg

GPG Docker镜像

镜像概述和主要用途

本镜像基于GnuPG（GNU Privacy Guard）构建，提供轻量级GPG工具环境，用于安全加密文件、数字签名及密钥管理。适用于需要在隔离环境中执行GPG操作的场景，避免直接在主机安装GPG依赖。

核心功能和特性

• 支持GPG版本查看、密钥列表管理
• 提供文件对称加密功能
• 支持GPG密钥生成（含熵不足解决方案）
• 支持公钥/私钥导出
• 通过卷挂载实现密钥持久化存储

使用场景和适用范围

• 开发环境中对敏感配置文件加密
• 自动化部署流程中的文件签名验证
• 需隔离密钥存储的安全操作场景
• 临时GPG操作（无需在主机安装GPG）

详细使用方法和配置说明

基础配置说明

• 密钥持久化：通过 -v /path/to/keys/store:/root/.gnupg 挂载主机目录至容器内GPG密钥存储路径，实现密钥持久化
• 终端配置：添加环境变量 -e GPG_TTY=/dev/console 解决终端交互问题

常用操作示例

1. 显示GPG版本

SH
docker run --rm -it vladgh/gpg --version

2. 列出密钥

SH
docker run -it -v /path/to/keys/store:/root/.gnupg -e GPG_TTY=/dev/console vladgh/gpg --list-keys

说明：需提前通过/path/to/keys/store挂载存储密钥的主机目录

3. 对称加密文件

（执行后需输入密码进行加密）

SH
docker run -it -v $(pwd):/gpg -e GPG_TTY=/dev/console vladgh/gpg --symmetric /gpg/my_file

说明：-v $(pwd):/gpg 将当前主机目录挂载至容器内/gpg路径，加密文件需位于该目录

4. 生成GPG密钥

SH
docker run -it -v /path/to/keys/store:/root/.gnupg -e GPG_TTY=/dev/console vladgh/gpg --full-gen-key

若提示"熵不足"，在新终端启动以下容器增加系统熵：

SH
docker run --rm --privileged --entrypoint haveged vladgh/gpg -F

5. 导出公钥

SH
docker run --rm -it -v /path/to/keys/store:/root/.gnupg -v $(pwd)/keys:/keys -e GPG_TTY=/dev/console vladgh/gpg --output /keys/my_key.pub --armor --export me@example.com

说明：公钥将导出至主机$(pwd)/keys/my_key.pub，me@example.com需替换为密钥关联***

6. 导出私钥（妥善保管）

SH
docker run --rm -it -v /path/to/keys/store:/root/.gnupg -v $(pwd)/keys:/keys -e GPG_TTY=/dev/console vladgh/gpg --output /keys/my_rsa_key --armor --export-secret-key me@example.com

说明：私钥将导出至主机$(pwd)/keys/my_rsa_key，请确保文件安全存储，避免泄露