Age：现代文件加密工具，替代GPG的简洁方案

1. 项目概述：为什么我们需要一个GPG的现代化替代品？

如果你和我一样，在过去的十年里处理过文件加密、签名或者密钥交换，那么GPG（GNU Privacy Guard）这个名字对你来说一定不陌生。它几乎是开源世界加密通信的代名词，从签署软件发布包到加密邮件，无处不在。然而，随着时间推移，GPG的复杂性也日益凸显：冗长的命令、繁琐的密钥管理（主密钥、子密钥、吊销证书）、以及那令人望而生畏的庞大手册页。很多时候，我们只是想简单地加密一个文件发给同事，或者备份一些敏感数据到云端，却不得不与这一整套复杂的体系搏斗。

这就是Age出现的背景。它不是一个试图取代GPG所有功能的庞然大物，而是精准地瞄准了“文件加密”这个单一场景，并力求做到极致简单、安全、现代化。我第一次接触Age时，就被它的设计哲学打动了：没有复杂的密钥环，没有证书链，命令直观到几乎不需要查文档。它用现代密码学原语（如X25519、ChaCha20-Poly1305）构建，默认就具备良好的安全性。这个项目，就是一次彻底的实战，带你从零开始，用Age替代GPG来完成日常的文件和目录加密任务，体验那种“一把钥匙开一把锁”的清爽感。

无论你是运维工程师需要加密配置文件，是开发者需要安全地传递凭证，还是普通用户想给私人文件加把锁，Age都提供了一个几乎无痛的上手方案。它尤其适合那些被GPG劝退，但又对安全有切实需求的用户。接下来，我会拆解Age的核心机制，并手把手带你完成从安装、密钥管理到批量加密目录的全流程，同时分享我趟过的一些坑和总结的最佳实践。

2. 核心设计哲学与方案选型解析

2.1 Age vs. GPG：理念的根本差异

要理解Age为什么是更好的选择，我们得先看看它和GPG在设计目标上的不同。GPG是一个“工具箱”，它试图解决OpenPGP标准定义的所有问题，包括加密、签名、密钥认证、信任网络（Web of Trust）。这种全能性带来了巨大的灵活性，但也导致了极高的复杂性。你的一个操作可能涉及多个密钥、多个子命令，并且需要深刻理解公钥基础设施（PKI）的概念。

Age则反其道而行之，它是一个“专用工具”。它的目标只有一个：使用公钥加密一个文件，或者使用密码加密一个文件。它不处理签名，不构建信任网络，不管理复杂的密钥生命周期。这种单一职责的设计带来了几个立竿见影的好处：

1. 接口极其简单：核心命令只有age和age-keygen，参数很少。
2. 密钥管理傻瓜化：Age的公钥就是一个简单的文本字符串（以age1...开头），私钥也是一个文本文件。没有“密钥环”，导入导出就是复制粘贴。
3. 默认安全：Age没有历史包袱，直接采用被密码学界广泛认可为安全且高效的算法，如用于密钥交换的X25519和用于加密的ChaCha20-Poly1305，避开了GPG中一些历史算法可能存在的隐患。
4. 无状态性：Age加密文件时，所有必要的元信息（比如用了哪个公钥）都直接编码在文件头里。解密时，你只需要提供对应的私钥或密码即可，不需要一个全局的、可能不同步的密钥数据库。

对于绝大多数“加密一个文件然后发送或存储”的场景，Age的简化模型不仅完全够用，而且大大降低了出错的可能性。你不需要思考“我用的是哪个子密钥”、“我的信任数据库是否更新了”这些问题。

2.2 核心密码学方案选型

Age主要支持两种加密模式，理解它们是你正确使用它的关键：

1. 非对称加密（公钥加密）这是Age最常用的模式，也是替代GPG公钥加密的核心。其流程基于现代的椭圆曲线密码学：

• 密钥生成：使用age-keygen生成一个密钥对。私钥自己保存，公钥可以分发给任何人。
• 加密：发送者用接收者的公钥加密文件。这个过程中，Age内部会生成一个随机的文件密钥，用公钥加密这个文件密钥，再用文件密钥加密实际文件内容。最终输出包含加密后的文件密钥和加密后的文件内容。
• 解密：只有拥有对应私钥的接收者才能解密文件密钥，进而解密文件。

这种模式非常适合一对多或协作场景，比如你有一个团队的公钥列表，可以一次性用所有人的公钥加密一份文件，团队里任何一个人都能用自己的私钥解密。

