honeok/xray repository overview

⁠Xray

Project X⁠ originates from XTLS protocol, providing a set of network tools such as Xray-core⁠ and REALITY⁠.

As the project's core, it functions as a high-performance superset of v2fly-core while retaining full backward compatibility.

⁠Prepare the host

If you need to install docker by yourself, follow the official⁠ installation guide.

⁠Pull the image

This pulls the latest release of Xray-core.

It can be found at Docker Hub⁠.

docker pull honeok/xray

⁠Start a container

First, create and edit config.json on your host. You must provide a valid Xray configuration manually.

Next, create docker-compose.yaml in the same directory:

tee docker-compose.yaml >/dev/null <<'EOF'
services:
  xray:
    image: honeok/xray
    container_name: xray
    restart: unless-stopped
    volumes:
      - $PWD/config.json:/etc/xray/config.json
    network_mode: host
EOF

Start the container:

docker compose up -d

For reference, check the Configuration⁠ for Xray-core.

Note: The port you configured must be opened in the firewall.