INTEGRITY Dokumentace

Nastavení

Vytvořte Cloudflare Tunnel a publikujte svou první aplikaci za méně než 5 minut.

Předpoklady

Vytvořit tunel

Chcete-li vytvořit nový Cloudflare Tunnel:

  1. V Cloudflare dashboard ↗, přejděte na Sítě > Tunnels.

    Přejděte na Tunnels ↗
  2. Vyberte Create Tunnel.

  3. Zadejte název tunelu (například production-web nebo staging-api).

  4. Vyberte Create Tunnel.

  5. V části Nastavení prostředí, vyberte operační systém a architekturu svého serveru.

  6. Zkopírujte instalační příkazy uvedené v části Instalace a spuštění a spusťte je v terminálu na svém serveru.

  7. Jakmile se tunel připojí, vyberte Pokračovat.

Váš tunel by se měl zobrazit na Tunnels stránku s Healthy stav.

  1. Vytvořte token API s následujícími oprávněními:

    Typ Položka Oprávnění
    Účet Cloudflare Tunnel Úprava
    Zóna DNS Úprava
  2. Vytvořte tunel:

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

    Alespoň jeden z následujících oprávnění tokenu je povinné:
    • Cloudflare One Connectors Write
    • Cloudflare One Connector: cloudflared Write
    • Cloudflare Tunnel Write
    Vytvořte Cloudflare Tunnel
    curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cfd_tunnel" \
    	--request POST \
    	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    	--json '{
    		"name": "api-tunnel",
    		"config_src": "cloudflare"
    	}'
  3. Zkopírujte id a token hodnoty z odpovědi. Budete je potřebovat ke konfiguraci a spuštění tunelu.

Publikování aplikace

Chcete-li zpřístupnit aplikaci z internetu, přidejte do tunelu publikovanou trasu aplikace. Trasa tunelu mapuje veřejný hostitelský název na místní službu.

  1. V Cloudflare dashboard ↗, přejděte na Sítě > Tunnels a vyberte svůj tunel. Přejděte na Tunnels ↗

  2. V části Trasy, vyberte Přidat trasu.

  3. Vyberte Publikovaná aplikace.

  4. V části Hostname, zadejte subdoménu a z rozevírací nabídky vyberte doménu.

  5. Pro URL služby, zadejte místní adresu a port své aplikace.

    Pokud například váš webový server běží na stejném počítači jako cloudflared:

    • HTTP na portu 80: http://localhost:80
    • HTTPS na portu 443: https://localhost:443

    Pokud váš webový server běží na jiném počítači: http://192.0.2.1:80

  6. Vyberte Přidat trasu.

  1. Nakonfigurujte pravidla ingress svého tunelu:

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

    Alespoň jeden z následujících oprávnění tokenu je povinné:
    • Cloudflare One Connectors Write
    • Cloudflare One Connector: cloudflared Write
    • Cloudflare Tunnel Write
    Aktualizovat konfiguraci Tunnelu
    curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cfd_tunnel/$TUNNEL_ID/configurations" \
    	--request PUT \
    	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    	--json '{
    		"config": {
    				"ingress": [
    						{
    								"hostname": "app.example.com",
    								"service": "http://localhost:80",
    								"originRequest": {}
    						},
    						{
    								"service": "http_status:404"
    						}
    				]
    		}
    	}'

    Vaše vstupní pravidla musí na konci obsahovat catch-all pravidlo. V tomto příkladu cloudflared odpoví stavovým kódem 404, pokud požadavek neodpovídá žádnému hostitelskému názvu.

  2. Vytvořte záznam DNS pro svou aplikaci:

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

    Alespoň jeden z následujících oprávnění tokenu je povinné:
    • DNS Write
    Vytvoření DNS záznamu
    curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records" \
    	--request POST \
    	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    	--json '{
    		"type": "CNAME",
    		"proxied": true,
    		"name": "app.example.com",
    		"content": "<TUNNEL_ID>.cfargotunnel.com"
    	}'
  3. Nainstalujte cloudflared na svém serveru a spusťte tunel pomocí token získaný v Vytvořit tunel:

    1. Stáhněte a nainstalujte ↗ cloudflared.

    2. Spusťte následující příkaz:

      sudo cloudflared service install <TUNNEL_TOKEN>
    1. Stáhněte a nainstalujte cloudflared.

    2. Otevřete Command Prompt jako správce.

    3. Spusťte následující příkaz:

      cloudflared.exe service install <TUNNEL_TOKEN>
    1. Stáhněte a nainstalujte cloudflared.

    2. Otevřete okno terminálu a spusťte následující příkaz:

      sudo cloudflared service install <TUNNEL_TOKEN>
    1. Otevřete okno terminálu.

    2. Spusťte následující příkaz:

      docker run cloudflare/cloudflared:latest tunnel --no-autoupdate run --token <TUNNEL_TOKEN>

Vaše aplikace je nyní dostupná na hostname, který jste nastavili. Cloudflare provoz automaticky směruje přes svou síť jako proxy a využívá při tom cachování CDN, WAF a ochranu proti útokům DDoS.

Rychlé tunely (vývoj)

Pro lokální vývoj můžete okamžitě zpřístupnit localhost bez účtu Cloudflare:

cloudflared tunnel --url http://localhost:8080

Tím se vygeneruje náhodný trycloudflare.com subdoménu, která přesměrovává provoz na váš lokální server. Quick Tunnels slouží pouze k testování: mají limit 200 souběžných požadavků a nepodporují Server-Sent Events (SSE).

Pro produkční nasazení vytvořit tunel místo toho.

Další kroky