2. 对称加密（密码加密）当你不需要与他人分享，只是自己加密备份时，密码模式更简单。

• 加密/解密：都使用同一个密码。Age会使用scrypt密钥派生函数（KDF）从你的密码中派生出一个强密钥，再用它进行加密。
• 优势：无需管理密钥文件，一个强密码即可。适合临时性、单次性的加密需求。

注意：Age的设计中，密码模式是“第二选择”，公钥模式是首选。因为密码的安全性完全依赖于密码的强度，而人类并不擅长创建和记忆强密码。公钥模式的安全性则依赖于数学难题和私钥文件的安全保管。

3. 实战环境搭建与基础操作

3.1 安装Age：多种途径总有一款适合你

Age的安装非常 straightforward，几乎覆盖了所有主流平台。

macOS用户（推荐使用Homebrew）：

brew install age

这是最省心的方式，Homebrew会自动管理更新。

Linux用户：多数主流发行版的仓库都已收录Age。

• Ubuntu/Debian：sudo apt install age
• Fedora：sudo dnf install age
• Arch Linux：sudo pacman -S age

如果你的发行版仓库版本过旧，或者想使用最新版，可以直接从GitHub Releases页面下载预编译的二进制文件，放在你的PATH路径下（如/usr/local/bin）。

Windows用户：可以从GitHub Releases页面下载age-windows-amd64.zip，解压后得到age.exe和age-keygen.exe。你可以将它们放在一个目录（如C:\Tools\age），然后将该目录添加到系统的PATH环境变量中，之后就可以在PowerShell或CMD中直接使用了。

安装完成后，在终端输入age --version和age-keygen --version验证是否成功。

3.2 生成你的第一对Age密钥

与GPG的gpg --full-generate-key交互式流程不同，Age的密钥生成是一瞬间的事。

age-keygen -o key.txt

这条命令会生成一个新的Age密钥对，并将私钥保存到key.txt文件中。请务必妥善保管这个文件！它相当于你保险箱的唯一钥匙。

命令执行后，终端会输出类似以下内容：

# created: 2023-10-27T08:45:00+08:00 # public key: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zrj2kg5sfn9aqmcac8p AGE-SECRET-KEY-1QU9R0W0XQ09WQ09WQ09WQ09WQ09WQ09WQ09WQ09WQ09WQ09WQ0PHXW3

这里有两行关键信息：

1. # public key:后面那一长串以age1开头的字符串，就是你的公钥。你可以把它发给任何人，或者贴在GitHub个人主页上。
2. 以AGE-SECRET-KEY-1开头的整个文本块，就是你的私钥，它已经被保存到了key.txt中。

实操心得：

• -o key.txt参数指定输出文件。我强烈建议以.txt或.agekey为后缀，方便识别。文件名可以更有意义，比如alice-age-secret.key。
• 生成后，立即备份私钥文件到安全的离线介质（如加密的U盘），并从生成它的电脑上安全删除（使用shred或srm等安全删除工具，而非普通rm）。你的主工作机上只保留必要的私钥。
• 公钥可以随意分发，毫无风险。你可以把它添加到你的邮件签名、社交资料中。

3.3 第一个加密与解密操作

假设你有一个敏感文件secret-document.pdf，想要加密后发给公钥为age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zrj2kg5sfn9aqmcac8p的同事Bob。

加密操作：

age -r age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zrj2kg5sfn9aqmcac8p -o secret-document.pdf.age secret-document.pdf

• -r(recipient) 指定接收者的公钥。你可以指定多个-r来用多个公钥加密，这样所有接收者都能解密。
• -o指定输出的加密文件名称。
• 最后一个参数是输入文件。

现在你得到了secret-document.pdf.age，这个文件可以安全地通过邮件、网盘等任何渠道发送。没有私钥的人看到的只是乱码。

解密操作（Bob在自己的电脑上操作）：Bob需要有自己的私钥文件，假设他保存为bob-private.key。

age -d -i bob-private.key -o secret-document-decrypted.pdf secret-document.pdf.age

• -d代表解密模式。
• -i(identity) 指定用于解密的私钥文件。
• -o指定解密后的输出文件。

几秒钟后，原始的secret-document.pdf就被还原出来了。整个过程无需配置任何密钥环，无需信任数据库，简洁得令人愉悦。

使用密码加密（对称加密）：如果只是自己加密备份，可以使用密码。

# 加密 age -p -o backup.tar.gz.age backup.tar.gz # 执行后会提示你输入并确认密码 # 解密 age -d -o backup.tar.gz backup.tar.gz.age # 执行后会提示你输入密码

