git404hub

what is xray-cf-lite fr?

byjoey/xray-cf-lite — explained in plain English

Analysis updated 2026-05-18

58ShellAudience · ops devopsComplexity · 3/5Setup · moderate

tl;dr

xray-cf-lite is a single Bash script that deploys an xray-core proxy behind Cloudflare on low-resource or NAT servers, without needing a separate web control panel.

vibe map

mindmap
  root((xray cf lite))
    What it does
      xray proxy deployment
      Cloudflare integration
      Single script install
    Tech stack
      Shell
      xray-core
      Cloudflare
    Use cases
      Low resource servers
      NAT environments
      Subscription link generation
    Audience
      Server operators
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Deploy an xray proxy server with Cloudflare CDN in front of it, on a low-memory or NAT-restricted server.

VIBE 2

Manage vless, trojan, or vmess protocol settings and generate a subscription link from the command line.

VIBE 3

Update Cloudflare's Origin Rules after a NAT port mapping changes, without restarting the proxy.

VIBE 4

Cleanly uninstall the setup and restore Cloudflare's original DNS, SSL, and security settings.

what's the stack?

Shellxray-coreCloudflare

how it stacks up fr

byjoey/xray-cf-litegoatstarter/goat-fablezx41r/awesome-reverse-engineering-and-malware-analysis
Stars585759
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/53/51/5
Audienceops devopsdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a domain on Cloudflare and a Global API Key, plus root access on a Linux server.

No license information is stated in the README.

in plain english

xray-cf-lite is a single Bash script that sets up an xray-core proxy server behind Cloudflare, without needing a web-based control panel. It is aimed at small, low-resource servers, including machines with as little as 256MB of memory, NAT setups where a server sits behind port mapping, and lightweight environments like Alpine Linux containers. You run it by piping a single curl command straight into Bash, and it registers a short command called x so you can rerun it later, always pulling the latest version from GitHub rather than keeping a local copy. The script detects whether your system uses systemd or OpenRC as its service manager and sets up the xray process accordingly, including automatic restart if the process crashes. During setup it walks you through picking a domain already managed through Cloudflare, entering your Cloudflare account email and Global API Key, and choosing which proxy protocols to enable: vless, trojan, or vmess. It automatically configures Cloudflare DNS records, SSL settings, and Origin Rules so that traffic reaches the right port on your server, and it temporarily turns off Cloudflare protections like Bot Fight Mode during setup, restoring them afterward. The menu also supports checking your current subscription link, changing settings like the UUID or WebSocket path, viewing the current configuration, updating an external port after a NAT mapping changes without restarting the service, and fully uninstalling, which reverts all Cloudflare settings and removes local credential and state files. Cloudflare credentials are stored only on the server itself and are not sent anywhere else. Only one deployment is supported per server at a time, so reinstalling requires uninstalling first. The subscription link feature relies on a companion project by the same author.

prompts (copy fr)

prompt 1
Walk me through running the xray-cf-lite install command and what Cloudflare credentials it needs.
prompt 2
Explain how xray-cf-lite handles NAT port mapping during setup.
prompt 3
How do I change the UUID or WebSocket path after xray-cf-lite is already installed?
prompt 4
What does xray-cf-lite's uninstall option restore in my Cloudflare account?

Frequently asked questions

what is xray-cf-lite fr?

xray-cf-lite is a single Bash script that deploys an xray-core proxy behind Cloudflare on low-resource or NAT servers, without needing a separate web control panel.

What language is xray-cf-lite written in?

Mainly Shell. The stack also includes Shell, xray-core, Cloudflare.

What license does xray-cf-lite use?

No license information is stated in the README.

How hard is xray-cf-lite to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is xray-cf-lite for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.