feat: initial commit

README.md

@@ -1,2 +1,48 @@
-# lpra
-Long polling remote access
+# LPRA — LongPolling Remote Access
+
+Лёгкий self-hosted сервис для доступа к Linux-машинам **без белого IP** (за NAT).
+Агент на клиенте сам исходяще подключается к серверу по HTTP long-polling; админ
+в веб-панели видит список машин и открывает по каждой **root-терминал в браузере**.
+
+```
+браузер ──WS──> [nginx :8445 TLS] ──> [Go server 127.0.0.1:8091] <──long-poll── агент (root, за NAT)
+                                          │
+                                        SQLite
+```
+
+## Компоненты
+- **Сервер** (`cmd/server`) — админ-панель + точка встречи для агентов. За nginx (TLS).
+- **Агент** (`cmd/agent`) — Linux-бинарь, systemd-сервис от root, PTY по запросу.
+- **install.sh** — интерактивный установщик, отдаётся сервером как статика.
+
+## Сборка
+```sh
+./build.sh
+```
+Получаются `bin/lpra-server` и `dist/agent-linux-{amd64,arm64}`.
+
+## Запуск сервера
+```sh
+./bin/lpra-server -addr 127.0.0.1:8091 -dist ./dist -db ./lpra.db
+```
+Поставьте перед ним nginx по `deploy/nginx.conf.example` (TLS, long-poll/WS).
+Локально без TLS можно добавить `-insecure-cookies`.
+
+Первый запуск: откройте `/setup` — мастер создаст администратора. Дальше `/settings`:
+адрес хоста (по умолчанию `https://REDACTED:8445`), enroll-секрет и готовая
+команда установки.
+
+## Установка агента на клиент
+Одной командой (под root):
+```sh
+curl -fsSL https://REDACTED:8445/install.sh | sudo HOST=https://REDACTED:8445 ENROLL_SECRET=<секрет> sh
+```
+Или интерактивно (спросит секрет, а если агент уже стоит — предложит удалить):
+```sh
+curl -fsSL https://REDACTED:8445/install.sh | sudo sh
+```
+
+## Безопасность
+- Пароли админов — bcrypt; сессии в HttpOnly/Secure/SameSite куках; CSRF на формах; rate-limit логина.
+- Агенты: общий enroll-секрет → индивидуальный токен (хранится хешем, сверка constant-time).
+- Открытие терминала пишется в таблицу `audit` (терминал даёт root-доступ).