• -p标志告诉Age使用密码模式。这是一个交互式过程，密码不会显示在终端历史中。

4. 进阶实战：目录加密、脚本化与集成

4.1 如何加密整个目录

Age本身只处理文件，但结合Unix哲学下的工具链，加密目录易如反掌。最常用的方法是使用tar进行归档，然后通过管道传递给age加密。

加密目录my_project：

tar czf - my_project | age -r age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zrj2kg5sfn9aqmcac8p -o my_project.tar.gz.age

• tar czf - my_project：c创建归档，z用gzip压缩，f -表示输出到标准输出（stdout）。这样就把整个my_project目录打包压缩成一个数据流。
• |管道符将这个数据流传递给下一个命令。
• age ...命令从标准输入读取数据流，加密后写入my_project.tar.gz.age文件。

解密并解压目录：

age -d -i my-private.key my_project.tar.gz.age | tar xzf -

• age -d解密文件，输出到标准输出。
• | tar xzf -：x解压，z解压缩gzip，f -从标准输入读取。数据流被直接解压到当前目录。

实操心得：

• 这是一个经典的力量组合。你还可以在管道中加入其他工具，比如用gpg --symmetric替代age来对比体验，或者用openssl enc。
• 对于包含大量小文件的目录，先tar再加密，在存储和传输效率上远高于单独加密每个文件。
• 考虑使用更现代的压缩工具如zstd(tar cf - my_project | zstd | age ...)，以获得更好的压缩比和速度。

4.2 脚本化与自动化集成

Age的简洁性让它极易集成到自动化脚本中。

场景一：在CI/CD中加密部署密钥假设你在GitHub Actions中需要将一个加密的服务器密钥解密后使用。

1. 将你的Age公钥加密后的密钥文件（如server-key.age）存放在代码仓库中。
2. 在GitHub仓库的Settings -> Secrets and variables -> Actions中，添加一个名为AGE_PRIVATE_KEY的Secret，内容是你的Age私钥文本。
3. 在GitHub Actions工作流文件中：

jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Install Age run: sudo apt-get update && sudo apt-get install -y age - name: Decrypt server key run: | echo "${{ secrets.AGE_PRIVATE_KEY }}" > age-key.txt age -d -i age-key.txt -o server-key.pem server-key.age # 使用解密后的 server-key.pem ... shell: bash

重要安全提示：确保解密后的密钥文件只在必要步骤中使用，并在job结束后被清理。可以考虑在run命令中使用trap信号或在步骤最后主动rm -f敏感文件。

场景二：本地自动化备份脚本写一个简单的bash脚本，每天将重要目录加密后上传到云存储。

#!/bin/bash # backup.sh RECIPIENT_KEY="age1y..." # 你的公钥 BACKUP_SRC="$HOME/important_data" BACKUP_FILE="/tmp/backup-$(date +%Y%m%d).tar.gz.age" # 创建加密备份 tar czf - "$BACKUP_SRC" | age -r "$RECIPIENT_KEY" -o "$BACKUP_FILE" # 这里可以加上上传到S3、rsync等命令 # aws s3 cp "$BACKUP_FILE" s3://my-backup-bucket/ echo "Backup created: $BACKUP_FILE" # 清理临时文件（可选） # rm -f "$BACKUP_FILE"

4.3 与现有GPG工作流的桥接

你可能无法立刻让所有协作者都切换到Age。一个过渡方案是使用rage（Rust实现的Age），它包含一个rage-gpg工具，可以将Age密钥转换为GPG使用的Curve25519密钥格式，让你在GPG中使用Age的密钥进行加密。但这属于进阶用法，且涉及GPG配置，初期可以暂不采用。更简单的办法是并行运行：对于内部新项目，强制使用Age；与外部仍使用GPG的伙伴通信时，暂时保留GPG。随着时间的推移，逐步将GPG的使用范围缩小。

5. 密钥管理、安全实践与常见问题

5.1 密钥管理最佳实践

Age的密钥管理简单，但不意味着可以随意对待。

1. 私钥存储：

   • 主存储：使用密码管理器（如Bitwarden、1Password）存储私钥文本。这些管理器提供端到端加密和便捷的同步。
   • 离线备份：将私钥打印成二维码（使用qrencode工具）或直接记录在纸上，存放在保险箱等物理安全的地方。这可以防止数字存储全面失效。
   • 工作机存储：如果需要在特定机器上频繁使用，可以将私钥文件放在~/.config/age目录下，并确保该目录权限为700，文件权限为600。

