Files

T

founder b903a09fb1 Позиционирование как самостоятельного продукта и переход на AGPL-3.0-only

HY2XS больше не описывается как форк H UI. Из README, docs, сообщений
builder'а и post-install metadata убрана вся fork/H UI терминология.

Лицензия:
- LICENSE: MIT заменён на полный текст AGPL-3.0-only
- README: бейдж и раздел лицензии, подпись Flamy Studio
- orchestrator/package.json, apps/frontend/package.json: license
- package.sh: LICENSE кладётся в install package, license=AGPL-3.0-only
  в metadata
- verify.sh, acceptance.sh: проверки корневой AGPL и metadata

Документация:
- 04-admin-panel-h-ui-fork.md -> 04-admin-panel.md, переписан вокруг
  модели Hysteria2 = external runtime dependency,
  HY2XS admin = native HY2XS component
- docs 01, 02, 03, 08, 09, 11, 12, README: единая терминология HY2XS admin

post-install.env:
- блок HUI_* заменён на HY2XS_ADMIN_*, HUI_FORK_REF -> HY2XS_ADMIN_SOURCE

Внутренний legacy namespace (H_UI_* ключи SQLite, HUI_DATA/HUI_LOG,
API /hui, h_ui_db.sql) намеренно не тронут: он требует отдельной
миграции БД и выносится в отдельный этап.

2026-08-15 03:34:18 +05:00

6.0 KiB

Raw Blame History

Architecture baseline

Цель

Зафиксировать одну непротиворечивую схему без смешивания локальной сборки, серверной установки и внешнего access layer.

Два слоя системы

1. Builder layer

Запускается только локально, на отдельной машине разработчика / оператора.

Функции:

хранение исходников проекта
хранение и сопровождение исходного кода HY2XS admin
хранение исходников оркестратора на Bun + TypeScript
компиляция install-артефакта оркестратора
подготовка install package
упаковка unit-файлов, шаблонов конфигов и документации
контроль версии проекта как целого

Builder layer не разворачивается на сервере.

2. Runtime / target layer

Запускается только на чистом Debian 13.

Функции:

установка системных зависимостей
разворачивание файлов пакета
скачивание свежей Hysteria2 из официального upstream
создание server config
установка и запуск встроенного HY2XS admin
создание systemd unit-файлов
применение nftables baseline
создание post-install.env

Target layer не содержит сборщика и не выполняет target-side build.

Компоненты baseline

Серверный транспорт

Hysteria2
QUIC/UDP
один фиксированный UDP-порт
Salamander включён по умолчанию
IPv4-only
лимит по умолчанию: 50/50 Mbps на клиента

UI слой

HY2XS admin — штатный компонент проекта
поставляется внутри проекта
устанавливается локально из итогового пакета
не скачивается с upstream на сервере

Orchestrator слой

Bun + TypeScript
собирается локально builder layer'ом
попадает на target как готовый install-артефакт
не требует npm/pnpm/yarn/bun install на сервере

Server ops слой

systemd
nftables
post-install.env

Принципы

1. Ядро, UI и оркестратор ведут себя по-разному

Hysteria2: берём свежую upstream-версию при установке
HY2XS admin: разрабатываем внутри проекта и поставляем его сами
Оркестратор: пишем на Bun + TypeScript, но собираем локально, а не на target

2. Builder и target не смешиваются

Сборка — локально.
Установка — на сервере.
На сервере не должно быть логики «собери мне UI» или «собери мне TypeScript оркестратор».

3. Оркестратор install/reconfigure-only

Оркестратор умеет только:

установить
применить явную реконфигурацию из runtime env
разложить файлы
создать базовую конфигурацию
подготовить сервер к работе

Он не умеет:

обновлять уже установленную систему
откатывать версии
удалять установку
чинить неизвестные поломанные старые состояния

4. Access layer вынесен за рамки baseline

Telegram-бот, backend выдачи ключей, remote profile publishing, billing и похожие пользовательские контуры не входят в этот baseline.

Что входит в baseline

local builder
install package
vanilla Hysteria2 from upstream
bundled HY2XS admin
Bun/TypeScript install-only orchestrator
systemd + nftables
post-install env
install-only flow под чистый Debian 13

Что не входит в baseline

target-side builder
target-side git clone нашего UI
target-side bun install / transpile / compile
Telegram-бот
backend выдачи remote profiles
standalone update / rollback / uninstall subcommands

При этом в install/reconfigure допускается bounded rollback для failure-сценариев firewall/systemd/config/smoke.

Docker как основной способ поставки
multi-node deployment
сложный control plane

Финальный результат

Правильный baseline-результат выглядит так:

На локальной машине собирается install package.
В пакет уже встроены наш HY2XS admin и install-артефакт оркестратора.
Пакет переносится на чистый Debian 13.
На сервере запускается только install-only orchestration.
Сервер скачивает свежую Hysteria2 из official upstream.
Сервер разворачивает bundled UI из пакета.
Создаются systemd unit-файлы, firewall baseline и post-install.env.
Сервер готов как базовое рабочее окружение HY2XS.

Runtime policy

editable слой: /etc/hy2xs/hy2xs.env (0600)
snapshot слой: /etc/hysteria/post-install.env (0600)
изменения runtime применяются только через явный reconfigure --dry-run/--apply
IPv6 out of scope: все bind/listen только IPv4

6.0 KiB Raw Blame History Unescape Escape