# Cloudflare 管理技能 **由 After Dark Systems, LLC 创建** ## 概述此技能通过 Cloudflare API v4 提供全面的 Cloudflare 基础设施管理功能。它可以完全控制域、DNS、安全性、性能和无服务器部署。 ## 身份验证 API 凭证存储在“~/cloudflare_global_key”中。该文件包含： * 用于传统身份验证的全局 API 密钥 * 用于现代身份验证的 API 令牌（不记名令牌） **推荐** ：使用 Bearer 令牌进行 API 调用： -H“授权：持有者<令牌>” 验证令牌有效性： ./scripts/cf-api.sh 验证令牌 ## 可用脚本所有脚本都位于“scripts/”目录中，并使用“~/cloudflare_global_key”中的凭据。 ### 核心 API 客户端 * **cf-api.sh** \- 具有身份验证处理功能的基础 API 客户端 ### 区域管理 * **zones.sh** \- 列出、获取、创建和管理区域 * **zone-settings.sh** \- 管理区域级别设置 ### DNS管理 * **dns.sh** \- 完整的 DNS 记录 CRUD 操作 * **dns-import.sh** \- 批量导入DNS记录 * **dns-export.sh** \- 导出 DNS 记录 ### 安全与防火墙 * **firewall.sh** \- 防火墙规则管理 * **waf.sh** \- Web 应用程序防火墙规则 * **rate-limiting.sh** \- 速率限制规则 * **ip-access.sh** \- IP 访问规则（阻止/允许） * **ssl.sh** \- SSL/TLS 配置 ### 性能和缓存 * **cache.sh** \- 缓存清除和设置 * **page-rules.sh** \- 页面规则管理 * **speed.sh** \- 速度优化（缩小、抛光等） ### 工作人员和页面 * **workers.sh** \- Cloudflare Workers 管理 * **pages.sh** \- Cloudflare Pages 项目 ### 分析和日志 * **analytics.sh** \- 流量和安全分析 * **logs.sh** \- 企业日志访问 ## 快速入门示例 ### 列出所有区域 ./scripts/zones.sh 列表 ### 获取区域详细信息 ./scripts/zones.sh 获取 # 或按域名 ./scripts/zones.sh 按名称获取 example.com ### 列出 DNS 记录 ./scripts/dns.sh 列表 # 按类型过滤 ./scripts/dns.sh list --type A ### 创建 DNS 记录 ./scripts/dns.sh 创建 \ --A型\ --名称子域\ --内容192.0.2.1 \ --ttl 3600 \ --代理真实 ### 更新 DNS 记录 ./scripts/dns.sh 更新 \ --内容192.0.2.2 \ --TTL 1800 ### 删除 DNS 记录 ./scripts/dns.sh 删除 ### 清除缓存 # 清除所有内容 ./scripts/cache.sh purge-all # 清除特定的 URL ./scripts/cache.sh purge-urls "https://example.com/page1" "https://example.com/page2" # 按缓存标签清除 ./scripts/cache.sh purge-tags tag1 tag2 ### SSL/TLS 设置 # 获取当前SSL模式 ./scripts/ssl.sh get-mode # 设置 SSL 模式（关闭、灵活、完整、严格） ./scripts/ssl.sh set-mode strict ### 防火墙规则 # 列出防火墙规则 ./scripts/firewall.sh 列表 # 屏蔽某个IP ./scripts/ip-access.sh block 192.0.2.100“可疑活动” # 允许IP ./scripts/ip-access.shallow 192.0.2.50“受信任的服务器” ### 工人 # 列出工人 ./scripts/workers.sh 列表 # 部署一个worker ./scripts/workers.sh 部署 <脚本名称> <脚本文件> # 删除一个worker ./scripts/workers.sh 删除 <脚本名称> ## 常见工作流程 ### 设置新域 1. 添加区域： ./scripts/zones.sh 创建 example.com 2. 获取区域ID： ZONE_ID=$(./scripts/zones.sh 按名称获取 example.com --id-only) 3. 添加所需的 DNS 记录： ./scripts/dns.sh 创建 $ZONE_ID --type A --name @ --content 192.0.2.1 --proxied true ./scripts/dns.sh create $ZONE_ID --type CNAME --name www --content example.com --proxied true ./scripts/dns.sh 创建 $ZONE_ID --type MX --name @ --content mail.example.com --priority 10 4.配置SSL： ./scripts/ssl.sh 设置模式 $ZONE_ID 严格 ### 从其他提供商迁移 DNS 1. 从源提供者导出当前记录 2. 导入到 Cloudflare： ./scripts/dns-import.sh 记录.txt ### 紧急情况：阻止攻击流量 # 屏蔽特定IP ./scripts/ip-access.sh block “攻击缓解” # 启用攻击模式 ./scripts/zone-settings.sh set security_level under_attack # 如果缓存了受损内容，则清除缓存 ./scripts/cache.sh purge-all ## API 参考请参阅“reference.md”以获取完整的 Cloudflare API v4 文档，包括： * 所有可用端点 * 请求/响应格式 * 错误代码及处理 * 速率限制信息 ## 模板 `templates/` 目录包含常见操作的 JSON 模板： * `dns-records.json` \- 常用 DNS 记录配置 * `firewall-rules.json` \- 防火墙规则模板 * `page-rules.json` \- 页面规则模板 * `worker-config.json` \- Worker 配置模板 ## 错误处理所有脚本都会返回适当的退出代码： * 0：成功 * 1：API错误（详细信息请检查stderr） * 2: 无效参数 * 3: 认证错误 * 4: 未找到资源错误响应包括 Cloudflare 错误代码和用于调试的消息。 ## 最佳实践 1. **尽可能使用代理记录**以实现 DDoS 防护 2. **使用严格的SSL模式**进行完整的端到端加密 3. **设置适当的 TTL** \- 动态内容较短，静态内容较长 4. **在执行之前以日志模式测试防火墙规则** 5. **使用 API 令牌** 所需的最低权限 6. **积极缓存**，但在内容更改时清除 7. **监控分析**异常流量模式 ## 支持有关此技能的问题，请联系 After Dark Systems, LLC。对于 Cloudflare API 文档：

云耀

包含技能