0xOX0X
Cybersecurity

Cloudflare Tunnel vs Ngrok: 502 Fix and Security Guide

Quick Answer

Fix a Cloudflare Tunnel 502 by first confirming that cloudflared can reach the local listener using the same protocol, port, and Host header defined in the ingress rule. Use `noTLSVerify: true` only for development or self-signed origins; the preferred production fix is a trusted origin certificate whose name matches `originServerName`.

By Elena RostovaUpdated 2026-11-226 min read
Isometric illustration of a secure network tunnel connecting local infrastructure to a cloud edge.

Cloudflare Tunnel 502 Bad Gateway: What the Error Means

Technical terminal showing Cloudflare Tunnel 502 error logs and configuration fix.

A Cloudflare Tunnel 502 usually means that cloudflared accepted the edge request but could not establish or complete a connection to the configured origin service. Treat it as an origin-path problem first: confirm the local listener, then confirm that the configured HTTP or HTTPS protocol works, and only then investigate certificate validation and Host-header behavior.

The checks below are ordered from the most common cause to the less common configuration causes. Run them on the same host or container where cloudflared runs.

Log / Error MessageWhat It MeansNext Check
connect: connection refusedNothing is listening on the configured address and port, or the service is bound to a different interface.Run `ss -ltnpgrep :8080 and compare the listener with the ingress service` value.
dial tcp [::1]:8080 followed by a refusallocalhost resolved to IPv6 while the application listens only on IPv4.Test curl -v http://127.0.0.1:8080/ and configure the explicit IPv4 address if that succeeds.
malformed HTTP response or an immediate resetThe origin protocol does not match the ingress URL, such as sending HTTP to an HTTPS listener.Test the exact protocol with curl -v http://127.0.0.1:8080/ or curl -vk https://127.0.0.1:8443/.
x509: certificate signed by unknown authority or a name mismatchcloudflared cannot validate the origin certificate or its presented name.Inspect the certificate with openssl s_client -connect 127.0.0.1:8443 -servername app.internal.example.
context deadline exceededThe TCP connection or origin response stalled; the origin may be overloaded, blocked, or unhealthy.Check application logs, connection saturation, upstream dependencies, and local firewall rules before changing originRequest.connectTimeout.

Cloudflare Tunnel 502: Ranked Listener and Protocol Checks

Start with the listener. For an HTTP origin configured on port 8080, run:

ss -ltnp | grep :8080

Expected output includes a LISTEN entry on 127.0.0.1:8080, 0.0.0.0:8080, or the service container address. No output means the application is stopped, bound to another port, or running in a separate network namespace. Fix the application binding or point the ingress rule at the reachable address.

Next, make the request that cloudflared is expected to make:

curl -v http://127.0.0.1:8080/

A successful HTTP status, including an application-level 401 or 404, proves that the listener and HTTP protocol are reachable. A connection refusal confirms a listener issue. If the service uses HTTPS, test curl -vk https://127.0.0.1:8443/ only as a diagnostic. The -k flag shows whether the service responds despite an untrusted development certificate; it is not a production solution.

A deadline error is not automatically a reason to increase a timeout. First identify slow handlers, exhausted workers, blocked database calls, or an origin firewall silently dropping packets. Increase originRequest.connectTimeout only when the normal, measured connection establishment time legitimately exceeds the configured value and the origin remains healthy.

Cloudflare Tunnel 502: Certificate and Host-Header Checks

After local connectivity works, test the hostname expected by the application:

curl -v -H 'Host: app.internal.example' http://127.0.0.1:8080/

If the ordinary local request succeeds but this request fails, the virtual-host or application host allowlist is rejecting the request. Correct the origin virtual-host configuration or set httpHostHeader to the hostname the origin expects.

For HTTPS origins, the certificate subject or SAN must match originServerName, and the issuer must be trusted by the host running cloudflared. Install a certificate from a trusted internal or public CA and configure the matching server name. noTLSVerify: true is limited to development or self-signed-origin cases where certificate verification cannot yet be established; it removes an important origin-authentication control.

Cloudflare Tunnel: Complete Valid Ingress Configuration

Use one configuration file so the protocol, timeout, TLS name, and Host header remain consistent. Replace the marked values with your tunnel and origin values.

yaml
tunnel: 00000000-0000-0000-0000-000000000000 # Replace with your Tunnel UUID
credentials-file: /etc/cloudflared/00000000-0000-0000-0000-000000000000.json # Replace with your credentials path

