STEALTHNET-SOFTWARE

KO | EN

gitlite — search

#command-line #cross-platform #generative-ai #codex #redis #agents #tailwindcss #web #ruby #sql

STEALTHNET-SOFTWARE

(★ 9)

Self-hosted VPN service platform · Rust · PostgreSQL · Control panel, customer website and Telegram Mini App · RU/EN

File Explorer

ZIP Download

- - bug.yml
- - checks.yml
  - release.yml
- pull_request_template.md
- - build.rs
  - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
  - README.md
- - Cargo.toml
  - DESIGN.md
- - Cargo.toml
- - 001_init.sql
  - 002_partitions.sql
  - 003_fix_sum_types.sql
  - 004_payments.sql
  - 005_effective_status.sql
  - 006_sub_settings.sql
  - 007_app_icons.sql
  - 008_sub_headers.sql
  - 009_service_tokens.sql
  - 010_provider_settings.sql
  - 011_single_currency.sql
  - 012_node_system_info.sql
  - 013_infra_billing.sql
  - 014_provider_logo.sql
  - 015_ext_squad_requests.sql
  - 016_ext_squad_brand.sql
  - 017_access_reports.sql
  - 018_node_plugins.sql
  - 019_client_overview_note_source.sql
  - 020_inbound_protocol_params.sql
  - 021_node_engine_health.sql
  - 022_node_name_unique_live.sql
  - 023_node_restart_request.sql
  - 024_inbound_reality_params.sql
  - 025_client_overview_reset.sql
  - 026_bot_dialog_state.sql
  - 027_bot_promo_hold.sql
  - 028_host_unlinked.sql
  - 029_effective_status_revive.sql
  - 030_refund_net_ltv.sql
  - 031_external_optional_rate_limit.sql
  - 032_partner_wallets.sql
  - 033_currency_revenue.sql
  - 034_ticket_delivery.sql
  - 035_client_node_activity.sql
  - 036_client_messages.sql
  - 037_subscription_studio.sql
  - 038_host_squad_overrides.sql
  - 039_subscription_addons.sql
  - 040_team_notifications.sql
  - 041_customer_cabinet.sql
  - 042_cabinet_code_reveal.sql
  - 043_authentication_security.sql
  - 044_tariff_languages.sql
  - 045_profile_workflow.sql
  - 046_staff_broadcast_delivery.sql
  - 047_broadcast_photos.sql
  - 048_default_subscription_apps.sql
- backfill_024_reality.py
- seed.sql
- - test_cabinet_preflight.py
  - test_cabinet_recovery_api.py
  - test_caddy_routes.py
  - test_installer.py
  - test_installer_health.py
  - test_installer_terminal.py
  - test_node_installer.py
  - test_subscription_placement.py
- Caddyfile
- installer.py
- migrate.sh
- package-release.py
- pg-env.py
- push.sh
- update-source.sh
- - profile-form.test.cjs
  - test_release_version.py
- check-docs.py
- release_version.py
- - addons.md
  - backup-restore.md
  - branding.md
  - cabinet-installation.md
  - development.md
  - installation.md
  - node-installation.md
  - payment-gateways.md
  - profiles.md
  - README.md
  - releases.md
  - selfsteal.md
  - subscription-installation.md
  - team-notifications.md
  - troubleshooting.md
- - cabinet-en.png
  - cabinet-ru.png
  - cover-en.svg
  - cover-ru.svg
  - miniapp-en.png
  - miniapp-ru.png
  - panel-nodes-en.png
  - panel-nodes-ru.png
  - README.md
  - storefront-en.png
  - storefront-ru.png
- - addons.md
  - backup-restore.md
  - branding.md
  - cabinet-installation.md
  - development.md
  - installation.md
  - node-installation.md
  - payment-gateways.md
  - profiles.md
  - README.md
  - releases.md
  - selfsteal.md
  - subscription-installation.md
  - team-notifications.md
  - troubleshooting.md
- compatibility.md
- customer-cabinet.md
- installation-releases.md
- installation.md
- node-installation.md
- NODE.md
- payment-gateways.md
- README.md
- subscription-addons.md
- subscription-installation.md
- team-notifications.md
- - app.css
  - app.js
  - customer-en.js
  - customer-i18n.js
  - customer-ui.js
  - guided.css
  - index.html
- - cabinet.css
  - DESIGN.md
  - index.html
- - favicon.svg
  - starter.svg
  - stealthnet-dark.svg
  - stealthnet.svg
