【CloudFlare】API管理Plesk版Spectrum SSH转发

前段时间，通过Plesk接入CloudFlare的Plesk Plus with WAF套餐被打回了Free Website，套餐降级管理页面也就和免费版一样了，顺理成章的Spectrum的管理页面也就消失了……

虽然Plesk Plus套餐经历了降级，但是目前页面规则、WAF分析页、缓存分析页、自定义页面等功能支持还是高于Free的，额外的Pro功能比如Spectrum、WAF托管规则只是后台进行了屏蔽而过去的设置不受影响。

2023.01.14 CloudFlare彻底把Plesk Plus降级为Free套餐，SSL证书被删除、分析/页面规则等被回收，Spectrum权限也一并收回了。本文至此再无参考价值，仅供付费用户参考，我们不必再看下去了。

那么既然Spectrum权限依然被保留，我们就可以通过API来修改未在前端展示的内容。本文后续内容均根据官方文档摘取，在遇到问题时先与文中终端截图进行比对，若有不足之处请查阅官方资源：

API文档：https://api.cloudflare.com/#spectrum-applications-list-spectrum-applications

一、查询现有实例

curl -X GET "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps?page=1&per_page=20&direction=desc&order=protocol" \
     -H "X-Auth-Email: 【E-mail】" \
     -H "X-Auth-Key: 【Global API KEY】" \
     -H "Content-Type: application/json"

curl -X GET "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps?page=1&per_page=20&direction=desc&order=protocol" \

-H "X-Auth-Email: 【E-mail】" \

-H "X-Auth-Key: 【Global API KEY】" \

-H "Content-Type: application/json"

其中账户Global API KEY要从用户API Tokens页面获取（点击前往），Zone ID可以从域名主页Overview/概述页面往下翻在右下角API中找到。

将以上的信息填入自己对应的修改好后，一次性复制粘贴到Linux的SSH Terminal中回车执行，效果如下图。返回的信息主要是箭头所指的四项，依次是实例ID、协议（minecraft或ssh）、实例域名以及转发对象（IP及端口）。

二、增加实例

curl -X POST "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps" \
     -H "X-Auth-Email: 【E-mail】" \
     -H "X-Auth-Key: 【Global API KEY】" \
     -H "Content-Type: application/json" \
     --data '{"protocol":"【ssh或minecraft】","dns":{"type":"CNAME","name":"【Spectrum域名】"},"origin_direct":["tcp://1.14.5.14:22"]}'

curl -X POST "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps" \

-H "X-Auth-Email: 【E-mail】" \

-H "X-Auth-Key: 【Global API KEY】" \

-H "Content-Type: application/json" \

--data '{"protocol":"【ssh或minecraft】","dns":{"type":"CNAME","name":"【Spectrum域名】"},"origin_direct":["tcp://1.14.5.14:22"]}'

在增加实例的时候，protocol项可以填写ssh或minecraft，它们分别对应转发22和25565端口。Spectrum域名需要是该zone下当前没有的任意子域名，比如在博主120712.xyz区域下选择的是ssh.120712.xyz。Origin项需要与protocol对应，以IP:端口的形式填写如1.14.5.14:22或[240c::6666]:25565。

三、删除实例

curl -X DELETE "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps/【实例ID】" \
     -H "X-Auth-Email: 【E-mail】" \
     -H "X-Auth-Key: 【Global API KEY】" \
     -H "Content-Type: application/json"

curl -X DELETE "https://api.cloudflare.com/client/v4/zones/【ZoneID】/spectrum/apps/【实例ID】" \

-H "X-Auth-Email: 【E-mail】" \

-H "X-Auth-Key: 【Global API KEY】" \

-H "Content-Type: application/json"

删除实例时，则需要通过第一项中的查询方法获取实例ID，将实例ID填入链接中执行删除。

四、查询实例IP

dig @gina.ns.cloudflare.com ssh.120712.xyz【此处填写实例域名】

1	dig @gina.ns.cloudflare.com ssh.120712.xyz【此处填写实例域名】

大家的Plesk版本的都是Partner CNAME接入，我们直接用dig指令从CF的NS拉取一下解析记录就可以了，执行后的*.pacloudflare.com所指向的IP就是我们Spectrum实例的IP。当然这里也可以和CNAME一样通过*.cdn.cloudflare.net来获得，效果是一样的。

五、结语

虽然Pro版本仅仅给出了ssh和minecraft的选项，但是二者只是限定了特殊的端口，而转发的流量是所有的TCP流量（也就是如果你把ssh端口设置成25565也可以通过Spectrum进行转发）。此外，建议同时用到22和25565的情况下尽量使用同一个实例域名，减少资源开销；也要记得Spectrum是整个账户的月流量不能超过5GB，超出后会计费。

且用且珍惜吧，不知道还能用多久，Plesk Plus版本以及Partner何去何从一切还是未知数。

*原创文章，转载无需注明出处

匿名用户 @TA
2024-04-17 下午11:38

cf pro套餐如果续费一个月，过期之后，自定义网页会失效还是保持设置的状态？想自定义一下
1. Luminous @TA 
  2024-04-18 上午9:31
  
  @匿名用户按以前Plesk版降级的经验，自定义页面会保留下来，防火墙托管规则、超出3条的页面规则也会保留
lybwroay @TA
2023-01-19 下午9:56

证书删了没及时发是最绝的，
还顺手乱改一通设置……
1. Luminous @TA 
  2023-01-20 上午8:09
  
  @lybwroay 嗯，回退了回源方式、IPv6、缓存这些设置也直接导致站点不正常，所有的改动有人总结（点击前往）
匿名 @TA
2023-01-10 下午4:54

博主觉得阿里dns，dnspod，华为云dns
哪家解析速度快点
看了华为云免费的地域解析想投靠了
1. Luminous @TA 
  2023-01-10 下午5:27
  
  @匿名我自己在用阿里云的DNS，国内生效的速度还有基础功能用着还算舒服，DNSPod就没太多特别的感觉了。华为云的很不错，别家付费的企业套餐才能用的功能在他这免费，经过这两年基础功能也没问题了。