2. 公钥分发：

   • 将公钥放入你的GitHub/GitLab个人简介页。
   • 放在团队内部Wiki或共享密码管理器的特定条目中。
   • 可以创建一个recipients.txt文件，里面每行放一个团队成员的公钥。加密时使用age -R recipients.txt file.txt即可一次性用所有公钥加密，非常方便团队共享文件。

3. 密钥轮换：虽然Age没有内置的密钥过期机制，但良好的安全习惯是定期（如每年）生成新的密钥对。将旧公钥标记为已弃用，在新文件加密中使用新公钥。旧私钥仍需安全存档，用于解密历史文件。

5.2 常见问题与排查技巧实录

即使工具简单，实践中还是会遇到一些问题。以下是我总结的常见“坑”：

问题1：解密时提示 “no identity matched”

• 现象：age -d -i my.key encrypted.file.age报错。
• 原因：你提供的私钥my.key并不是加密这个文件时使用的公钥所对应的私钥。
• 排查：
  1. 检查你是否用了正确的私钥文件。一个人可以有多个Age密钥对。
  2. 检查加密文件是否用了多个公钥。你可以尝试用age --decrypt --identity key1.key --identity key2.key ...指定多个私钥文件，Age会逐个尝试。
  3. 如果文件是密码加密的，则必须使用age -d然后输入密码，不能使用-i参数。

问题2：加密大文件时内存占用高或速度慢

• 现象：加密一个数GB的文件时，进程内存飙升。
• 原因：默认情况下，age可能会尝试将整个文件读入内存。对于流式加密（如加密tar管道），这不是问题。但对于单个大文件，可能是。
• 解决：Age本身是流式加密的，处理大文件应该没问题。确保你使用的是最新版本。如果是从管道读取（如cat bigfile | age ...），速度通常很快。也可以尝试使用rage（Rust实现），它在处理某些边缘情况时可能性能更优。

问题3：如何查看一个.age文件是用哪个公钥加密的？

• 需求：有时你需要知道加密文件的接收者是谁，以便找到对应的私钥。
• 方法：Age加密文件的头部是明文格式的。使用文本编辑器或head -n 5 encrypted.file.age命令查看文件开头。你会看到类似-> age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zrj2kg5sfn9aqmcac8p的行，这就是接收者的公钥。如果有多行->，说明用了多个公钥加密。

问题4：在Windows PowerShell中，管道解密tar文件失败

• 现象：在PowerShell中执行age -d file.age | tar xzf -报错，提示tar格式错误。
• 原因：PowerShell的管道与Unix的管道在处理二进制数据流时可能存在编码差异。
• 解决：
  1. 分两步操作：先解密到临时文件，再解压。

  age -d -o temp.tar.gz file.age tar xzf temp.tar.gz Remove-Item temp.tar.gz

  2. 或者，使用WSL2（Windows Subsystem for Linux）来获得完整的Unix环境，这是最推荐的方式。

5.3 安全注意事项

1. 私钥即一切：你的Age私钥文件一旦泄露，所有用对应公钥加密的文件都可能被解密。保护私钥的重要性高于一切。
2. 密码强度：如果使用密码模式，务必使用高强度、唯一的密码。考虑使用密码管理器生成和存储。Age使用的scrypt KDF能抵抗暴力破解，但弱密码依然是最大的弱点。
3. 输出文件权限：解密后的文件会继承当前umask设置的权限。确保敏感文件不会意外被设置为全局可读（如chmod 600 decrypted_file）。
4. 元数据泄露：Age加密文件的内容，但不加密文件名。如果文件名本身是敏感的（如layoff-list-2023.csv.age），需要考虑在加密前对文件进行重命名，或者将其放入一个中性命名的归档文件中再加密。

从我个人的实战经验来看，Age成功地将其设计目标——“一个简单、现代、安全的文件加密工具”——落到了实处。它没有试图解决所有问题，而是在它选择的赛道上做到了近乎完美。对于从GPG复杂体系中解脱出来的用户，那种流畅和直接的体验是革命性的。将它集成到你的备份脚本、CI/CD流程、日常文件分享中，你会发现加密不再是一个需要鼓起勇气去翻阅手册的艰巨任务，而只是一个简单、可靠的日常操作。最后一个小技巧：把你的Age公钥和GPG公钥放在一起，在介绍自己时同时提供，慢慢引导你的圈子接受这个更优的工具。