b2a1a6289cc7ef7b7f32fde34787966eccf946ef
AWatch-rus
Практический каркас проекта для повторного развёртывания ActivityWatch Server в новом окружении с LXC-контейнером на Proxmox, русифицированным Web UI, systemd-юнитами, шаблонными скриптами деплоя и эксплуатационной документацией.
Что входит
docs/preparation.md— подготовка инфраструктуры и входных параметров.docs/deployment.md— пошаговый деплой LXC и ActivityWatch Server.docs/runbook.md— быстрый runbook для оператора.docs/operations.md— регламент сопровождения, бэкапов, обновлений и rollback.docs/windows/ensemble.md— orchestration-пакет для Windows-деплоя и проверки.docs/linux-client.md— user-space rollout Linux-клиента ActivityWatch на удалённыйAW server.docs/linux-remote-worker.md— полный Linux remote-worker stack: GUI, SSH/console и browser admin UI вроде Proxmox:8006.docs/console-ssh-logger.md— логирование только консольных команд и SSH-сессий в AW.docs/dlp-gap-analysis.md— разрыв до enterprise DLP и roadmap.docs/dlp-aggregator.md— прототип централизованной агрегации DLP/file-operation событий.docs/dlp-reliability-roadmap.md— roadmap повышения надёжности DLP-коллекторов.docs/powershell-analysis.md— статический анализ работоспособности DLP PowerShell-скриптов.proxmox/— шаблонные скрипты подготовки и наполнения CT на стороне Proxmox.aw-server/— установочные скрипты, env-шаблон, systemd unit и RU patch для Web UI.ansible/— Ansible-ensemble для автоматизированного сервера (Debian/CT).pfsense/— внешний poller для pfSense API и systemd unit под Debian/Ubuntu utility VM.windows/— PowerShell toolkit: single-user, domain-users, ensemble orchestration, hardening/recovery, validation, Windows/RDP DLP telemetry (aw-dlp-incidents_*,aw-dlp-endpoint-signals_*) и session-level presence для удалённых Windows/RDP пользователей (aw-worktime-sessions_*).scripts/quality-gate.sh— локальный preflight-пайплайн проверок.scripts/aggregate_dlp_events.py— сборaw-file-operations_*иaw-dlp-incidents_*в SQLite/PostgreSQL.scripts/install_aw_linux_client.sh— установка Linux bundle + autostart для remote AW server.scripts/install_aw_console_ssh_logger.sh— user-space установка console/ssh logger.scripts/install_aw_linux_web_category_logger.sh— user-space классификация browser admin UI по title/class.scripts/install_aw_linux_remote_worker.sh— полный Linux remote-worker installer.
Базовый сценарий
- Подготовить параметры окружения по
docs/preparation.md. - Заполнить единый файл секретов
secrets/deploy.secrets.env(автоподключение). - На узле Proxmox создать контейнер через
proxmox/create-ct.sh. - Загрузить артефакты и серверный env в CT через
proxmox/push-aw-artifacts.sh. - Внутри контейнера выполнить
aw-server/install_aw_server.sh. - Применить русификацию Web UI через
aw-server/apply_webui_ru_patch.sh. - Проверить API, Web UI и состояние systemd по
docs/runbook.md. - Развернуть Windows-клиентов через
windows/deploy-ensemble.ps1. - Проверить итог через
windows/validate-deployment.ps1.
Для полного Ansible-сценария “с нуля” в Proxmox используйте:
ansible/provision_proxmox_ct_and_deploy_aw.ymlansible/provision_proxmox_ct_matrix_and_deploy_aw.yml(массово по матрице CT)
Для централизованного деплоя Windows/RDP-клиентов через WinRM:
ansible/deploy_aw_windows.yml
Для внешнего pfSense poller'а:
ansible/deploy_aw_pfsense_poller.yml
Для Linux desktop/admin host, который должен слать watcher'ы на удалённый AW server:
docs/linux-client.mdscripts/install_aw_linux_client.sh
Для полного Linux remote-worker сценария:
docs/linux-remote-worker.mdscripts/install_aw_linux_remote_worker.sh
Для режима “только консоль/ssh” без GUI watcher'ов:
docs/console-ssh-logger.mdscripts/install_aw_console_ssh_logger.sh
Скрипты proxmox/create-ct.sh и proxmox/push-aw-artifacts.sh по умолчанию читают:
secrets/deploy.secrets.env
Принципы
- Никаких реальных секретов, токенов и боевых IP в репозитории.
- Все переменные вынесены в
.example/.envшаблоны. - Документация ориентирована на повторяемое развёртывание, а не на одноразовую ручную установку.
- Rollback и backup описаны как обязательная часть каждой операции.
Минимальная структура
- CT/LXC на Debian 12
- ActivityWatch Server Rust release
- Web UI override в
/opt/activitywatch/webui-ru - systemd unit
activitywatch-server.service - bind/listen через переменные окружения
Ограничения
- Интеграции с InfluxDB/Grafana/LDAP оставлены как следующий слой, не как обязательная база.
Быстрые ссылки
/mnt/usb_hdd2/Projects/ActivityWatch-Russian/docs/FULL_DEPLOYMENT_MANUAL_RU.md/home/igor/tmp/AWatch-rus/docs/windows/ensemble.mddocs/preparation.mddocs/deployment.mddocs/runbook.mddocs/operations.mdproxmox/create-ct.shaw-server/install_aw_server.shwindows/deploy-ensemble.ps1windows/validate-deployment.ps1
Languages
PowerShell
51.8%
JavaScript
35.4%
Shell
10.8%
Python
1.4%
TSQL
0.6%