После прочтения Claude
This commit is contained in:
administrator
@@ -0,0 +1,5 @@
|
||||
# MEMORY — VPS nao-kvn.ru
|
||||
|
||||
- [Состояние VPS](project_vps_state.md) — архитектура, сервисы, безопасность, бэкап, доступ, репозиторий
|
||||
- [Открытые задачи](project_open_tasks.md) — мониторинг (P1, не сделан), пароли (P2), известные риски
|
||||
- [Принципы работы](feedback_working_principles.md) — пошаговость, подтверждения, без объединения шагов
|
||||
@@ -0,0 +1,19 @@
|
||||
---
|
||||
name: feedback-working-principles
|
||||
description: "Принципы работы с VPS — осторожность, пошаговость, откат"
|
||||
metadata:
|
||||
node_type: memory
|
||||
type: feedback
|
||||
originSessionId: 2f046c73-11b0-4c4c-b2ed-132762fcae8c
|
||||
---
|
||||
|
||||
# Принципы работы с этим проектом
|
||||
|
||||
Продакшен-аккуратность: для рискованных изменений сначала проверка, затем применение, с путём отката.
|
||||
|
||||
- По одному шагу за раз, с ожиданием подтверждения перед следующим.
|
||||
- В multi-step процедурах шаги **не объединять** — выполнять последовательно.
|
||||
- Перед применением изменений на VPS — сначала проверить, что делаем; потом применять.
|
||||
|
||||
**Why:** VPS в проде, сервисы живые (Vaultwarden с паролями). Цена ошибки высокая.
|
||||
**How to apply:** Любое изменение на сервере — сначала описать план, дождаться подтверждения, затем выполнять по одному шагу.
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
name: project-open-tasks
|
||||
description: "Незакрытые задачи проекта VPS — мониторинг, уведомления, пароли"
|
||||
metadata:
|
||||
node_type: memory
|
||||
type: project
|
||||
originSessionId: 2f046c73-11b0-4c4c-b2ed-132762fcae8c
|
||||
---
|
||||
|
||||
# Открытые задачи — VPS nao-kvn.ru
|
||||
|
||||
## Приоритет 1 — Мониторинг (исходная цель проекта, ещё не достигнута)
|
||||
|
||||
**Канал уведомлений:** Telegram **отвергнут** (массовые блокировки/тротлинг в РФ с весны 2026).
|
||||
- Вариант A: **ntfy** self-hosted (`ntfy.nao-kvn.ru` через Caddy) — приоритетный под РФ, лёгкий
|
||||
- Вариант B: email (SMTP)
|
||||
|
||||
**Мониторы в Uptime Kuma** (развёрнут, но пустой):
|
||||
- ping белых IP/шлюзов трёх площадок (отличать «упала площадка» от «упал сервис»)
|
||||
- TCP/HTTP-проверки ключевых сервисов
|
||||
- Группы: «Арктика / Архангельскстат / Дом»
|
||||
- Подвесить уведомления на мониторы
|
||||
|
||||
## Приоритет 2
|
||||
- Перенести пароли из бумажного блокнота в Vaultwarden (бэкап проверен — безопасно), затем уничтожить блокнот
|
||||
|
||||
## Опционально
|
||||
- `live-restore` в daemon.json (апдейты Docker без падения контейнеров)
|
||||
- Периодический `docker system prune` по расписанию
|
||||
- Апгрейд тарифа до 2 ГБ RAM при добавлении сервисов
|
||||
|
||||
## Известные риски
|
||||
- RAM в обрез (~0.5/0.96 ГБ) — любой тяжёлый сервис потребует апгрейда
|
||||
- Нет рабочего мониторинга → сбои на площадках не оповещают (главная функциональная дыра)
|
||||
- `ADMIN_TOKEN` Vaultwarden открытым текстом в compose (приемлемо, but known risk)
|
||||
- SMB-копия зависит от доступности дома (by design best-effort)
|
||||
- Один VPS — единая точка отказа по аптайму
|
||||
|
||||
**Why:** Мониторинг — исходная цель всего проекта. Uptime Kuma развёрнут, но без мониторов и уведомлений цель не достигнута.
|
||||
**How to apply:** При новой сессии — начинать отсюда. Первый шаг всегда: выбор канала уведомлений (ntfy vs email).
|
||||
@@ -0,0 +1,74 @@
|
||||
---
|
||||
name: project-vps-state
|
||||
description: "Полное состояние VPS nao-kvn.ru — архитектура, сервисы, безопасность, бэкап, доступ"
|
||||
metadata:
|
||||
node_type: memory
|
||||
type: project
|
||||
originSessionId: 2f046c73-11b0-4c4c-b2ed-132762fcae8c
|
||||
---
|
||||
|
||||
# VPS nao-kvn.ru — текущее состояние
|
||||
|
||||
## Доступ
|
||||
- SSH: `ssh root@45.91.8.169` — только ed25519-ключ (Manjaro `~/.ssh/id_ed25519`, с passphrase), пароль отключён.
|
||||
- Стек: `/opt/docker/core/` (`docker-compose.yml` + `caddy/Caddyfile`)
|
||||
- Сервисы: https://vault.nao-kvn.ru, https://portainer.nao-kvn.ru, https://status.nao-kvn.ru
|
||||
- ТЗ VPS: MSK
|
||||
|
||||
## Сервер
|
||||
- IP `45.91.8.169`, хост `box-938039`, Ubuntu 24.04 LTS, KVM
|
||||
- 1 vCPU, 961 MiB RAM, 20 ГБ диск, swap 2 ГБ, тариф 400₽/мес
|
||||
- RAM в обрез: ~0.5 ГБ занято из 0.96 ГБ
|
||||
|
||||
## Архитектура
|
||||
- Один Compose-стек в `/opt/docker/core`, сеть `core_proxy`
|
||||
- **Caddy — единственная публичная точка входа (80/443)**, авто-HTTPS Let's Encrypt
|
||||
- Остальные контейнеры на хост портов не публикуют — только через Caddy по имени контейнера
|
||||
- WireGuard-туннель VPS→Keenetic для домашнего SMB (445 в интернет не выставлен)
|
||||
|
||||
## Сервисы
|
||||
| Сервис | Образ | Доступ |
|
||||
|---|---|---|
|
||||
| caddy | caddy:2 | proxy + TLS, 80/443 на хост |
|
||||
| portainer | portainer/portainer-ce:lts | portainer.nao-kvn.ru, basic-auth |
|
||||
| uptime-kuma | louislam/uptime-kuma:1 | status.nao-kvn.ru, basic-auth |
|
||||
| vaultwarden | vaultwarden/server:latest | vault.nao-kvn.ru, публичный |
|
||||
|
||||
Volumes: `core_{caddy_data,caddy_config,portainer_data,uptime_data,vaultwarden_data}`
|
||||
|
||||
## Безопасность
|
||||
- HTTPS везде; UFW: только SSH разрешён; 80/443 управляет Docker через iptables
|
||||
- Caddy basic-auth (логин `admin`, bcrypt) перед Portainer и Uptime Kuma — сниппет `(protected)`
|
||||
- Vaultwarden: `SIGNUPS_ALLOWED=false`, `ADMIN_TOKEN` задан (открытым текстом в compose — известный компромисс)
|
||||
- SSH: `PasswordAuthentication no`, `PermitRootLogin prohibit-password`, конфиг `/etc/ssh/sshd_config.d/00-hardening.conf`
|
||||
- fail2ban на SSH (banaction = ufw); docker-логи лимитированы 10МБ×3
|
||||
|
||||
## Домашний роутер Keenetic Hopper KN-3811
|
||||
- Белый IP `91.122.209.x` (реальный endpoint в `/etc/wireguard/wg0.conf` на VPS)
|
||||
- WireGuard-сервер; SMB-шара `TOSHIBA EXT`, юзер `only_vps`, LAN `172.16.0.0/24`
|
||||
- WG: VPS `10.0.0.5`, Keenetic `10.0.0.1`, маршрут `172.16.0.0/24`, `PersistentKeepalive=25`
|
||||
|
||||
## Бэкап Vaultwarden
|
||||
- Скрипт `/usr/local/bin/vw-backup.sh`: sqlite3 `.backup` + rsa_key*/config.json/attachments/sends → tar.gz
|
||||
- 3 копии: (1) локально `/opt/backups/vaultwarden/` 14 шт.; (2) `gdrive:vaultwarden-backups/` 90 дн.; (3) `homesmb:TOSHIBA EXT/vaultwarden-backups/` best-effort 90 дн.
|
||||
- Расписание: `vw-backup.timer`, ежедневно 03:30 MSK, Persistent=true
|
||||
- rclone-remotes: `gdrive` (scope drive.file), `homesmb` (smb, 172.16.0.1, only_vps)
|
||||
- **Восстановление проверено фактически**: integrity_check ok, аккаунт + записи + rsa_key на месте
|
||||
|
||||
## DNS
|
||||
- Домен `nao-kvn.ru`. A → `45.91.8.169`: portainer, status, vault
|
||||
- TLS-ALPN-01 валидация, сертификаты в `core_caddy_data`
|
||||
|
||||
## Пакеты
|
||||
Docker CE 29.6.0 / containerd 2.2.5; sqlite3; rclone (SMB-бэкенд); wireguard-tools; smbclient; fail2ban; ufw
|
||||
|
||||
## Репозиторий проекта
|
||||
`/mnt/Dick_E/Projects/vps-server-01/`
|
||||
- [VPS/configs/](VPS/configs/) — все конфиги (Caddyfile, docker-compose.yml, wg0.conf, sshd, daemon.json, fail2ban)
|
||||
- [VPS/scripts/vw-backup.sh](VPS/scripts/vw-backup.sh) — скрипт бэкапа
|
||||
- [VPS/OPERATIONS_RUNBOOK.md](VPS/OPERATIONS_RUNBOOK.md) — операционные процедуры
|
||||
- [VPS/TODO.md](VPS/TODO.md) — открытые задачи
|
||||
- [vps-nao-kvn-state.md](vps-nao-kvn-state.md) — детальный state-документ
|
||||
|
||||
**Why:** Личный VPS для управления контейнерами (Portainer), мониторинга доступности трёх площадок с белыми IP (ДК «Арктика», Архангельскстат Нарьян-Мар, дом) и хранения паролей (Vaultwarden).
|
||||
**How to apply:** При работе с VPS — читать этот файл для контекста. Проверять актуальность подключившись по SSH.
|
||||
Reference in New Issue
Block a user