Инфраструктура

Раздел описывает серверную инфраструктуру Energoskan Development Portal: каталоги, службы, Docker-контейнеры, сеть, порты, хранение данных и резервное копирование.

Сервер

Hostname: kndtesdxxm
ОС:       Ubuntu 24.04 LTS
Домен:    energoskandev.ru

Основные команды проверки сервера:

hostname
cat /etc/os-release
uptime
free -h
df -h
lsblk

Основной каталог портала

/opt/dev-portal

Ключевые каталоги:

• panel/ — сервер и веб-интерфейс панели;
• content/ — документация и материалы портала;
• shim/ — AI-шлюз;
• templates/ — шаблоны проектов;
• systemd/ — эталонные файлы служб;
• nginx/ — эталонная конфигурация Nginx;
• scripts/ — служебные сценарии;
• workspace-image/ — сборка рабочего Docker-образа;
• docs/ — история, решения и технические документы;
• backups/ — резервные копии внутри репозитория.

Данные пользователей

/data/vibe-students/<пользователь>

В этом каталоге находятся рабочие проекты пользователей. Он не должен удаляться при обновлении приложения портала.

Системная конфигурация

/data/config

В каталоге могут находиться:

• данные пользователей;
• настройки авторизации;
• транскрипты и служебные журналы;
• конфигурация рабочих пространств;
• данные, необходимые для работы контейнеров.

Systemd-службы

Основные службы портала:

• vibe-panel.service — веб-панель;
• anthropic-shim.service — AI-шлюз;
• nginx.service — внешний веб-сервер;
• docker.service — рабочие контейнеры;
• privoxy.service — прокси при необходимости.

Проверка состояния:

systemctl status vibe-panel.service
systemctl status anthropic-shim.service
systemctl status nginx.service
systemctl status docker.service
systemctl status privoxy.service

Перезапуск панели:

systemctl restart vibe-panel.service

Панель портала

Каталог: /opt/dev-portal/panel
Процесс: node server.js
Адрес:   127.0.0.1
Порт:    3020

Проверка:

curl -I http://127.0.0.1:3020/
curl -s http://127.0.0.1:3020/api/version
journalctl -u vibe-panel.service -n 100 --no-pager

Docker

Пользовательские рабочие пространства запускаются в изолированных Docker-контейнерах.

Рабочий образ: vibe-workspace:dev
Пример контейнера: vibe-admin

Основные команды:

docker ps
docker ps -a
docker images
docker inspect vibe-admin
docker logs --tail 100 vibe-admin
docker exec -it vibe-admin sh

Рабочее пространство внутри контейнера

/home/student/workspace

Пример соответствия каталогов:

Сервер:
  /data/vibe-students/admin

Контейнер:
  /home/student/workspace

Сеть и порты

• 443 — HTTPS;
• 80 — HTTP с перенаправлением на HTTPS;
• 3020 — локальная панель;
• 8190 — AI-шлюз, если используется текущая конфигурация;
• 8200+ — пользовательские рабочие пространства;
• 8400+ — SSH-порты контейнеров;
• 8118 — Privoxy.

Проверка прослушиваемых портов:

ss -lntp
docker ps --format 'table {{.Names}}\t{{.Ports}}'

Nginx

/etc/nginx/sites-available/energoskandev.ru

Основной маршрут:

energoskandev.ru
        ↓
Nginx
        ↓
127.0.0.1:3020

Хранение резервных копий

Серверные резервные копии рекомендуется хранить в:

/opt/backups

Примеры объектов резервного копирования:

• исходный код портала;
• пользовательские проекты;
• конфигурация Nginx;
• systemd-службы;
• данные авторизации;
• транскрипты перед очисткой;
• важные рабочие приложения.

Что не должно попадать в Git

• .env и другие файлы с секретами;
• node_modules/;
• закрытые ключи и сертификаты;
• временные файлы;
• журналы приложений;
• пользовательские загрузки;
• рабочие данные контейнеров.

Контроль ресурсов

uptime
free -h
df -h
du -sh /opt/dev-portal
du -sh /data/vibe-students
docker system df
docker stats --no-stream

Диагностика инфраструктуры

systemctl --failed
journalctl -p err -n 100 --no-pager
ss -lntp
docker ps -a
df -h
free -h

Порядок изменения инфраструктуры

1. Зафиксировать текущее состояние.
2. Создать резервную копию изменяемого файла или каталога.
3. Внести одно контролируемое изменение.
4. Проверить синтаксис конфигурации.
5. Перезапустить только необходимую службу.
6. Проверить локальный адрес.
7. Проверить внешний адрес.
8. Изучить журналы ошибок.
9. Зафиксировать результат в документации.

Правила администратора

1. Не удалять данные пользователей при обновлении портала.
2. Не менять несколько инфраструктурных компонентов одновременно.
3. Не открывать внутренние порты наружу без необходимости.
4. Не хранить секреты в репозитории.
5. Перед очисткой Docker проверять используемые контейнеры и образы.
6. После каждого изменения проверять службы, порты и журналы.