WebSockets
Cloudflare supports proxied WebSocket connections without additional configuration.
Availability
Free | Pro | Business | Enterprise | |
Availability | Yes | Yes | Yes | Yes |
Volume of concurrent connections | Low (hobby projects) | Medium (Small businesses) | High (important applications) | Custom (mission-critical applications) |
Background
WebSockets are open connections sustained between the client and the origin server. Inside a WebSockets connection, the client and the origin can pass data back and forth without having to reestablish sessions. This makes exchanging data within a WebSockets connection fast. WebSockets are often used for real-time applications such as live chat and gaming.
Enable WebSockets
To enable WebSockets connections to your origin server in the dashboard:
- Log in to your Cloudflare account and go to a specific domain.
- Go to Network.
- For WebSockets, switch the toggle to On.
PATCH
request with the value
parameter set to "on"
. Compatibility notes
Product | Compatible | Notes |
---|---|---|
SSL | Yes | |
WAF | Yes* | The initial HTTP 101 request is subject to WAF managed rules, custom rules, rate limiting rules, and other WAF features like any other WebSockets connection. However, once a connection has been established, the WAF does not perform any further inspections. |
Workers | Yes | You can also use Durable Objects as an endpoint for WebSocket sessions, giving you full control over messages sent to and from clients. |
What happens if my site exceeds the number of concurrent WebSockets connections that Cloudflare expects?
Immediately, nothing. Cloudflare will allow occasional spikes in usage beyond our guidelines and we will not apply unnecessary limits.
Repeated spikes or high continued usage will prompt a dialogue. Cloudflare will reach out to learn more about your application. We will not impose limit errors for any application without contacting the customer unless we suspect that abuse or an attack is involved.
Customers whose usage claims a disproportionate percentage of resources for their current plan level may be asked to upgrade to the plan level that matches their needs.
Technical note
When Cloudflare releases new code to its global network, we may restart servers, which terminates WebSockets connections.
Best practises
- Implement a keepalive.
- Review and then remove or extend timeout settings on the origin and/or on the client.
Troubleshooting
Investigating issues with Websocket can be facilitated with client tools like wscat. Being able to reproduce an issue on a single URL with a minimalistic tool helps narrowing down the issue.