whatisgithub

What is avaco-railway?

avacocloud/avaco-railway — explained in plain English

Analysis updated 2026-05-18

37JavaScriptAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

In one sentence

A dependency-free Node.js reverse proxy deployed on Railway that forwards XHTTP traffic from a public URL to a private Xray-core server, hiding its real address.

Mindmap

mindmap
  root((Avaco Railway Relay))
    What it does
      Reverse proxy
      Hide server address
    Tech stack
      Node.js
      Railway hosting
    Use cases
      XHTTP relay
      Xray core traffic
    Audience
      Ops and devops

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 build with it?

USE CASE 1

Deploy a public relay endpoint on Railway that forwards to a private Xray-core server

USE CASE 2

Hide a personal server's real address from outside observers behind a stable public URL

USE CASE 3

Connect proxy clients like v2rayN or Hiddify through the relay with optional secret-key authentication

USE CASE 4

Cap simultaneous connections and drop slow connections with configurable timeouts

What is it built with?

Node.jsRailway

How does it compare?

avacocloud/avaco-railwaymatem6/p2jb-y2jb-portingyuzc-001/ai-roundtable-room
Stars373737
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatehardeasy
Complexity3/55/52/5
Audienceops devopsresearcherpm founder

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Railway account and the Railway CLI, free tier credits limit monthly usage.

Copyleft license: you can use and modify the code, but any distributed derivative work must also be released under the same license and its source made available.

So what is it?

Avaco Railway Relay is a lightweight Node.js reverse proxy that runs on Railway, a cloud hosting platform, and forwards traffic from a public HTTPS address to a private server. The README is written in Persian (Farsi). It is designed specifically for the XHTTP protocol used by Xray-core, a networking tool popular in regions with internet censorship for maintaining access to blocked services. The relay sits between client applications such as v2rayN or Hiddify (proxy clients) and a personal server running Xray-core. A client connects to the Railway-hosted public URL, the relay authenticates the request using an optional secret key, and then forwards the traffic to the private backend server. This hides the actual server address from outside observers while providing a stable public endpoint. The project has zero external dependencies and uses only built-in Node.js features. It includes concurrency control to cap the number of simultaneous connections, configurable timeout handling to drop slow connections, and a debug endpoint that returns current configuration and live connection counts. Users can choose from four Railway geographic regions for the server location. Deployment uses the Railway CLI. After cloning the repository, users create a Railway project, set a handful of environment variables (the target server address, relay path, and an optional authentication key), and the service deploys automatically. Railway's free tier provides approximately $5 in monthly credits, which the README estimates covers around 500 hours of activity. The project is GPL-3.0 licensed and maintained by Avaco Cloud, which also has a Telegram channel linked in the README.

Copy-paste prompts

Prompt 1
Walk me through deploying this relay to Railway using the Railway CLI.
Prompt 2
Explain how the optional secret key authenticates client requests to the relay.
Prompt 3
Show me how to set the target server address and relay path as environment variables.
Prompt 4
How many hours of relay uptime does Railway's free tier credit cover?

Frequently asked questions

What is avaco-railway?

A dependency-free Node.js reverse proxy deployed on Railway that forwards XHTTP traffic from a public URL to a private Xray-core server, hiding its real address.

What language is avaco-railway written in?

Mainly JavaScript. The stack also includes Node.js, Railway.

What license does avaco-railway use?

Copyleft license: you can use and modify the code, but any distributed derivative work must also be released under the same license and its source made available.

How hard is avaco-railway to set up?

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

Who is avaco-railway for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.