gitwtfhub

wtf is pxy?

openlibrecommunity/pxy — explained in plain English

Analysis updated 2026-05-18

56GoAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A one click installer for six proxy and VPN style protocols, plus free domains, aimed at bypassing network restrictions.

Mindmap

mindmap
  root((pxy))
    What it does
      One click proxy installer
      Free domains included
      Bypass network restrictions
    Parts
      pxy DNS web service
      Wails desktop GUI installer
    Protocols
      VLESS Reality XHTTP
      Hysteria2
      AmneziaWG
      mieru and naive
    Tech stack
      Go
      Wails framework
      SSH library
    Gaps
      No detailed usage docs
      Domain mechanism unclear

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

Why would anyone build with this?

REASON 1

Set up a proxy server using one of six supported protocols through a desktop installer.

REASON 2

Use the bundled free domain feature instead of registering your own domain for the proxy.

REASON 3

Install a proxy remotely on a server over SSH using the graphical installer.

What's in the stack?

GoWailsSSH

How it stacks up

openlibrecommunity/pxymitchellh/go-libuclgazprash/2d-to-3d-voxelizer
Stars565655
LanguageGoGoGo
Last pushed2019-03-08
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

README is sparse, building requires installing Wails and Go, and usage steps beyond the build command are not documented.

WTFPL: an extremely permissive license that lets you do almost anything with the code, with almost no restrictions.

Wtf does this do

pxy describes itself as a one click installer for six different proxy protocols, plus free domain names to go with them. The README is short and mostly a quick reference rather than a full explanation, so much of how it actually works in practice is left undocumented. The project has two main parts. One is a command line program called pxy that acts as a DNS web service, tied to a specific domain the author runs. The other is main.go, a desktop application built with the Wails framework, which provides a graphical installer you run on your own computer. To build it, you install the Wails command line tool through Go, then run a Wails build command, with an optional flag for using a particular version of the WebKit rendering engine on Linux. The two dependencies named in the README are Wails itself, for the graphical interface, and a Go SSH library, which suggests the installer can set up a proxy server remotely over SSH rather than only on the local machine. The six protocols it supports are VLESS with Reality and XHTTP, Hysteria2, AmneziaWG, mieru, naive, and one called olcrtc, all of which are proxy or VPN style protocols commonly used to get around network restrictions and censorship. The README does not explain the setup steps for using the finished installer, what the free domains actually are or how they are provided, or how the DNS web service and the desktop installer are meant to work together. It is released under the WTFPL license, an extremely permissive license that places almost no restrictions on use. The author lists a Telegram handle, an email address, and a personal website for contact.

Yoink these prompts

Prompt 1
Explain what each of the six proxy protocols pxy supports is generally used for.
Prompt 2
Walk me through building pxy's desktop installer with Wails on my machine.
Prompt 3
Explain what the pxy command line DNS web service is likely doing based on the README.
Prompt 4
Summarize what is missing from this README that I would need to actually use pxy.

Frequently asked questions

wtf is pxy?

A one click installer for six proxy and VPN style protocols, plus free domains, aimed at bypassing network restrictions.

What language is pxy written in?

Mainly Go. The stack also includes Go, Wails, SSH.

What license does pxy use?

WTFPL: an extremely permissive license that lets you do almost anything with the code, with almost no restrictions.

How hard is pxy to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is pxy for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.