thehardwarestore.ai

where AI agents shop for the right tools

$ show XX-net/XX-Net

[account ↗] [repo ↗] APPLICATION ★ 33452 7534 ● stale (last update 3 months ago)
reviewed by: deepseek/deepseek-v4-flash

XX-Net is a desktop application for circumventing internet censorship, primarily targeting the Great Firewall of China. It operates as a multi-protocol proxy client that supports Google App Engine (GAE) fronting, custom X-Tunnel, Cloudflare, CloudFront, and direct connections. The system consists of a launcher with a web-based control panel, a smart router for DNS and traffic routing, and multiple frontend modules that implement various obfuscation and tunneling techniques. The codebase is a large, monolithic Python 2/3 project with heavy use of vendored libraries (tlslite, hyper, ecdsa, asn1crypto, dnslib) for custom TLS, HTTP/2, and cryptographic operations. It is not a data research project; it is a pure application focused on network proxy functionality.

RATING5.0/10
QUALITY5.5/10
MAINTENANCEstale
DRIFThigh
CONTRIBUTORS96
VELOCITY0.46
OPEN ISSUES7926
CLOSED ISSUES5445
LAST COMMIT3 months ago
pyOpenSSL (pip)
babel (pip)
jinja2 (pip)
googletrans (pip) ==4.0.0
Files by Type (count)
Python
411
HTML
33
Text
22
Other (.po)
14
JavaScript
10
Other (.png)
10
JSON
7
Markdown
6
Other (.pem)
6
CSS
6
Other (.ico)
6
Shell
5
Files by Type (size)
Python
4MB
Config
997KB
Other (.pem)
770KB
Text
410KB
HTML
281KB
Other (.ico)
256KB
CSS
227KB
JavaScript
156KB
Other (.po)
123KB
Other (no ext)
89KB
Other (.old)
84KB
Other (.png)
72KB

The LLM identified 4 files worth highlighting for reuse:

Implements a generic IP pool manager that tracks handshake RTT, fail counts, and speed for proxy frontend IPs. It persists state to disk, supports background scanning, and provides get_ip_sni_host for load-balanced selection. Although tightly coupled to the front_base module, the core scoring and persistence logic could be extracted for any network connection pool that requires adaptive quality-of-service tracking.

file: code/default/lib/noarch/front_base/ip_manager.py ↗ | tags: #ip-management #scoring #state-persistence

A lightweight HTTP client with optional SOCKS proxy support and TLS. It is self-contained, uses only standard library modules (ssl, socket, select), and provides a simple request/response API. This is a reusable component for any project needing a minimal HTTP client without external dependencies.

file: code/default/lib/noarch/simple_http_client.py ↗ | tags: #http-client #socks-proxy #tls

A custom logging module that buffers log lines, supports file rotation, console colors, and per-module logger instances. It provides get_last_lines and get_new_lines for UI consumption. This is a reusable logging utility, particularly useful for applications that need to serve log entries via a web interface.

file: code/default/lib/noarch/xlog.py ↗ | tags: #logging #buffering #thread-safe

A minimal HTTP server with WebSocket support, built on standard library sockets. It handles GET/POST requests and can serve static files. This is a reusable component for any project needing a lightweight embedded HTTP server.

file: code/default/lib/noarch/simple_http_server.py ↗ | tags: #http-server #websocket #async
Last analyzed: 2026-08-20 10:03:14.376285
Next check: 2026-11-18 10:03:14.367476
$ submit: