olbat/gpg

GnuPG Docker镜像文档

镜像概述

本镜像包含GNU Privacy Guard (GnuPG)工具链，是GNU项目对OpenPGP标准的开源实现，兼容PGP协议。可用于安全通信、数据加密/解密、文件签名/验证及密钥管理等密码学操作，适用于容器化环境下的加密任务。

核心功能与特性

• 完整工具链：包含gpg命令行工具及相关组件
• 加密能力：支持对称加密、非对称加密（RSA、ECC等算法）
• 身份验证：提供文件签名与验证功能，确保数据完整性与来源可信
• 密钥管理：支持密钥生成、导入、导出、吊销及信任管理
• 标准兼容：遵循OpenPGP标准(RFC 4880)，兼容主流PGP工具

适用场景

• CI/CD流程中自动化文件签名与验证
• 容器环境下的安全数据传输与存储
• 批量加密/解密任务自动化
• 隔离环境中的密钥管理操作

使用方法

基础使用

启动交互式终端

bash
docker run --rm -it olbat/gnupg gpg --version

生成新密钥对

bash
docker run --rm -it -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --gen-key

说明：-v $(pwd)/gnupg-data:/root/.gnupg 挂载本地目录存储密钥，避免容器重启后密钥丢失

文件加密与解密

加密文件

bash
# 向指定公钥加密文件（接收者邮箱为user@example.com）
docker run --rm -v $(pwd):/data -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --recipient user@example.com --encrypt /data/sensitive.txt

解密文件

bash
docker run --rm -v $(pwd):/data -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --decrypt /data/sensitive.txt.gpg -o /data/sensitive.txt

密钥管理

列出密钥

bash
docker run --rm -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --list-keys

导入公钥

bash
docker run --rm -v $(pwd):/data -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --import /data/public.key

导出公钥

bash
docker run --rm -v $(pwd):/data -v $(pwd)/gnupg-data:/root/.gnupg olbat/gnupg gpg --export -a user@example.com > public.key

docker-compose示例

yaml
version: '3'
services:
  gnupg:
    image: olbat/gnupg
    volumes:
      - ./gnupg-data:/root/.gnupg  # 持久化存储密钥
      - ./data:/data               # 挂载工作目录
    command: gpg --list-keys       # 启动命令（可替换为具体操作）

配置说明

数据持久化

密钥默认存储于容器内/root/.gnupg目录，建议通过-v参数挂载本地目录实现持久化，避免容器销毁后密钥丢失。

权限注意

挂载本地目录时需确保容器内用户（默认root）对挂载目录有读写权限，可通过chmod调整本地目录权限或使用-u参数指定用户。

高级配置

可通过挂载自定义gpg.conf文件至/root/.gnupg/gpg.conf调整默认行为，如设置默认加密算法、密钥服务器等。