explaingit

strongshuai/proxy-checker

Analysis updated 2026-05-18

49PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A web-based tool that fetches free proxy lists, tests them in parallel, and tags working proxies by which AI services they can reach.

Mindmap

mindmap
  root((Proxy Checker))
    Sources
      Public Proxy Lists
      Parallel Testing
    Test Modes
      General HTTPS
      OpenAI ChatGPT
      Grok
      Gemini
      Claude
    Storage
      Local Repository
      Public Plain-text URL
    Setup
      Python Server
      Plain HTML Frontend
      Password Protected

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 pull free proxy lists from public sources and test which ones still work.

USE CASE 2

Find proxies that can specifically reach OpenAI, Grok, Google Gemini, or Claude services.

USE CASE 3

Get a public plain-text URL listing currently working proxies, tagged by country and IP type.

USE CASE 4

Skip rechecking proxies you already tested unless you force a fresh check.

What is it built with?

PythonHTMLJavaScript

How does it compare?

strongshuai/proxy-checkerthaolst/tara-botdevelp10/rustinterviewquiestions
Stars494948
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/52/52/5
Audiencedevelopervibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 30min

Ships with a default password that the README advises changing before deploying publicly.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Proxy Checker is a web-based tool for testing lists of free proxy servers to find ones that actually work. A proxy is a middleman server that routes your internet traffic, and free proxies are often unreliable, so this tool automates the process of checking a large number of them quickly. The README is written in Chinese, but the tool is general-purpose and the interface is web-based. The tool fetches proxy lists from several public free-proxy sources automatically and then tests each one in parallel, up to 30 at a time by default. For each proxy it checks basic connectivity and identifies the exit IP address, country, and whether the IP appears to be a data-center or residential address. Beyond generic connectivity, there are five testing modes: a general HTTPS check, and four service-specific checks that verify whether the proxy can reach OpenAI and the ChatGPT API, Grok, Google Gemini, or Claude and the Anthropic API. This makes it useful for people who need proxies that can pass AI service restrictions. Working proxies get saved to a local storage area called a repository. The repository is tagged with metadata such as which AI services the proxy can reach, whether it bypasses Cloudflare, IP type, and country. The repository generates a stable public URL so other programs can pull the current list of working proxies in plain text. Each time the checker runs, previously checked proxies are skipped by default unless you force a recheck. The backend is a Python HTTP server. The frontend is a plain HTML page with a JavaScript file. No framework is required. Starting it takes three commands: clone the repo, install Python dependencies, and run the server. It runs on port 8888 by default and is protected by a password (the default is linux.do, which the README advises you to change before deploying). Configuration can be set through a local config file or environment variables. The README notes that proxy test results depend on where the checker is deployed: a proxy that works from one server may not work from yours, so the tool is most accurate when deployed on the same machine that will actually use the proxies.

Copy-paste prompts

Prompt 1
Help me install and run this proxy checker: clone the repo, install dependencies, and start the server on port 8888.
Prompt 2
Explain how the five testing modes work, including the service-specific checks for OpenAI, Grok, Gemini, and Claude.
Prompt 3
How do I change the default password and configure this tool through a local config file or environment variables?
Prompt 4
Walk me through how the repository tags working proxies with metadata like AI-service reachability and IP type.

Frequently asked questions

What is proxy-checker?

A web-based tool that fetches free proxy lists, tests them in parallel, and tags working proxies by which AI services they can reach.

What language is proxy-checker written in?

Mainly Python. The stack also includes Python, HTML, JavaScript.

What license does proxy-checker use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is proxy-checker to set up?

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

Who is proxy-checker for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.