INTEGRITY Dokumentace

Začínáme

Spectrum je dostupné u všech placených plánů. Pro a Business podporují pouze vybrané protokoly, zatímco Enterprise podporuje veškerý provoz založený na TCP a UDP. Viz Možnosti konfigurace s dalšími podrobnostmi o konfiguraci.

Chcete-li vytvořit aplikaci Spectrum, můžete použít IP adresu, záznam CNAME nebo load balancer. Bez ohledu na zvolenou metodu můžete aplikaci vytvořit v dashboardu nebo prostřednictvím API.

Některá pole v tělech požadavků a odpovědí aplikace Spectrum vyžadují plán Enterprise. Podrobnosti najdete v Nastavení podle plánu pro další podrobnosti.

Vytvoření aplikace Spectrum pomocí IP adresy

Chcete-li vytvořit aplikaci Spectrum pomocí IP adresy, Cloudflare vaší aplikaci obvykle přiřadí libovolnou IP adresu ze svého fondu IP adres. Pokud chcete použít vlastní IP adresy, můžete použít BYOIP nebo můžete také použít Static IP. V těchto posledních dvou případech musíte aplikaci Spectrum vytvořit přes API, protože tyto funkce nejsou dostupné přes dashboard. Při použití API je pole origin_direct jako vstup přijímá IP adresu.

Přidejte svou aplikaci prostřednictvím Dashboard

  1. V dashboardu Cloudflare přejděte na Spectrum stránce.

    Přejděte na Spectrum ↗
  2. Vyberte Vytvoření aplikace. Pokud používáte Spectrum poprvé, Vytvoření aplikace se zobrazí modální okno.

  3. Vyberte svůj Typ aplikace.

  4. V části Doména, zadejte doménu, která bude používat Spectrum.

  5. V části Edge Port, zadejte port, který má Cloudflare použít pro vaši aplikaci.

  6. V části Origin, zadejte IP adresu a port origin serveru vaší aplikace.

  7. Pokud vaše aplikace vyžaduje IP adresu klienta a podporuje Proxy Protocol ↗, zapněte Proxy Protocols. Proxy Protocol je metoda, kterou proxy jako Cloudflare posílá IP adresu klienta origin aplikaci.

  8. Vyberte Přidat.

Přidejte svou aplikaci prostřednictvím API

Níže je uveden příklad příkazu curl a odpovídající data odesílaná do API.

Příklad API:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
Vytvoření aplikace Spectrum pomocí názvu pro origin server
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/apps" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"protocol": "tcp/22",
		"dns": {
				"type": "CNAME",
				"name": "ssh.example.com"
		},
		"origin_direct": [
				"tcp://192.0.2.1:22"
		],
		"proxy_protocol": "off",
		"ip_firewall": true,
		"tls": "full",
		"edge_ips": {
				"type": "dynamic",
				"connectivity": "all"
		},
		"traffic_type": "direct",
		"argo_smart_routing": true
	}'

Ukázková data:

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": {
		"id": "ea95132c15732412d22c1476fa83f27a",
		"protocol": "tcp/22",
		"dns": {
			"type": "CNAME",
			"name": "ssh.example.com"
		},
		"origin_direct": ["tcp://192.0.2.1:22"],
		"proxy_protocol": "off",
		"ip_firewall": true,
		"tls": "full",
		"edge_ips": {
			"type": "dynamic",
			"connectivity": "all"
		},
		"traffic_type": "direct",
		"argo_smart_routing": true,
		"created_on": "2014-01-02T02:20:00Z",
		"modified_on": "2014-01-02T02:20:00Z"
	}
}

Vytvoření aplikace Spectrum pomocí záznamu CNAME

Chcete-li vytvořit aplikaci Spectrum pomocí záznamu CNAME, musíte vytvořit záznam CNAME ↗ ve vaší zóně hostované Cloudflare, který ukazuje na hostname vašeho origin serveru. To je nutné pro přeložení na hostname origin serveru. Více informací najdete v Vytváření DNS záznamů, kde najdete více informací. Pokud jako origin používáte CNAME, mějte na paměti, že Cloudflare musí být pro danou zónu autoritativní. Při použití API origin_dns pole přijímá jako vstup záznam CNAME.

