Porkbun

🌐 Porkbun DNS 自动化管理专家

通过 Porkbun API v3 自动化管理 DNS 记录与域名,支持 CLI 工具快速创建、更新、删除 A/CNAME/MX/TXT 等 12 种记录类型,适合 DevOps 和开发者高效运维域名解析。

收藏
6.8k
安装
1.7k
版本
0.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Porkbun DNS 管理工具综合评估

核心用法

该 skill 提供完整的 Porkbun DNS 自动化管理能力,基于官方 REST API v3 构建。核心交付物为 porkbun-dns.js CLI 工具,封装了域名列表查询、DNS 记录 CRUD 操作、批量更新等高频场景。支持 12 种标准 DNS 记录类型(A/AAAA/CNAME/ALIAS/TXT/MX/NS/SRV/TLSA/CAA/HTTPS/SSHFP),覆盖网站托管、邮件服务、动态 DNS、Wildcard 配置等典型用例。

配置流程简洁:生成 API Key → 写入 ~/.config/porkbun/config.json 或环境变量 → 在域名管理后台开启 API 访问权限 → 使用 CLI 执行操作。工具设计遵循 Unix 哲学,参数化调用支持脚本化集成,如动态 DNS 场景可结合 curl ifconfig.me 实现 IP 自动更新。

显著优点

1. 操作原子化:CLI 工具将复杂 API 调用简化为单行命令,降低 DNS 管理门槛
2. 多凭证支持:同时支持配置文件和环境变量,适配 CI/CD 流水线与本地开发双场景

3. 记录定位灵活:支持按 ID 精确编辑或按「类型+子域名」批量操作,兼顾精准性与效率

4. 生态完整性:内置动态 DNS、邮件服务器(Google Workspace)、Wildcard 等常见配置模板

5. TTL 合规校验:自动拦截低于 600 秒的非法 TTL 设置,避免 API 报错

潜在局限与风险

  • 厂商锁定:仅支持 Porkbun 平台,无法迁移至 Cloudflare/Route53 等其他 DNS 服务商
  • API 依赖:Porkbun 服务可用性直接影响 DNS 管理能力,无本地缓存或降级机制
  • 权限粒度粗:API Key 绑定账户级别,无法实现按域名的细粒度权限控制
  • 无变更预览edit-by 等批量操作直接生效,缺乏类似 Terraform plan 的变更预览
  • TTL 限制:最小 600 秒的 TTL 对需要秒级切换的场景(如故障转移)不够灵活

适合人群

  • 使用 Porkbun 作为域名注册商的开发者与运维人员
  • 需要自动化 DNS 配置的 DevOps 工程师(IaC 补充场景)
  • 搭建个人/小型项目基础设施的技术爱好者
  • 需要快速验证 DNS 变更的测试环境管理员

常规风险

1. 密钥泄露:API Key 存储于本地明文文件,需确保 ~/.config/porkbun/ 目录权限为 600
2. 误操作覆盖edit-by 按类型匹配可能意外修改多条记录,生产环境建议先 get 确认

3. DNS 传播延迟:即使 API 调用成功,全球递归 DNS 缓存刷新仍需 TTL 时间

4. API 速率限制:官方未明确标注限流阈值,高频自动化脚本需自行实现退避逻辑

Porkbun 内容

references文件夹
scripts文件夹
手动下载zip · 10.5 kB
dns-record-types.mdtext/markdown
请选择文件