交互选择建议#

1. 密钥类型 11 → ECC（自定义）

默认输出内容可能如下：

1
Possible actions for this ECC key: Sign Certify Authenticate
2
Current allowed actions: Sign Certify
3

4
   (S) Toggle the sign capability
5
   (A) Toggle the authenticate capability
6
   (Q) Finished
7

8
Your selection?

当前开启的能力是签名和认证，输入 S 取消签名能力，输入 Q 完成自定义
GPG 要求主密钥至少具备 Certify 能力，因此最终主密钥能力为 [C]，这是 OpenPGP 的设计约束，无法生成完全“无能力”的主密钥

2. 椭圆曲线 1 → Ed25519（Curve25519 曲线族，用于签发/认证）
   在 gpg 的交互界面中，Curve 25519 同时用于 Ed25519（签名/认证）与 cv25519（加密），具体用途由所选密钥能力决定

3. 有效期

   • 建议：5y 或 10y
   • 主密钥不建议永久有效

4. 填写用户名与邮箱

5. 设置高强度密码

生成完成后查看：

1
gpg --list-secret-keys --keyid-format=LONG

示例输出结构：

1
sec   ed25519/AAAAAAAAAAAAAAAA 2025-01-01 [C]
2
uid   用户名 <email@example.com>

CAUTION

此时只有主密钥没有子密钥，主密钥仅具备身份认证（Certify）与子密钥管理能力，不要直接使用它进行日常操作

3.1 进入密钥编辑模式#

1
gpg --edit-key AAAAAAAAAAAAAAAA

3.2 添加签名子密钥#

1
gpg> addkey

选择：

• 类型：10 → ECC（仅用于签名）
• 曲线：1 → Ed25519
• 有效期：建议 1y 或 2y

完成后会看到：

1
ssb   ed25519/BBBBBBBBBBBBBBBB [S]

3.3 添加加密子密钥#

1
gpg> addkey

选择：

• 类型：12 → ECC（加密）
• 曲线：1 → Curve25519（cv25519）
• 有效期：建议 1y 或 2y

完成后会看到：

1
ssb   cv25519/CCCCCCCCCCCCCCCC [E]

3.4 保存退出#

1
gpg> save

4.1 导出公钥（对外发布/同步）#

1
gpg --armor --export AAAAAAAAAAAAAAAA > public.key

public.key 用于发布到团队成员、公钥服务器或同步到其他设备。

4.2 导出子密钥私钥（仅用于日常设备）#

1
gpg --armor --export-secret-subkeys AAAAAAAAAAAAAAAA > subkeys.key

此命令会导出所有子密钥私钥，但主密钥私钥会被替换为占位符（stub），因此导入此子密钥只能用于在日常设备使用签名/加密能力，无法执行 revkey、adduid 等需要主密钥的操作。

4.3 备份主密钥私钥 + 所有子密钥私钥（仅一次，离线保存）#

1
gpg --armor --export-secret-keys AAAAAAAAAAAAAAAA > master-full.key

将 master-full.key 进行离线备份（建议多份）：

• 存入加密 U 盘
• 离线保存（例如保险箱/异地）
• 如需纸质备份，可转换为 QR 打印保存
• 不再导入到日常设备

在完成 master-full.key 备份后，建议在隔离环境中（如临时虚拟机）执行以下操作，验证备份完整性：

1
gpg --import master-full.key
2
echo "test" | gpg --encrypt --recipient email@example.com > test.gpg
3
gpg --decrypt test.gpg  # 应能成功解密

4.4 在日常设备删除主密钥私钥，仅保留子密钥#

1
gpg --delete-secret-key AAAAAAAAAAAAAAAA

TIP

删除后，你的日常设备将只保留子密钥能力（用于签名/加密），主密钥私钥不再在线暴露
即使日常设备被入侵，攻击者也难以获得主密钥私钥，从而无法伪造你的长期身份
如需在新设备启用子密钥能力，导入子密钥私钥即可：

1
gpg --import subkeys.key

CAUTION

加密子密钥私钥一旦丢失将无法恢复

这里的丢失通常发生在密钥迁移、重装系统、清理密钥环或误删密钥时：例如仅备份公钥、备份主密钥私钥后生成子密钥但未备份、仅导出子密钥用于日常使用后却未保留完整离线备份，或在子密钥私钥已从本地密钥环中删除后才执行导出操作。上述操作均会导致备份中不包含加密子密钥私钥，进而无法解密历史数据。

在 OpenPGP / GnuPG 的密钥体系中，子密钥私钥是独立存在的密钥材料，并非由主密钥派生生成。主密钥仅用于身份认证及子密钥的签发与吊销，不具备恢复或替代子密钥私钥的能力

