Xray HA Installation

The following describes how to set up an Xray HA cluster with two or more nodes. For more information, see the System Architecture.

The following installation methods are supported.

• Helm on Kubernetes environment
• Helm on OpenShift environment
• Docker Compose
• Linux Archive / RPM / Debian

Prerequisites

1. Consistent Xray version — All nodes within the same Xray HA installation must be running the same Xray version.
2. DNS resolution — Each Xray node must be able to resolve the hostnames of all other nodes in the cluster.
3. Bidirectional network connectivity — All Xray nodes must have unrestricted network communication with each other (no firewalls or network policies blocking traffic between nodes).

Database

Xray HA requires an external PostgreSQL database. Install the database before proceeding to install the first node. There are several ways to set up PostgreSQL for redundancy, such as Load Balancing and Replication. For more information, see PostgreSQL.

RabbitMQ is automatically installed as part of the Xray installation.

Licensing

Xray HA is supported with an Enterprise X or Enterprise+ license.

Network

• All the Xray HA components (Xray cluster nodes, database server and RabbitMQ) must be within the same fast LAN.
• All the HA nodes must communicate with each other through dedicated TCP ports.