Skip to content

yourworstnightmare1/proxy-list

Repository files navigation

proxy-list

This is a complete list of lots of well known and probably working proxies. Check Releases for new versions of the list.

Slowing Down Development

Development of the Proxy List will be slowed down as this tool won't be needed as much by users over the next few months. I am doing this to prioritize releasing ReBlock v2.0 for both macOS and Windows. If you have an active pull request/issue/Google Forms submission, it will likely not be implemented for a while. View the ReBlock GitHub repo here.

Share the list

Feel free to download the list and share it around! The list is also available at https://yourworstnightmare1.github.io/proxy-list/.

Embed on another site

Use an iframe — paste the snippet from docs/embed.html (or open /embed.html on the hosted site). The list loads at ?embed=1 with a compact layout (no bottom ad, portrait orientation lock disabled). Example:

<iframe
  src="https://yourworstnightmare1.github.io/proxy-list/?embed=1"
  title="Proxy list"
  width="100%"
  height="720"
  style="border:0;border-radius:8px;max-width:100%;min-height:480px;"
  loading="lazy"
></iframe>

You cannot embed the full app as a single inline HTML string without an iframe: the UI loads data.json and scripts from the host. Cross-site iframes may block sign-in (third-party cookies). docs/_headers sets frame-ancestors * for Cloudflare Pages; GitHub Pages allows framing by default.

Deploy on Cloudflare Pages

This site is static HTML in docs/ — there is no compile step.

Recommended (Cloudflare Pages + Git): In the Pages project → SettingsBuild:

Setting Value
Build command (leave empty)
Build output directory docs
Root directory /

Do not use npx wrangler deploy as the build command. Pages uploads the output folder automatically; Wrangler only needs an API token and is meant for Workers CLI deploys.

Optional (Wrangler CLI): Commit includes wrangler.jsonc. Locally or in CI you can run npm run deploy:cloudflare only if CLOUDFLARE_API_TOKEN (and usually CLOUDFLARE_ACCOUNT_ID) are set — create a token at Cloudflare API tokens with AccountCloudflare Pages Edit and Workers Scripts Edit.

Versioning info

The default version format is v[version]r[revision].
[version] uses standard semantic versioning. [revision] is updated each time a new link or change is made.

Contributions

View CONTRIBUTING.md for details on how to request links. You can also submit links on Google Forms if the Contributing Guide confuses you here.
I am only accepting contributions to list.md, I am not taking contributions on any code present here.

How is CAPTCHA tested?

CAPTCHA is tested using the official Google ReCAPTCHA demo

When is the list updated?

Automation: The list is automatically checked every six hours. Each run re-checks HTTP for links in list.md and updates per-URL failure counts in link_status.json. After three consecutive failing runs for the same URL, that row is eligible to be removed from list.md. The scheduled workflow keeps purging off by default (LINK_CHECK_NO_PURGE, so flaky CI does not mass-delete working proxies); counters still advance. To have the bot purge dead links from the repo, set the Actions repository variable LINK_CHECK_NO_PURGE to false, or run python scripts/link_checker.py locally with that variable unset.
Manual: I will periodically update the list if I find new proxies, or if someone makes a pull request and I approve.