katproxy

A sleek, minimal, high-performance proxy list stream & active TCP latency prober.

Features dark glassmorphism aesthetics, live SVG countdown timer, one-click copy suite (IP:Port, cURL, raw lists), multi-protocol filtering (HTTP, SOCKS4, SOCKS5), and live round-trip latency metrics.

⚡ Architecture

Backend (Android Tablet / Termux):
- Aggregates thousands of proxies from premier GitHub sources (monosans/proxy-list, TheSpeedX/PROXY-List, hookzof/socks5_list).
- Active background TCP socket connection tester measuring real round-trip latency (ms).
- REST API running on port 5050, tunneled via Cloudflare Tunnel as katproxy-api.oiupoyt.space.
Frontend (Cloudflare Pages):
- Fast, zero-dependency static web application located in public/.
- JetBrains Mono typography, smooth 60fps micro-animations, quick actions, responsive on desktop and mobile.

🚀 API Endpoints

Method	Endpoint	Description
`GET`	`/api/health`	Service health status and uptime
`GET`	`/api/stats`	Total proxies, verified alive count, protocol counts, avg ping
`GET`	`/api/proxies`	Paginated list with `protocol`, `alive`, `search`, `sort`, `country` filters
`POST`	`/api/refresh`	Trigger immediate upstream re-fetch and probe cycle
`GET`	`/api/raw`	Raw plaintext list (`ip:port` or `format=url`) for curl / bash pipelines

Examples

# Get 5 fastest SOCKS5 proxies
curl "https://katproxy-api.oiupoyt.space/api/proxies?protocol=socks5&alive=true&limit=5"

# Raw IP:PORT stream for CLI scripts
curl -s "https://katproxy-api.oiupoyt.space/api/raw?protocol=socks5&alive=true" | head -n 10

🛠 Cloudflare Pages Deployment (Frontend)

Connect this GitHub repository (oiupoyt/katproxy) to Cloudflare Pages.
Build Settings:
- Framework preset: None
- Build command: None (leave empty)
- Build output directory: public
Deploy! The frontend automatically connects to https://katproxy-api.oiupoyt.space.

📱 Tablet Backend Setup

# On the tablet (Termux)
cd ~
git clone https://github.com/oiupoyt/katproxy.git katproxy
cd katproxy/backend
npm install
node --max-old-space-size=256 server.js

2.2 KiB Raw Blame History