explaingit

avacocloud/avaco-deno

19TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A lightweight reverse proxy on Deno Deploy that forwards traffic from a public address to a private Xray-core server using the XHTTP protocol, free to host, no dependencies, deploys with one command.

Mindmap

mindmap
  root((avaco-deno))
    What it does
      Forward traffic
      Verify auth key
      Strip IP headers
      Stream responses
    Tech stack
      TypeScript
      Deno Deploy
      Xray-core backend
      XHTTP protocol
    Use cases
      Private relay setup
      Load spreading
      Free tier hosting
    Audience
      Self-hosters
      Privacy users
      Network tinkerers
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Set up a free public relay that routes traffic to your private Xray-core tunneling server without exposing its real address.

USE CASE 2

Spread incoming requests across multiple backend servers by deploying several relay apps in parallel.

USE CASE 3

Run a lightweight reverse proxy at zero cost using Deno Deploy's free tier for up to 10,000 requests per month.

USE CASE 4

Connect client apps like v2rayN or Hiddify through an authenticated, header-stripped relay to a self-hosted server.

Tech stack

TypeScriptDenoDeno DeployXHTTPXray-core

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Deno CLI install and a Deno Deploy account. Deploy with one CLI command and set ~4 environment variables. README is in Persian but code examples are readable regardless.

GPL-3.0, you can use, modify, and share this freely, but if you distribute a modified version you must also release your changes as open source under the same license.

In plain English

Avaco Deno is a lightweight reverse proxy written in TypeScript that runs on Deno Deploy, a free serverless hosting platform. Its purpose is to forward traffic using the XHTTP protocol from a public-facing address to a private backend server, acting as a relay layer between a client application and a self-hosted Xray-core server (a tool commonly used for private network tunneling). The proxy is designed to work entirely within the free tier of Deno Deploy, which allows up to 10,000 requests per month. It has no external dependencies, just plain Deno standard APIs, which keeps the deployment simple and the binary small. You deploy it by cloning the repository and running a single Deno CLI command that creates an app on Deno Deploy and sets a handful of environment variables: the address of your backend server, the public path to expose, a secret key for request authentication, and limits for concurrent connections and timeouts. Once running, client applications such as v2rayN or Hiddify connect to the Deno Deploy address. The relay checks the request path, verifies the authentication key, strips identifying headers to avoid leaking the relay's IP address, and forwards the traffic to your private server. Responses stream back through the same connection in both directions. The repository includes instructions for deploying multiple relay apps in parallel, each pointing to a different backend server, which lets you spread load across several upstream servers or work around the monthly request cap by rotating between accounts. Deployment steps are provided for both Linux and Windows. The README is written primarily in Persian (Farsi), with the architecture diagrams and code examples readable without knowing the language. The project is licensed under GPL-3.0.

Copy-paste prompts

Prompt 1
I have the avaco-deno repo cloned. Walk me step by step through deploying it to Deno Deploy, including how to set the environment variables for my backend server address, public path, and secret auth key.
Prompt 2
Using the avaco-deno proxy, how do I configure v2rayN or Hiddify to connect through my Deno Deploy relay URL to my private Xray-core server?
Prompt 3
I want to deploy three avaco-deno relay apps in parallel pointing to different backend servers to stay within the free 10,000 requests/month cap. Show me how to set this up.
Prompt 4
Explain what the XHTTP protocol does in the context of avaco-deno, and how the proxy verifies requests and strips headers before forwarding traffic.
Prompt 5
I'm on Windows and want to deploy avaco-deno. Give me the exact Deno CLI commands I need to run, and list every environment variable I need to set and what each one controls.
Open on GitHub → Explain another repo

← avacocloud on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.