Внимание: на сервере работает второй проект — VoIdeaAI

Дата развёртывания

2026-05-19

Сервер

81.177.141.34 — единый VPS для двух независимых проектов.

1. Проекты на сервере

Проект A: aegisone

Параметр	Значение
Порты	8000 (FastAPI), 8080/9000 (PHP), 5432 (PostgreSQL)
Директория	`/opt/projects/aegisone-php/`, `/opt/projects/aegisone-py/`
Домен	aegisone.ru, service.aegisone.ru
Тип	PHP + Python FastAPI

Проект B: VoIdeaAI

Параметр	Значение
Порты	8020 (FastAPI), 5444 (PostgreSQL), 6380 (Redis)
Директория	`/opt/projects/voidea/`
Домен	voideaai.ru, git.voideaai.ru (через nginx-proxy)
Gitea	порт 3000, PostgreSQL 5433, git.voideaai.ru
Тип	Python FastAPI + React Frontend

2. Критические правила

НЕ занимать порты VoIdeaAI

8020  — FastAPI app
5444  — PostgreSQL
6380  — Redis
5433  — Gitea PostgreSQL
3000  — Gitea web

nginx-proxy общий

Конфиги: /opt/projects/nginx-proxy/conf.d/
Файл VoIdea: voideaai.ru.conf
Файл Gitea: git.voideaai.ru.conf

Перед рестартом nginx — всегда проверять:

docker compose -p nginx-proxy exec nginx nginx -t

Docker

Все контейнеры используют network_mode: host (bridge не работает на этом VPS)
Docker build требует network: host в конфиге сборки
docker system prune -af удалит build cache ВСЕХ проектов — не запускать во время сборки
docker compose -p voidea — префикс для команд VoIdea
docker compose -p gitea — префикс для команд Gitea
docker compose -p nginx-proxy — префикс для nginx

Диск

20GB всего, ~13GB свободно (на момент деплоя)
Перед крупными операциями: df -h /
При нехватке места: docker builder prune -af

3. Команды для проверки состояния VoIdeaAI

# Статус
docker compose -p voidea ps

# Логи
docker compose -p voidea logs --tail=20 app

# Проверка здоровья
curl -s http://localhost:8020/health
curl -s http://localhost:8020/api/v1/health

# Состояние БД
docker exec voidea-db-1 psql -U voidea -h localhost -p 5444 -d voidea -c "\dt"

4. Что делать при проблемах с VoIdeaAI

Не работает voideaai.ru — проверить nginx: nginx -t, проверить конфиг
VoIdea API не отвечает — docker compose -p voidea logs app
VoIdea не может подключиться к БД — проверить localhost:5444, логи docker compose -p voidea logs db
Gitea не открывается — проверить порт 3000: curl -s http://localhost:3000

Если проблема серьёзная — остановить VoIdea без ущерба для aegisone:

docker compose -p voidea down
# aegisone продолжит работу независимо

5. Контакты

По вопросам VoIdeaAI — обратиться к разработчику, ведущему проект VoIdea
Проекты независимы, команды разные
Изменения в nginx-proxy влияют на оба проекта — согласовывать

Создан: 2026-05-19 Не редактировать вручную без необходимости

3.8 KiB Raw Blame History