# RSPC: установка и управление

RSPC (ReveServerProx-Controling) — reverse-proxy с панелью управления. Занимает
порты 80/443 и маршрутизирует HTTP/HTTPS/TCP/UDP-трафик до приложений на сервере.

Требования: **Ubuntu 24.04 x86_64**, root-доступ, свободные порты 80 и 443,
домен для панели с A-записью на IP сервера.

## Первая установка

```bash
tar xzf rspc-0.1.0-linux-amd64.tar.gz
cd rspc-0.1.0
sudo ./scripts/install.sh
```

Скрипт спросит:

1. **Домен панели**, например `panel.example.com`.
2. **Внутренний порт панели** (по умолчанию 9440). Он слушается только на 127.0.0.1,
   наружу панель доступна через 443 на своём домене.
3. **E-mail для Let's Encrypt**.

После установки скрипт выведет адрес панели и **одноразовый setup-токен**
(действует 24 часа). Откройте `https://<домен>`, введите токен, создайте
учётную запись superadmin и привяжите приложение-аутентификатор. 2FA обязательна.
Сохраните резервные коды.

## Скрипты управления

После установки скрипты лежат в `/opt/rspc/scripts/`:

| Скрипт | Назначение |
|---|---|
| `start.sh` | запустить и дождаться готовности |
| `stop.sh` | остановить (весь трафик через RSPC прекратится) |
| `restart.sh` | перезапустить, например после правки `/etc/rspc/config.yaml` |
| `status.sh` | состояние сервиса, сертификаты, ошибки, последние логи |
| `logs.sh` | логи в реальном времени |
| `update.sh` | обновление (запускается **из нового архива**) |
| `uninstall.sh` | удаление; `--purge` удаляет и данные |
| `reset-setup-token.sh` | новый setup-токен, если первый вход ещё не выполнен |
| `reset-2fa.sh <логин>` | сброс 2FA при потере телефона и резервных кодов |

## Обновление

```bash
tar xzf rspc-0.2.0-linux-amd64.tar.gz
cd rspc-0.2.0
sudo ./scripts/update.sh
```

Перед обновлением делается резервная копия (бинарник, конфиг, БД) в
`/var/lib/rspc/backups/`. Если новая версия не запустится, будет выполнен
автоматический откат. Хранятся 5 последних копий.

## Где что лежит

| Путь | Что |
|---|---|
| `/opt/rspc/bin/rspc` | программа |
| `/etc/rspc/config.yaml` | конфигурация |
| `/var/lib/rspc/rspc.db` | база данных (учётные записи, маршруты, журнал) |
| `/var/lib/rspc/secret.key` | ключ шифрования секретов 2FA (**не терять**) |
| `/var/lib/rspc/certs/` | сертификаты Let's Encrypt |

Сервис `rspc` работает от системного пользователя `rspc` с одной привилегией:
открывать порты ниже 1024.

## Аварийный доступ к панели

Если домен панели недоступен (DNS, сертификат), откройте SSH-туннель:

```bash
ssh -L 9440:127.0.0.1:9440 user@server
```

Затем откройте в браузере `http://127.0.0.1:9440`.

## Фаервол

Если включён `ufw`, установщик сам откроет 80/tcp и 443/tcp. Внешние порты
TCP/UDP-маршрутов нужно открыть вручную:

```bash
sudo ufw allow 25565/tcp
```

Управление фаерволом из панели появится в одной из следующих версий.
