This guide explains “how to configure a WS TLS node” and why the same node may behave differently across networks, DNS settings, or browser environments. It’s for users who have a V2Ray/VLESS/VMess node using WS+TLS but aren’t sure which parameters to enter in Clash, v2rayN, or sing-box, or how to troubleshoot a failed connection.
1. WS TLS node parameters you need to understand
WS TLS typically means WebSocket transport encrypted with TLS, and is commonly used with protocols such as VLESS, VMess, and Trojan. Before importing a node, check whether its details include the following:
- Address: This may be a domain name or an IP address. When using TLS, a domain name is generally recommended.
- Port: 443 is common, but use the port specified in the node details.
- User ID or password: VLESS/VMess usually use a UUID; Trojan usually uses a password.
- Transport: Select ws, not tcp or grpc.
- TLS: Enable it and check whether you need to enter an SNI/Server Name.
- Path: For example, /ray or /ws. It must match the node details.
- Host: Some clients call this the camouflage domain or Headers Host. Enter the value specified in the node details.
If you’re using free nodes listed on this site, the easiest option is to copy the subscription link and import it. If configuring a node manually, pay particular attention to Path, Host, and SNI—these are the settings most likely to cause a connection to succeed while leaving you unable to access websites.
2. Configuring WS TLS in common clients
- Open your client. On Windows, you can use v2rayN or Clash Verge; on Android, v2rayNG or NekoBox; on iOS, use a client that supports sing-box or Clash configurations.
- Add a node and select the protocol that matches your node, such as VLESS, VMess, or Trojan.
- Enter the address, port, UUID/password, and other basic details.
- Select WebSocket/ws as the transport and enter the Path. If a Host is specified, enter it under request headers or WS Host.
- Select TLS under security settings. Enter the domain provided for the node as the SNI/Server Name. If no separate value is specified, this is usually the same as the domain in the address.
- Save the settings, set the node as your active proxy, enable the system proxy or select rule mode, then visit a test website.
Using a subscription link is even simpler: copy the subscription URL, add and update it under “Subscription Management” in your client, then select an available node. Subscriptions reduce the risk of manual entry errors, but connections may still be affected by your local network.
3. How IP, DNS, and browser settings affect the connection
WS TLS nodes rely on domain name resolution and the TLS handshake, so DNS is important. If DNS is poisoned or resolves to an unexpected IP, the client may report errors such as timeout, TLS handshake failed, or connection reset. Try changing the client’s DNS to a trusted public DNS server, or enabling its built-in DNS or remote DNS.
Your IP network environment can also affect the connection. The same node may perform differently on mobile data, home broadband, and company Wi-Fi. Some networks restrict ports other than 443 or interfere with long-lived connections. To troubleshoot, try switching networks—for example, compare Wi-Fi with a mobile hotspot.
The browser environment mainly affects whether the connection appears to be working. If the client is connected but your browser can’t open webpages, check whether the browser has its own proxy, DoH, proxy extensions, or cached settings enabled. Chrome and Edge usually follow the system proxy, but some extensions can override those settings. Try testing in an incognito window and disabling other proxy extensions.
4. Quick checklist for connection failures
- Check that the protocol, port, and UUID/password don’t contain any extra spaces.
- Make sure the WS Path starts with / and matches exactly, including capitalization.
- Check that TLS is enabled and the SNI matches the node requirements.
- Try switching to global mode to rule out issues with rule-based routing.
- Update the subscription to avoid using an expired node.
- Change the DNS server or network environment, then reconnect.
In summary, configuring WS TLS involves more than entering an address and port. Make sure the protocol, WS path, Host, and TLS/SNI settings all match. If the connection still fails, check DNS, the IP network, and browser proxy settings one by one to quickly pinpoint the problem.