# aditya-shri/VPN

Personal VPN using Shadowsocks and v2ray

Repository: https://github.com/aditya-shri/VPN
Canonical: https://ross.abutalabs.com/products/aditya-shri-vpn
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: shadowsocks, v2ray, vpn, vpn-server, free-vpn, free
Last push: 2025-09-12T08:36:51+00:00

## Health v2 (maintenance only)
Score: 51/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 41, release rhythm 35, longevity 100
- inputs: {"age_days": 2084, "days_push": 355, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2075, forks 1406 (observed 2026-08-28T04:06:10.470133+00:00)

## What it is
A deployment template for running a personal VPN server based on Shadowsocks with the v2ray-plugin, deployable via Docker, Heroku, or Railway with one click. It serves QR code and ss:// configuration endpoints so clients can easily import the connection settings.

## Use cases
- set up a personal VPN server on Heroku or Railway
- deploy a Shadowsocks proxy with v2ray plugin via Docker
- circumvent internet censorship with a self-hosted proxy
- get a QR code to configure Shadowsocks clients
- run a free private VPN on a cloud platform
- tunnel traffic through TLS-disguised Shadowsocks

## When to choose
- you want a quick one-click personal VPN deployment on free-tier platforms
- you need a Shadowsocks server with v2ray-plugin obfuscation over TLS
- you prefer Docker-based deployment on your own server

## When to avoid
- you need a full-featured VPN with multiple protocols or user management
- you require WireGuard or OpenVPN-style kernel-level tunneling
- you need guaranteed uptime on platforms that ban proxy deployments

## Facets
- artifact type: infra-config
- maturity: active
- function: vpn, proxy, security, deployment, self-hosted
- domain: privacy, censorship-circumvention, networking, security, self-hosted
- platform: self-hosted, windows, cross-platform
- tags: shadowsocks, v2ray-plugin, heroku-deployment, railway-deployment, personal-vpn, proxy-server, one-click-deploy, docker, linux, android

## Member repositories
- aditya-shri/VPN (main) score 51

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:10.470133+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-30T02:56:16.157540+00:00, confidence not recorded.
  - readme: https://github.com/aditya-shri/VPN (fetched 2026-08-28T04:06:10.470133+00:00, sha 16dde12470df)
- Data as of 2026-08-30T08:39:29.467469+00:00.