Skip to main content
Version: 4.6.1-saas

Troubleshooting

This document provides common issues and solutions that may occur when using NetFUNNEL Cloudflare Agent.

Installation and Initialization​

Worker Deployment Failure​

Symptoms: Worker code deployment fails.

Solutions:

  • Verify that there are no syntax errors in the Worker code
  • Verify that the netfunnel-cloudflare-agent.js file is uploaded correctly
  • Check Workers permissions in the Cloudflare account

Environment Variable Configuration Not Applied​

Symptoms: Environment variables are set but the agent is not working.

Solutions:

  • Verify that environment variable names are correct (CLIENT_ID, etc.)
  • Verify that the Worker is deployed
  • Wait sufficient time (a few minutes) after Worker deployment

Operation Issues​

Queue Not Applied​

Symptoms: Trigger rules are set but the queue is not applied.

Solutions:

  • Verify that segment trigger rules are correctly set in the NetFUNNEL console
  • Verify that URLs match the trigger rules
  • Verify that Worker's domain and route settings are correct
  • Verify that the Worker is deployed

Not Redirecting to Waiting Room​

Symptoms: Waiting response is received but not redirected to waiting room.

Solutions:

  • Verify that Worker's route settings are correct (include /* at the end)
  • Check environment variable VWR_PAGE_DOMAIN configuration
  • Check Worker deployment status

Network Issues​

Worker Execution Failure​

Symptoms: Worker does not run or errors occur.

Solutions:

  • Verify that there are no errors in the Worker code
  • Verify that environment variable settings are correct
  • Check Cloudflare Workers service status

Configuration Issues​

Domain Configuration Issues​

Symptoms: Worker does not run when accessing via domain.

Solutions:

  • Verify that CNAME is correctly set in DNS settings
  • Verify that it is set to Proxy type (orange cloud icon)
  • Check Worker's domain and route settings
  • Wait for DNS propagation time (up to 24 hours)

Environment Variable Values Not Applied​

Symptoms: Environment variables are set but values are not reflected.

Solutions:

  • Check case sensitivity of environment variable names
  • Verify Worker deployment status
  • Clear cache or wait after Worker deployment