Обзор проекта

Astral — это self-hosted VPN-сервис на базе Xray с поддержкой VLESS, VMess, Trojan и Shadowsocks. Включает лендинг, личный кабинет пользователя и полноценную админ-панель.

Структура документации

Раздел	Описание
Tech Stack	Выбранный стек и обоснование
Системная архитектура	Системная архитектура
Структура фронтенда	Структура фронтенда
Структура бэкенда	Структура бэкенда на Go
Xray интеграция	Интеграция с Xray API

Ключевые концепции

• Панель — центральный сервис (Go). Управляет пользователями, подписками, нодами.
• Нода — сервер с запущенным Xray. Панель общается с нодами по gRPC.
• Синхронизация — изменения (новый пользователь, смена статуса) пушатся на ноды асинхронно.
• Subscription link — уникальная ссылка пользователя для импорта конфигов в клиенты (v2rayN, Hiddify и т.д.).

Быстрый старт (dev)

# Запуск всей инфраструктуры
docker compose up -d

# Фронт
cd frontend && bun install && bun dev

# Бэкенд
cd backend && go run ./cmd/server