# 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://localhost:8445`), enroll-секрет и готовая команда установки. ## Установка агента на клиент Одной командой (под root): ```sh curl -fsSL https://localhost:8445/install.sh | sudo HOST=https://localhost:8445 ENROLL_SECRET=<секрет> sh ``` Или интерактивно (спросит секрет, а если агент уже стоит — предложит удалить): ```sh curl -fsSL https://localhost:8445/install.sh | sudo sh ``` ## Безопасность - Пароли админов — bcrypt; сессии в HttpOnly/Secure/SameSite куках; CSRF на формах; rate-limit логина. - Агенты: общий enroll-секрет → индивидуальный токен (хранится хешем, сверка constant-time). - Открытие терминала пишется в таблицу `audit` (терминал даёт root-доступ). ## Скриншоты