Skip to content

Xray config

XrayCDN tests IPs through your xray setup. Add a JSON template that matches the config you already use.

  1. Finish License activation.
  2. Have a working xray/VLESS (or compatible) JSON ready.
  1. On the main screen, click Xray configs in the top-right header.
  2. Select an existing template in the list, or click + New to start from the built-in example and edit it.

Xray configs - template example 1

  1. Copy your JSON into the JSON template editor (or edit the + New example).
  2. Set your real values for domain, UUID, WebSocket path, TLS settings, and any other fields - same as in your working config.
  3. Where the CDN edge address belongs, use the placeholder {{IP}} (not a fixed IP). During each Xray test or Speed test, the app replaces it with the CDN IP being tested.
  4. Keep the placeholder {{PORT}} where the template expects the local SOCKS inbound port. Do not type your own port number - the app assigns a free local port and replaces it when the test runs.
  5. Edit Name if you want a clearer label in the list.
  6. Click Save.

The template must be valid JSON and must contain both {{IP}} and {{PORT}} or the app will show an error.

Xray configs - template example 2

Turn Enabled on for templates you want to use in tests. Turn it off to keep a draft without using it.

Recommended: enable only one profile while you benchmark IPs, so every test uses the same proxy settings.

Multiple enabled profiles also work: for each IP in a Xray test or Speed test run, the app picks one enabled template at random. Different IPs in the same run may use different templates. Use this only if you intentionally want to rotate between several configs.

If every profile is disabled, xray and speed tests cannot start - enable at least one and Save.

“Template must contain …” (missing placeholders)

Section titled ““Template must contain …” (missing placeholders)”

Add both {{IP}} and {{PORT}} to the JSON (see the screenshots). Save again.

Check commas, quotes, and brackets. Paste through a JSON validator if needed.

Enable at least one profile (Enabled checkbox) and click Save.

Contact support through xraycdn.app.

Create a job and import IPs, then run Ping.