VPN Deploy Stack — база знаний¶

Двуузловая система деплоя VPN-инфраструктуры.
Точка входа — VPS-RU (kuzya-cabi.net, 89.44.87.72), точка выхода — VPS-US (104.168.117.102).

Карта эпиков¶

Эпик	Модули	Статус	Обновлено	Что нового
base	`00_base.sh`	stable	2026-09-13	Docker, UFW, system baseline
vpn	`01_3xui` · `04_ssh_tunnel` · `05_us_exit` · `07_wg_server` · `08_wg_client`	stable	2026-09-13	VLESS+WG+SSH, leastPing балансировщик
web	`06_caddy` · `11_cv` · `12_mebel` · `14_wiki`	stable	2026-09-13	caddy-docker-proxy, wildcard TLS, doc-сайт
services	`02_vaultwarden` · `03_monitoring` · `13_price_tracker`	stable	2026-09-13	Vaultwarden, Portainer, Telegram-бот
testing	`99_test.sh`	stable	2026-09-13	XRay stats, VLESS WS, SOCKS5

Навигация¶

docs/
  index.md          ← эта страница
  overview.md       ← архитектура и взаимосвязи (mermaid)
  epics/<эпик>/
    README.md       ← цель, модули, статус
    flows.md        ← процессы (mermaid)
    decisions.md    ← архитектурные решения, APPEND-ONLY
    open.md         ← вопросы и TODO
  templates/epic.md ← шаблон для нового эпика

Локальная сборка¶

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs serve        # http://127.0.0.1:8000

Деплой документации¶

modules/14_wiki.sh — деплой на VPS-RU → https://doc.kuzya-cabi.net

.\deploy-all.ps1 --RU --force 14

Цепочка: обновить docs/ → deploy-all.ps1 --RU --force 14 → SCP бандл (включая docs/) → 14_wiki.sh → mkdocs build --strict → nginx:alpine → Caddy labels.

Детали: epics/web/README.md · скилл: deploy-docs