Gandi 域名注册商全功能集成,支持域名管理、DNS 记录增删改、邮件转发配置及 SSL 状态检查,提供快照备份与安全令牌分级机制。
说明:
## 核心功能
Gandi Skill 是一套完整的域名注册商 API 集成方案,支持通过命令行或自然语言对 Gandi 账户进行全方位管理。
**DNS 管理**:支持 A/AAAA/CNAME/MX/TXT/NS/SRV/CAA/PTR 等全类型记录的增删改操作,提供批量更新功能(`update-dns-bulk.js`),自动在执行前创建 DNS 快照以便回滚。快照系统(`create-snapshot.js`/`restore-snapshot.js`)为破坏性操作提供安全保障。
**邮件转发**:支持创建、更新、删除邮件转发规则,包括多目标转发和 catch-all 全局捕获配置。适用于团队分发列表、域名迁移期间的邮件过渡等场景。
**域名查询**:内置域名可用性检查(`check-domain.js`)和智能建议引擎(`suggest-domains.js`),支持 9 种 TLD 自动扩展及 5 类名称变体(连字符、缩写、前缀、后缀、数字),内置速率限制保护(默认 3 并发、200ms 延迟)。
**SSL 证书监控**:`check-ssl.js` 可批量检查所有域名的证书状态。
## 安全机制
采用 Personal Access Token(PAT)认证,强制存储于 `~/.config/gandi/api_token` 并设置 600 权限。支持读写令牌分级:建议日常使用只读令牌(Domain:read, LiveDNS:read, Email:read),仅在修改操作时启用写权限(LiveDNS:write, Email:write)。
**风险警示**:DNS 修改可导致网站/邮件服务中断;邮件转发配置存在邮件拦截风险;批量操作不可撤销(依赖快照恢复)。所有破坏性脚本(增删改类)均带确认提示,`–force` 参数可跳过。
## 局限与注意事项
– 当前 Phase 2 已完成 DNS 和邮件功能,**域名注册功能尚未实现**(Phase 3 规划中)
– 暂不支持多组织切换,单令牌单组织架构
– 依赖 Node.js ≥18,需预装 npm 依赖
– Gandi API 速率限制 1000 请求/分钟,工具内置保守限制
– 仅支持 Gandi LiveDNS 托管的域名
## 适用人群
适合已使用或计划使用 Gandi 作为域名注册商的技术用户、DevOps 工程师、独立开发者,以及需要自动化 DNS 管理和域名监控的小型团队。需具备基本的命令行操作能力和域名系统知识。
## 常规风险
1. **配置错误风险**:DNS 记录误操作可能导致服务中断,建议非生产环境测试
2. **令牌泄露风险**:PAT 文件需严格保护,禁止提交至版本控制
3. **邮件转发滥用**:catch-all 配置可能被垃圾邮件利用
4. **快照依赖**:快照仅保留特定时间点状态,非实时增量备份









