whatisgithub

What is proxysmith?

soroushyasini/proxysmith — explained in plain English

Analysis updated 2026-05-18

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

In one sentence

Linux shell scripts that test thousands of public proxies and build a ready-to-use fast-proxy config for Xray.

Mindmap

mindmap
  root((proxysmith))
    What it does
      Tests public proxies
      Builds Xray config
    Tech stack
      Shell
      Xray
      Linux
    Use cases
      Automated proxy testing
      Daily cron refresh
    Audience
      Linux users
      Privacy tools

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

Automatically test thousands of public proxy configs and keep only the fastest ones.

USE CASE 2

Generate a ready-to-use Xray config file without manually vetting proxies.

USE CASE 3

Package a trusted list of proxy addresses into deployable format with manualconfig.

USE CASE 4

Run the tool nightly via cron to keep an always-fresh proxy list.

What is it built with?

ShellXrayLinux

How does it compare?

soroushyasini/proxysmithrejectall/expertteam-codexsirfetch-d/codex-proxy
Stars343335
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audienceops devopsdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires root access on Linux and Xray plus xray-knife installed.

So what is it?

Proxysmith is a set of Linux shell scripts that automatically build a ready-to-use configuration file for Xray, a tool people use to route their internet traffic through proxy servers. The problem it solves is that public proxy lists contain thousands of entries, most of which are slow or broken at any given moment. Testing them by hand is not practical, so proxysmith does it for you. The main script runs a three-round elimination process. It starts by downloading roughly 6,000 proxy configs from a public subscription feed, then tests all of them in parallel (50 at a time by default) and drops any that respond too slowly or fail. The survivors go through a second round of testing to confirm the results were not flukes. The remaining configs go through a slower, single-threaded third round. The roughly 12 configs that pass all three rounds get assembled into a final configuration file that Xray can use directly. That file tells Xray to always pick the fastest available proxy at runtime. On first run, the script checks for the tools it needs (including Xray itself and a testing utility called xray-knife) and offers to install anything missing before proceeding. You confirm once and setup runs automatically. A second script, manualconfig, is for situations where you already have a list of proxy addresses you trust and just want them packaged into the same ready-to-deploy format without running the full testing pipeline. The scripts run on Linux and require root access to install dependencies and to deploy the finished configuration file to the Xray system service. The whole testing process takes roughly 20 to 30 minutes at default settings. A daily cron job is the intended usage pattern.

Copy-paste prompts

Prompt 1
Walk me through installing and running the main proxysmith script on a fresh Linux machine.
Prompt 2
Explain what the three testing rounds in proxysmith do and why each one exists.
Prompt 3
Show me how to set up a daily cron job to re-run proxysmith automatically.
Prompt 4
Help me use the manualconfig script to package my own list of trusted proxies.

Frequently asked questions

What is proxysmith?

Linux shell scripts that test thousands of public proxies and build a ready-to-use fast-proxy config for Xray.

What language is proxysmith written in?

Mainly Shell. The stack also includes Shell, Xray, Linux.

How hard is proxysmith to set up?

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

Who is proxysmith for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.