Přidejte svou aplikaci prostřednictvím Dashboard

  1. V dashboardu Cloudflare přejděte na Spectrum stránce.

    Přejděte na Spectrum ↗
  2. Vyberte Vytvoření aplikace. Pokud používáte Spectrum poprvé, Vytvoření aplikace se zobrazí modální okno.

  3. Vyberte svůj Typ aplikace.

  4. V části Doména, zadejte doménu, která bude používat Spectrum.

  5. V části Edge Port, zadejte port, který má Cloudflare použít pro vaši aplikaci.

  6. V části Origin, zadejte svůj CNAME název záznamu.

  7. Vyberte Přidat.

Přidejte svou aplikaci prostřednictvím API

Níže je uveden příklad příkazu curl a odpovídající data odesílaná do API.

Příklad API:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
Vytvoření aplikace Spectrum pomocí názvu pro origin server
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/apps" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"dns": {
				"type": "CNAME",
				"name": "spectrum-cname.example.com"
		},
		"ip_firewall": false,
		"protocol": "tcp/22",
		"proxy_protocol": "off",
		"tls": "off",
		"origin_dns": {
				"name": "cname-to-origin.example.com",
				"ttl": 1200
		},
		"origin_port": 22
	}'

Ukázková data:

{
	"dns": {
		"type": "CNAME",
		"name": "spectrum-cname.example.com"
	},
	"ip_firewall": false,
	"protocol": "tcp/22",
	"proxy_protocol": "off",
	"tls": "off",
	"origin_dns": {
		"name": "cname-to-origin.example.com",
		"ttl": 1200
	},
	"origin_port": 22
}

Vytvoření aplikace Spectrum pomocí load balanceru

Chcete-li vytvořit aplikaci Spectrum pomocí load balanceru, musíte load balancer vygenerovat v dashboardu nebo prostřednictvím API. Podívejte se na dokumentace Load Balancing pro další podrobnosti.

Přidejte svou aplikaci prostřednictvím Dashboard

  1. V dashboardu Cloudflare přejděte na Spectrum stránce.

    Přejděte na Spectrum ↗
  2. Vyberte Vytvoření aplikace. Pokud používáte Spectrum poprvé, Vytvoření aplikace se zobrazí modální okno.

  3. Vyberte svůj Typ aplikace.

  4. V části Doména, zadejte doménu, která bude používat Spectrum.

  5. V části Edge Port, zadejte port, který má Cloudflare použít pro vaši aplikaci.

  6. V části Origin, vyberte Load Balancer.

  7. Vyberte load balancer, který chcete použít, z rozbalovací nabídky. Zakázané load balancery se nezobrazí na Load Balancer nabídce.

  8. Vyberte Přidat.

Přidejte svou aplikaci prostřednictvím API

Níže je uveden příklad příkazu curl a odpovídající data odesílaná do API.

Příklad API:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
Vytvoření aplikace Spectrum pomocí názvu pro origin server
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/apps" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"dns": {
				"type": "CNAME",
				"name": "spectrum-cname.example.com"
		},
		"ip_firewall": false,
		"protocol": "tcp/22",
		"proxy_protocol": "off",
		"tls": "off",
		"origin_dns": {
				"name": "cname-to-origin.example.com",
				"ttl": 1200
		},
		"origin_port": 22
	}'

Ukázková data:

{
  "dns": {
    "type": "CNAME",
    "name": "spectrum-cname.example.com"
  },
  "ip_firewall": false,
  "protocol": "tcp/22",
  "proxy_protocol": "off",
  "tls": "off",
  "origin_dns": {
    "name": "cname-to-origin.example.com",
    "ttl": 1200
  },
  "origin_port": 22
}

Vytvoření aplikace Spectrum pomocí origin serveru ve virtuální síti

