acme.sh 中 Gcore DNS API 的 $ 字符处理问题解析

问题背景

在使用 acme.sh 与 Gcore DNS API 进行证书签发时，用户遇到了一个特殊字符处理问题。具体表现为当 API 令牌中包含 $ 字符时，该字符会在执行过程中被意外移除，导致 API 认证失败。

问题现象

1. 用户在设置环境变量时，API 令牌中包含 $ 字符（如 123$abc）
2. 执行 acme.sh --issue 命令后，检查 account.conf 文件发现 $ 字符被移除
3. 手动编辑 account.conf 添加 $ 字符后，再次执行命令仍会被移除
4. 导致 Gcore DNS API 返回错误："invalid or expired permanent token"

技术分析

这个问题本质上是一个 shell 环境变量处理问题。$ 在 shell 环境中具有特殊含义，通常用于变量引用。当 acme.sh 处理配置文件时，可能会对包含 $ 的值进行不正确的转义处理。

解决方案演进

1. 初始尝试：

   • 用户尝试直接使用包含 $ 的令牌，失败
   • 手动编辑配置文件无效，因为会被命令执行覆盖

2. 转义尝试：

   • 使用 123\$abc 格式转义 $ 字符
   • 第一次执行成功，但后续执行仍会移除 $

3. Base64 编码尝试：

   • 将令牌进行 Base64 编码后使用
   • 解码后仍无法正常工作

4. 开发版本修复：

   • 项目维护者建议使用开发分支 (dev)
   • 通过 acme.sh --upgrade -b dev 升级后问题解决

最佳实践建议

对于包含特殊字符的 API 令牌：

1. 优先考虑使用最新版本的 acme.sh
2. 对于包含 $ 等特殊字符的值，可以尝试：
   • 使用单引号包裹值：'123$abc'
   • 使用转义字符：123\$abc
3. 如果问题持续，考虑使用开发分支
4. 在复杂的生产环境中，建议先在测试环境验证令牌处理

总结

这个案例展示了 shell 环境中特殊字符处理的重要性。acme.sh 作为一款自动化证书管理工具，需要正确处理各种特殊字符情况。用户遇到问题时，及时升级到最新版本或开发分支通常是有效的解决方案。同时，这也提醒开发者在处理用户输入时，需要特别注意特殊字符的转义和保留问题。