因此，是否能够恢复历史加密数据，不取决于是否单独保留了主密钥，而完全取决于备份中是否包含用于加密的子密钥私钥；一旦加密子密钥私钥在备份或迁移过程中丢失或未被备份，即使主密钥私钥仍然完整存在，所有使用该子密钥加密的数据也将永久无法解密。

在执行主密钥隔离、删除主密钥私钥或轮换子密钥之前，必须确认加密子密钥私钥已被完整备份，并至少保留一份包含主密钥及全部子密钥私钥的离线备份；建议在新设备或新环境中验证该备份能成功解密历史数据后，再进行密钥删除或吊销操作

5.1 加密文件#

使用接收方邮箱为 receiver@example.com的公钥对文件进行加密：

1
gpg --encrypt --recipient receiver@example.com file.txt

也可以使用接收方的公钥 ID 指定加密目标：

1
gpg --encrypt --recipient DDDDDDDDDDDDDDDD file.txt

加密完成后生成文件：

1
file.txt.gpg

5.2 解密文件#

解密他人使用你的公钥加密的文件：

1
gpg --decrypt file.txt.gpg > file.txt

TIP

GPG 会自动在本地密钥环中匹配对应的加密子密钥私钥
按提示输入密码，解密成功后，文件内容恢复为原始数据

6.1 签名文件#

1
# 生成一个包含原文件内容的二进制签名文件，内容不可直接阅读（file.txt.gpg）
2
gpg --sign file.txt
3

4
# 生成一个独立的签名文件（file.txt.sig），不修改原文件
5
gpg --detach-sign file.txt
6

7
# 生成一个可读文本文件，原文内容保持明文，并内嵌 ASCII 签名（file.txt.asc）
8
gpg --clearsign file.txt

6.2 验证签名#

1
# 验证二进制签名（不输出原始内容）
2
gpg --verify file.txt.gpg
3
# 解包签名文件获取源文件
4
gpg --decrypt file.txt.gpg > file.txt
5

6
# 验证分离签名
7
gpg --verify file.txt.sig file.txt
8

9
# 验证 clearsign 文件
10
gpg --verify file.txt.asc

NOTE

对于 gpg --sign 生成的签名封装文件，gpg --verify 仅用于校验签名，不会输出原始内容
如需恢复原文件，应使用 gpg --decrypt 进行解包

TIP

在实际使用中，签名与加密可以组合使用，例如在向他人发送文件时同时保证机密性与来源可信性：

1
gpg --sign --encrypt --recipient receiver@example.com file.txt

使用 gpg --decrypt 进行解包时，gpg 会自动尝试验证内嵌的签名，并在输出中提示签名是否有效

7.1 进入密钥编辑模式#

1
gpg --edit-key AAAAAAAAAAAAAAAA

7.2 选择子密钥并吊销#

选择子密钥编号，编号按生成顺序依次编号，输入 revkey 进行吊销

1
gpg> key 1
2
gpg> revkey

7.3 保存退出#

1
gpg> save

7.4 生成新子密钥#

生成方式与 **三、添加子密钥（核心步骤）**章节内容一致

8.1 进入密钥编辑模式#

1
gpg --edit-key AAAAAAAAAAAAAAAA

8.2 添加新 UID#

按照提示输入姓名、邮箱等信息

1
gpg> adduid

8.3 吊销旧 UID#

选择 UID 编号，编号按生成顺序依次编号，输入 revuid 进行吊销，向公钥中写入 此 UID 已失效 的声明

1
gpg> uid 1
2
gpg> revuid

8.4 删除旧 UID#

选择 UID 编号，编号按生成顺序依次编号，输入 deluid 进行删除，仅在本地密钥中删除该 UID
该方式本身不构成对外可验证的身份吊销；如果该 UID 曾被分发或使用，应优先使用 revuid 吊销，再视需要使用 deluid 进行本地清理，否则该身份在对外发布的公钥中永远不会包含任何可验证的失效声明

1
gpg> uid 1
2
gpg> deluid

8.5 保存退出#

1
gpg> save

9.1 进入密钥编辑模式#

1
gpg --edit-key AAAAAAAAAAAAAAAA

9.2 修改密码#

该操作会修改整个密钥对象的保护密码，主密钥私钥与其所有子密钥私钥统一使用同一个密码
修改密码不会更换或重新生成任何密钥材料，也不会影响已生成的签名或加密数据

1
gpg> passwd

9.3 保存退出#

1
gpg> save