Chcete-li proxovat provoz TCP nebo UDP na origin ve vaší privátní síti, připojte Cloudflare Tunnel virtuální síť k aplikaci Spectrum. Spectrum směruje provoz přes konektor (Cloudflare Tunnel nebo připojení Cloudflare WAN) přiřazený k dané virtuální síti. Jde o alternativu k dřívějšímu postupu, kdy se před privátní origin server umísťoval load balancer.

Originy virtuální sítě jsou podporovány pouze pro aplikace TCP a UDP. Origin musí být jedna privátní IP adresa směrovatelná v rámci zadané virtuální sítě. Rozsahy portů, originy podle názvu hostitele (origin_dns), a více adres v origin_direct nejsou podporovány. Proxy Protocol momentálně není podporováno, takže proxy_protocol musí být nastaven na off. Podrobnosti o chybách ověření najdete v Kódy chyb.

Úvod do virtuálních sítí najdete v Virtuální sítě.

Než začnete

Před vytvořením aplikace Spectrum nastavte virtuální síť a trasu pokrývající IP adresu vašeho originu:

Pokud jako konektor používáte Cloudflare WAN (dříve Magic WAN), přečtěte si Začínáme s Cloudflare WAN pro nastavení endpointů a tras tunelu.

Přidejte svou aplikaci prostřednictvím Dashboard

  1. V dashboardu Cloudflare přejděte na Spectrum stránce.

    Přejděte na Spectrum ↗
  2. Vyberte Vytvoření aplikace.

  3. V části Typ aplikace, vyberte TCP nebo UDP.

  4. V části Doména, zadejte doménu, která bude používat Spectrum.

  5. V části Edge Port, zadejte port, který má Cloudflare použít pro vaši aplikaci.

  6. V části Origin, vyberte Virtuální síť.

  7. V části Virtuální síť, vyberte virtuální síť, která obsahuje váš origin server.

  8. V části IP, zadejte privátní IP adresu vašeho origin serveru.

  9. V části Port, zadejte jeden port (rozsahy portů nejsou podporovány).

  10. Vyberte Přidat.

Přidejte svou aplikaci prostřednictvím API

Níže je uveden příklad příkazu curl a odpovídající data odesílaná do API.

Příklad API:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
Vytvoření aplikace Spectrum pomocí názvu pro origin server
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/apps" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"protocol": "tcp/22",
		"dns": {
				"type": "CNAME",
				"name": "ssh.example.com"
		},
		"origin_direct": [
				"tcp://10.0.0.5:22"
		],
		"virtual_network_id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415",
		"proxy_protocol": "off",
		"ip_firewall": true,
		"tls": "off",
		"edge_ips": {
				"type": "dynamic",
				"connectivity": "all"
		},
		"traffic_type": "direct"
	}'

Nastavte origin_direct na privátní IP adresu vašeho origin serveru a virtual_network_id na ID virtuální sítě, ve které je IP adresa směrovatelná. Seznam virtuálních sítí pro váš účet můžete zobrazit pomocí Seznam virtuálních sítí koncový bod.

Ukázková data:

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": {
		"id": "ea95132c15732412d22c1476fa83f27a",
		"protocol": "tcp/22",
		"dns": {
			"type": "CNAME",
			"name": "ssh.example.com"
		},
		"origin_direct": ["tcp://10.0.0.5:22"],
		"virtual_network_id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415",
		"proxy_protocol": "off",
		"ip_firewall": true,
		"tls": "off",
		"edge_ips": {
			"type": "dynamic",
			"connectivity": "all"
		},
		"traffic_type": "direct",
		"created_on": "2014-01-02T02:20:00Z",
		"modified_on": "2014-01-02T02:20:00Z"
	}
}

Zobrazit provoz

Nyní můžete směrovat provoz přes Cloudflare bez další konfigurace. Jakmile přes Cloudflare poteče provoz, uvidíte provoz za poslední minutu od Spectrum v dashboardu.

Pokud máte jakoukoli zpětnou vazbu, dejte nám vědět ↗.