ingress:
  - hostname: app.example.com # Replace with your public hostname
    service: https://127.0.0.1:8443 # Replace with the reachable local origin URL
    originRequest:
      connectTimeout: 30s
      originServerName: app.internal.example # Must match the origin certificate name
      httpHostHeader: app.internal.example # Must match the origin virtual host, if required
      noTLSVerify: false # Set true only for development or a self-signed origin
  - service: http_status:404

If noTLSVerify must temporarily be enabled, document the exception, restrict origin network access, and replace it with a valid certificate as soon as possible. Also protect the public application with application authentication and authorization; a tunnel does not replace origin access controls.

Cloudflare Tunnel and Ngrok: Security and Deployment Differences

Cloudflare Tunnel is commonly used to connect private services to Cloudflare-hosted public hostnames or Cloudflare Access policies. Ngrok is commonly used for developer-controlled endpoints, webhook testing, and programmatic tunnel creation. Either can expose an origin publicly, so select controls based on the hostname, traffic path, account configuration, and application risk.

ConsiderationCloudflare TunnelNgrok
Typical workflowLong-lived service connectivity and Cloudflare Zero Trust deploymentsDeveloper testing, webhooks, and programmatic ingress workflows
Agent modelcloudflared creates outbound connections from the origin networkngrok agent and supported SDK-based workflows create endpoints and tunnels
Access controlCloudflare Access and related policies can protect configured applicationsUse ngrok endpoint and traffic-policy capabilities available to the account and configuration
WAF and DDoS controlsAvailability and enforcement depend on proxied hostname setup, zone, product plan, and configured rules or policiesEvaluate ngrok protections and traffic controls for the selected endpoint and account; do not assume a particular WAF tier
Static or dedicated addressesUse the applicable Cloudflare hostname, network, and enterprise options for the deploymentConfirm reserved domains, static addresses, or dedicated-address options in current ngrok documentation and the account contract

Cloudflare does not automatically place every tunneled request behind a WAF rule. WAF coverage requires an appropriately proxied hostname and applicable Cloudflare products and configured rules. DDoS mitigations and Access policies likewise depend on the deployed hostname and policy configuration.

Cloudflare Tunnel and Ngrok: Pricing Evaluation Without Unverified Amounts

Do not choose either platform from a copied monthly price or an assumed free-user allowance. Cloudflare costs can be associated with Zero Trust seats, enabled Cloudflare products, hostname or zone configuration, and enterprise agreements. Ngrok costs depend on the selected plan, included limits, usage dimensions, reserved resources, and enterprise terms.

For a defensible comparison, price the actual deployment: number of people requiring identity-based access, number and type of public endpoints, expected traffic, required reserved domains or addresses, policy features, support requirements, and retention needs. Review the current official pricing page and the account checkout or sales quote before committing, because limits and packaging can change.

Cloudflare Tunnel and Ngrok: Practical Selection

Choose Cloudflare Tunnel when the service already uses Cloudflare-hosted DNS and the team needs a managed path to Cloudflare Access, gateway controls, or other configured Zero Trust policies. Validate the exact WAF, DDoS, and Access coverage for each hostname rather than assuming it is enabled by the tunnel alone. This approach can complement guidance in Essential Cybersecurity Architecture for Remote Teams.

Choose Ngrok when fast developer-created endpoints, webhook inspection, or SDK-oriented integration is the primary requirement. Many teams use a production Cloudflare Tunnel deployment and separate developer endpoints for testing. In either design, resolve 502 errors at the origin first: listener and protocol, then certificate and Host-header configuration, then application health and capacity.

Share this article

Frequently Asked Questions

How do I fix a 502 error if the local service is running on HTTPS?

You must either provide the agent with the CA certificate of the local service or set 'no-tls-verify: true' in your tunnel configuration. This prevents the agent from dropping the connection due to an untrusted local certificate.

Can Ngrok and Cloudflare Tunnel coexist on the same host?

Yes, they can run simultaneously as long as they are not trying to bind to the same local port for management. Since they both function as outbound proxies to their respective clouds, they do not interfere with each other's traffic.

Which provider is better for high-bandwidth video streaming?

Cloudflare Tunnel is generally better for high-bandwidth needs due to its integration with the Cloudflare global CDN, though you must ensure your usage complies with their Terms of Service regarding non-HTML content.

Free Weekly Dispatch

Get the Weekly SMB AI & SaaS Brief

Practical software benchmarks, prompt templates, and ROI breakdowns delivered every Tuesday. No fluff, unsubscribe anytime.