# eooce/python-ws

build vless / trojan /shadowsocks  proxies on python server,no need core

Repository: https://github.com/eooce/python-ws
Canonical: https://ross.abutalabs.com/products/python-ws
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: proxy, serverless, shadowsocks, trojan, vless, websocks
Last push: 2026-07-11T09:37:55+00:00

## Health v2 (maintenance only)
Score: 58/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 92, release rhythm 40, longevity 13
- inputs: {"age_days": 192, "days_push": 53, "days_rel": 189, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2788, forks 789 (observed 2026-08-28T04:07:21.970397+00:00)

## What it is
A lightweight Python implementation of VLESS, Trojan, and Shadowsocks proxy protocols designed to run on serverless/PaaS platforms without requiring a proxy kernel. It generates subscription links, supports optional Nezha monitoring integration, and can be fronted by Cloudflare Workers for CDN acceleration.

## Use cases
- deploy a vless proxy on a free python paas platform
- run trojan and shadowsocks nodes without installing xray core
- get a subscription link for proxy clients from a serverless deployment
- hide proxy traffic behind cloudflare cdn
- keep a serverless proxy node alive with auto-keepalive requests
- monitor proxy nodes with nezha agent

## When to choose
- you want multi-protocol (vless/trojan/shadowsocks) proxy nodes on python-based serverless platforms
- you need a kernel-free, lightweight proxy deployment with subscription output
- you want CDN fronting via cloudflare workers or snippets

## When to avoid
- you need a full-featured proxy client or kernel with advanced routing rules
- you require high-throughput production-grade proxy performance rather than a lightweight toy
- your platform does not support python websockets or long-lived connections

## Facets
- artifact type: application
- maturity: active
- function: proxy, networking, serverless, websocket, privacy
- domain: privacy, censorship-circumvention, networking, self-hosted
- platform: python, serverless, cross-platform
- tags: vless, trojan, shadowsocks, paas-deployment, cdn-fronting, nezha-monitoring, subscription-link, censorship-circumvention, web-server

## Member repositories
- eooce/python-ws (main) score 58

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:21.970397+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:15:31.487410+00:00, confidence not recorded.
  - readme: https://github.com/eooce/python-ws (fetched 2026-08-28T04:07:21.970397+00:00, sha fef31f92a7e4)
- Data as of 2026-08-30T08:39:29.467469+00:00.