feat(linux): add remote client rollout for admin host

2026-04-27 17:29:17 +03:00
parent ced44c347c
commit 5105155323
4 changed files with 272 additions and 0 deletions
@@ -28,7 +28,28 @@
 - `socks5://127.0.0.1:1080` активен.
 - `sing-box` запущен и пропускает трафик.

+4. Подготовлен и развернут Linux-клиент ActivityWatch для `10.10.10.2`.
+- В репозиторий добавлен rollout:
+  - `scripts/install_aw_linux_client.sh`
+  - `docs/linux-client.md`
+- На `10.10.10.2` под пользователем `admin` установлен bundle `ActivityWatch 0.13.2` в:
+  - `~/.local/opt/activitywatch/v0.13.2/activitywatch`
+- Созданы:
+  - `~/.config/activitywatch/aw-client/aw-client.toml` с `10.10.10.13:5600`
+  - `~/.config/activitywatch/aw-qt/aw-qt.toml`
+  - `~/.local/bin/activitywatch-remote-aw`
+  - `~/.config/autostart/activitywatch-remote-aw.desktop`
+- Проверка показала:
+  - удаленный `AW server` с `10.10.10.2` достижим;
+  - `aw-qt --no-gui` стартует;
+  - bucket `aw-watcher-afk_pve-detmir` появился на сервере.
+- Текущий blocker:
+  - на `10.10.10.2` нет активной `X11/GUI` сессии;
+  - `aw-watcher-window` падает с `DISPLAY environment variable not set`;
+  - `aw-watcher-afk` падает на `failed to acquire X connection`.
+
 ## Зафиксированные выводы

 - На текущем этапе `10.10.10.2` является фактическим runtime-хостом для `AW server` и `pfSense poller`.
 - Документация должна исходить из host-based сценария как из подтвержденного рабочего контура, а CT/LXC-схему держать как отдельный вариант развертывания.
+- Для Linux-клиента на `10.10.10.2` установка завершена, но полноценные watcher-события начнутся только после реального графического логина пользователя.
@@ -0,0 +1,70 @@
+# Linux client deployment
+
+## Назначение
+
+Этот сценарий ставит `ActivityWatch` в user-space Linux-хоста и направляет watcher'ы на уже существующий `AW server`, не поднимая локальный `aw-server-rust`.
+
+Подтвержденный целевой кейс:
+
+- Linux desktop/admin host: `10.10.10.2`
+- удаленный `AW server`: `10.10.10.13:5600`
+
+## Что делает скрипт
+
+- скачивает официальный Linux ZIP `ActivityWatch`;
+- распаковывает bundle в `~/.local/opt/activitywatch/v<version>`;
+- обновляет symlink `~/.local/opt/activitywatch/current`;
+- пишет `aw-client.toml` с указанием удаленного `AW server`;
+- пишет `aw-qt.toml`, где оставляет только `aw-watcher-afk` и `aw-watcher-window`;
+- создает launcher `~/.local/bin/activitywatch-remote-aw`;
+- создает XDG autostart entry `~/.config/autostart/activitywatch-remote-aw.desktop`.
+
+## Установка
+
+```bash
+cd /path/to/AWatch-rus
+sh ./scripts/install_aw_linux_client.sh \
+  --server-host 10.10.10.13 \
+  --server-port 5600
+```
+
+Если нужно переустановить ту же версию:
+
+```bash
+sh ./scripts/install_aw_linux_client.sh --force
+```
+
+## Ключевые файлы
+
+- `~/.config/activitywatch/aw-client/aw-client.toml`
+- `~/.config/activitywatch/aw-qt/aw-qt.toml`
+- `~/.local/bin/activitywatch-remote-aw`
+- `~/.config/autostart/activitywatch-remote-aw.desktop`
+
+## Ручной запуск
+
+```bash
+~/.local/bin/activitywatch-remote-aw
+```
+
+## Проверка
+
+Проверка bundle и конфигурации:
+
+```bash
+~/.local/opt/activitywatch/current/aw-qt --help
+~/.local/opt/activitywatch/current/aw-watcher-afk/aw-watcher-afk --help
+~/.local/opt/activitywatch/current/aw-watcher-window/aw-watcher-window --help
+cat ~/.config/activitywatch/aw-client/aw-client.toml
+cat ~/.config/activitywatch/aw-qt/aw-qt.toml
+```
+
+Проверка на сервере:
+
+```bash
+curl -fsS http://10.10.10.13:5600/api/0/buckets | jq -r 'keys[]' | grep '^aw-watcher-'
+```
+
+## Ограничение
+
+`aw-watcher-window` и `aw-watcher-afk` требуют реальную пользовательскую desktop-сессию (`X11`/поддерживаемый GUI login). Если на хосте нет активного GUI-сеанса, установка пройдет, но событий от watcher'ов не будет до первого нормального графического входа пользователя.