- api.js
- app.css
- cabinet-admin.css
- cabinet-installation-en.html
- cabinet-installation.html
- charts.js
- core.js
- countries.js
- help-en.js
- help.js
- i18n-extra.js
- i18n.js
- index.html
- infra-console.css
- infra-console.js
- install-cabinet.sh
- install-node.sh
- install-sub.sh
- miniapp-unavailable.html
- nodes-console.css
- nodes-console.js
- p-audit.js
- p-bot.js
- p-cabinet.js
- p-home.js
- p-infra.js
- p-nodes.js
- p-sales.js
- p-sub.js
- p-team.js
- p-tools.js
- p-users.js
- panel-release.css
- panel-release.js
- panel-ui.css
- presets.js
- profile-workshop.css
- profile-workshop.js
- selfsteal-ui.css
- selfsteal-ui.js
- subscription-installation-en.html
- subscription-installation.html
- subscription-studio.css
- subscription-studio.js
- theme.js
- update-cabinet.sh
- update-node.sh
- update-sub.sh
.dockerignore
.env.example
.gitignore
Cargo.lock
Cargo.toml
CONTRIBUTING.md
CONTRIBUTING.ru.md
DESIGN.md
docker-compose.yml
Dockerfile
Dockerfile.node
Dockerfile.sub
install.sh
LICENSE
LICENSE.md
Makefile
PRODUCT.md
README.md
README.ru.md
SECURITY.md
THIRD_PARTY_NOTICES.md
update.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![STEALTHNET](https://raw.githubusercontent.com/STEALTHNET-APP/STEALTHNET-SOFTWARE/main/docs/media/cover-en.svg)

**STEALTHNET** brings VPN infrastructure, subscriptions, sales and customer accounts into one platform. Built with Rust and PostgreSQL, with independent services and Russian/English interfaces.

**v0.2.4 · guided installation, short subscription links and a bilingual connection page.**

## One service, three interfaces

| Owner control panel | Customer website & Mini App | Infrastructure |
|---|---|---|
| Customers, plans, payments, support and alerts | Storefront, code sign-in, purchases, devices and traffic | Profiles, nodes, hosts, squads and subscriptions |
| Versions, diagnostics, installation and branding | RU/EN, light/dark themes, linked Telegram account | Xray agent, access control and bgp.tools information |

## Interface gallery

Click a screenshot to open it at full size.

<table>
<tr>
<td width="50%" valign="top"><h3>Owner control panel</h3><a href="docs/media/panel-nodes-en.png"><img src="docs/media/panel-nodes-en.png" width="640" alt="Owner control panel" /></a><p>Nodes, diagnostics and infrastructure</p></td>
<td width="50%" valign="top"><h3>Public website</h3><a href="docs/media/storefront-en.png"><img src="docs/media/storefront-en.png" width="640" alt="Public website" /></a><p>Service information and plans before sign-in</p></td>
</tr>
<tr>
<td width="50%" valign="top"><h3>Customer account · Desktop</h3><a href="docs/media/cabinet-en.png"><img src="docs/media/cabinet-en.png" width="640" alt="Desktop customer account" /></a><p>Subscription, purchases, devices and traffic</p></td>
<td width="50%" valign="top" align="center"><h3>Mini App · Telegram</h3><a href="docs/media/miniapp-en.png"><img src="docs/media/miniapp-en.png" width="160" alt="STEALTHNET Mini App" /></a><p>The same account and subscription inside Telegram</p></td>
</tr>
</table>

Actual interfaces in a test environment with demonstration data.

## Included

- **Sales:** plans/periods, promo codes and referrals; Platega, RollyPay, ParityPay v2, Stars, CryptoBot and manual payments.
- **Add-ons:** packages and prices per plan. Device slots last until the paid term ends; traffic lasts until reset or expiry.
- **Access:** internal squads grant inbounds; an external squad overrides subscription templates and settings.
- **Connection:** subscription page, app instructions and QR; Xray JSON, share-links, Clash/Mihomo/Stash and sing-box output.
- **Customer website:** public storefront, persistent access code, Telegram linking, purchases and support. The website installs separately and hosts Mini App.
- **Branding:** light/dark logos, favicon, colors, SEO, RU/EN content, FAQ and instructions configured in the admin panel.
- **Operations:** release installer, `make update`, pre-update backup, version checks, logs and team alerts.

## Installation

Supported targets: **Debian 12/13**, **Ubuntu 22.04/24.04/26.04 LTS**, **amd64/arm64**. Fresh installation and update were exercised on Debian 13, Ubuntu 24.04 and 26.04 amd64. ARM binaries are built; a separate ARM VM run is still pending.

Requirements, DNS, the setup wizard and HTTPS. Dedicated guides cover nodes, subscriptions and customer websites on shared or separate servers.

### Install from GitHub

SSH into a clean Debian/Ubuntu server **as root**, then run:

```bash
apt-get update
apt-get install -y git curl ca-certificates
git clone --branch v0.2.4 --depth 1 https://github.com/STEALTHNET-APP/STEALTHNET-SOFTWARE.git /root/stealthnet-installer
cd /root/stealthnet-installer
bash install.sh --version v0.2.4
```

The wizard asks where to host subscriptions, then explains the domain, service name, currency and owner fields. Choose the panel server or a separate machine; remote subscription setup is completed afterwards from the panel. It downloads the release for your server architecture, verifies SHA256, and installs PostgreSQL, system services and HTTPS. You do not need to compile Rust.

The repository is cloned into `/root/stealthnet-installer`; the running panel is installed in `/opt/stealthnet-software`. Use `make update` from that installation directory for subsequent panel updates.

On an installed panel:

```bash
cd /opt/stealthnet-software
make update
```

The updater downloads a published release, verifies SHA256 and creates a backup. Returning to previous binaries does not reverse database migrations.
<p>
  <a href="docs/en/backup-restore.md"><img src="docs/media/navigation/link-en-09.svg" width="231" height="58" alt="Updates &amp; backups" /></a>
</p>

## Task-based documentation

## Architecture

```mermaid
flowchart LR
  Admin[Administrator] --> API[Panel API]
  API --> DB[(PostgreSQL)]
  Bot[Telegram bot] --> DB
  Worker[Background jobs] --> DB
  Site[Website and Mini App] --> Gateway[Customer gateway]
  Gateway --> API
  Node[Node agent / Xray] --> API
  Sub[Subscription service] --> API
  Client[VPN client] --> Sub
  Client --> Node
```

A co-located subscription service can use the local database. Separate customer and subscription gateways in API mode do not need PostgreSQL access.

## Development and license

Project license: **AGPL-3.0-only**. Dependencies and fonts retain their own licenses.

## Community and project support

Optional donations support STEALTHNET development. **Network: TRON · TRC20.**

```text
THQA9Qnx87NcHAwYrcCTBGSi6BhY72LXEZ
```

STEALTHNET-SOFTWARE

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README