1326 lines
36 KiB
Markdown
1326 lines
36 KiB
Markdown
# Инструкция по настройке VPS и миграции проектов
|
||
|
||
> **Сервер:** Ubuntu 24.04 LTS (чистая установка)
|
||
> **Цель:** Docker-инфраструктура для 3+ проектов с мультидоменом, SSL, Git-сервером и CI/CD
|
||
> **Дата:** 2026-05-17
|
||
> **Примечание:** Если при выполнении возникнут вопросы — лучше уточнить, чем переделывать потом.
|
||
|
||
---
|
||
|
||
## Содержание
|
||
|
||
1. [Подключение к VPS](#1-подключение-к-vps)
|
||
2. [Базовая настройка сервера](#2-базовая-настройка-сервера)
|
||
3. [Установка Docker и Docker Compose](#3-установка-docker-и-docker-compose)
|
||
4. [Структура директорий для мультипроекта](#4-структура-директорий-для-мультипроекта)
|
||
5. [Nginx Reverse Proxy + Let's Encrypt](#5-nginx-reverse-proxy--lets-encrypt)
|
||
6. [Gitea (Git-сервер)](#6-gitea-git-сервер)
|
||
7. [Подготовка к переносу AegisOne (PHP)](#7-подготовка-к-переносу-aegisone-php)
|
||
8. [Подготовка Python-админки (FastAPI)](#8-подготовка-python-админки-fastapi)
|
||
9. [CI/CD с Gitea Actions](#9-cicd-с-gitea-actions)
|
||
10. [Бэкапы и мониторинг](#10-бэкапы-и-мониторинг)
|
||
11. [Чек-лист завершения](#11-чек-лист-завершения)
|
||
|
||
---
|
||
|
||
## 1. Подключение к VPS
|
||
|
||
### 1.1. Получение данных для подключения
|
||
После создания VPS в панели Jino.ru вы получите:
|
||
- **IP-адрес сервера** (например, `185.100.100.50`)
|
||
- **Логин:** `root`
|
||
- **Пароль:** (указан в панели или отправлен на email)
|
||
|
||
### 1.2. Подключение через PowerShell (Windows)
|
||
```powershell
|
||
# Откройте PowerShell и выполните:
|
||
ssh root@<IP-АДРЕС-VPS>
|
||
|
||
# При первом подключении подтвердите fingerprint (yes)
|
||
# Введите пароль
|
||
```
|
||
|
||
### 1.3. Создание обычного пользователя (безопасность)
|
||
```bash
|
||
# Создать пользователя (замените 'angel' на ваше имя)
|
||
adduser angel
|
||
|
||
# Добавить в группу sudo (права администратора)
|
||
usermod -aG sudo angel
|
||
|
||
# Переключиться на нового пользователя
|
||
su - angel
|
||
```
|
||
|
||
### 1.4. Настройка SSH-ключей (опционально, но рекомендуется)
|
||
```bash
|
||
# На локальной машине (Windows PowerShell):
|
||
ssh-keygen -t ed25519 -C "angel@vps"
|
||
# Нажимайте Enter для всех вопросов (пароль можно оставить пустым)
|
||
|
||
# Копирование ключа на сервер:
|
||
ssh-copy-id angel@<IP-АДРЕС-VPS>
|
||
|
||
# Проверка подключения без пароля:
|
||
ssh angel@<IP-АДРЕС-VPS>
|
||
```
|
||
|
||
---
|
||
|
||
## 2. Базовая настройка сервера
|
||
|
||
### 2.1. Обновление системы
|
||
```bash
|
||
# Обновить списки пакетов и установить обновления
|
||
sudo apt update && sudo apt upgrade -y
|
||
|
||
# Установить необходимые утилиты
|
||
sudo apt install -y \
|
||
curl \
|
||
wget \
|
||
git \
|
||
ufw \
|
||
fail2ban \
|
||
htop \
|
||
nano \
|
||
certbot \
|
||
python3-certbot-nginx
|
||
```
|
||
|
||
### 2.2. Настройка фаервола (UFW)
|
||
```bash
|
||
# Разрешить SSH (порт 22)
|
||
sudo ufw allow 22/tcp
|
||
|
||
# Разрешить HTTP и HTTPS
|
||
sudo ufw allow 80/tcp
|
||
sudo ufw allow 443/tcp
|
||
|
||
# Включить фаервол
|
||
sudo ufw enable
|
||
|
||
# Проверить статус
|
||
sudo ufw status
|
||
```
|
||
|
||
### 2.3. Настройка Fail2Ban (защита от перебора паролей)
|
||
```bash
|
||
# Скопировать конфиг
|
||
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
|
||
|
||
# Перезапустить сервис
|
||
sudo systemctl enable fail2ban
|
||
sudo systemctl restart fail2ban
|
||
|
||
# Проверить статус
|
||
sudo fail2ban-client status
|
||
```
|
||
|
||
### 2.4. Настройка часового пояса
|
||
```bash
|
||
# Установить московское время
|
||
sudo timedatectl set-timezone Europe/Moscow
|
||
|
||
# Проверить
|
||
timedatectl
|
||
```
|
||
|
||
### 2.5. Настройка swap-файла (если мало RAM)
|
||
```bash
|
||
# Создать swap-файл 2GB
|
||
sudo fallocate -l 2G /swapfile
|
||
sudo chmod 600 /swapfile
|
||
sudo mkswap /swapfile
|
||
sudo swapon /swapfile
|
||
|
||
# Добавить в fstab для автозагрузки
|
||
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
|
||
|
||
# Проверить
|
||
free -h
|
||
```
|
||
|
||
---
|
||
|
||
## 3. Установка Docker и Docker Compose
|
||
|
||
### 3.1. Установка Docker
|
||
```bash
|
||
# Удалить старые версии (если есть)
|
||
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
|
||
sudo apt-get remove -y $pkg
|
||
done
|
||
|
||
# Добавить репозиторий Docker
|
||
sudo apt-get update
|
||
sudo apt-get install -y ca-certificates curl
|
||
sudo install -m 0755 -d /etc/apt/keyrings
|
||
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
|
||
sudo chmod a+r /etc/apt/keyrings/docker.asc
|
||
|
||
# Добавить репозиторий в sources
|
||
echo \
|
||
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
|
||
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
|
||
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||
|
||
# Установить Docker
|
||
sudo apt-get update
|
||
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
||
|
||
# Проверить установку
|
||
docker --version
|
||
docker compose version
|
||
```
|
||
|
||
### 3.2. Настройка пользователя для Docker (без sudo)
|
||
```bash
|
||
# Добавить текущего пользователя в группу docker
|
||
sudo usermod -aG docker $USER
|
||
|
||
# Применить изменения (выйти и зайти снова, или выполнить:)
|
||
newgrp docker
|
||
|
||
# Проверить (должно работать без sudo)
|
||
docker run hello-world
|
||
```
|
||
|
||
### 3.3. Настройка автозапуска Docker
|
||
```bash
|
||
sudo systemctl enable docker
|
||
sudo systemctl enable containerd
|
||
```
|
||
|
||
---
|
||
|
||
## 4. Структура директорий для мультипроекта
|
||
|
||
### 4.1. Создание структуры
|
||
```bash
|
||
# Создать основную директорию для проектов
|
||
sudo mkdir -p /opt/projects
|
||
sudo chown -R $USER:$USER /opt/projects
|
||
|
||
# Создать директории для каждого проекта
|
||
mkdir -p /opt/projects/{nginx-proxy,gitea,aegisone-php,aegisone-py,project2,project3}
|
||
|
||
# Создать директорию для общих данных
|
||
mkdir -p /opt/projects/{backups,certs,data}
|
||
```
|
||
|
||
### 4.2. Итоговая структура
|
||
```
|
||
/opt/projects/
|
||
├── nginx-proxy/ # Nginx reverse proxy + Certbot
|
||
│ ├── docker-compose.yml
|
||
│ ├── nginx.conf
|
||
│ └── certs/ # SSL-сертификаты Let's Encrypt
|
||
├── gitea/ # Git-сервер
|
||
│ ├── docker-compose.yml
|
||
│ └── data/ # Данные Gitea (репозитории, БД)
|
||
├── aegisone-php/ # Публичная часть AegisOne (PHP)
|
||
│ ├── docker-compose.yml
|
||
│ ├── src/ # Исходный код (git clone)
|
||
│ └── nginx.conf
|
||
├── aegisone-py/ # Сервисная часть AegisOne (Python)
|
||
│ ├── docker-compose.yml
|
||
│ ├── app/ # FastAPI приложение
|
||
│ └── requirements.txt
|
||
├── project2/ # Второй проект
|
||
│ └── docker-compose.yml
|
||
├── project3/ # Третий проект
|
||
│ └── docker-compose.yml
|
||
├── backups/ # Бэкапы БД и файлов
|
||
├── certs/ # Общие SSL-сертификаты
|
||
└── data/ # Общие данные (PostgreSQL, Redis)
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Nginx Reverse Proxy + Let's Encrypt
|
||
|
||
### 5.1. Создание docker-compose.yml для Nginx
|
||
```bash
|
||
cd /opt/projects/nginx-proxy
|
||
nano docker-compose.yml
|
||
```
|
||
|
||
**Содержимое `docker-compose.yml`:**
|
||
```yaml
|
||
version: '3.8'
|
||
|
||
services:
|
||
nginx:
|
||
image: nginx:alpine
|
||
container_name: nginx-proxy
|
||
ports:
|
||
- "80:80"
|
||
- "443:443"
|
||
volumes:
|
||
- ./nginx.conf:/etc/nginx/nginx.conf:ro
|
||
- ./certs:/etc/nginx/certs:ro
|
||
- ./conf.d:/etc/nginx/conf.d:ro
|
||
- ./html:/usr/share/nginx/html:ro
|
||
restart: unless-stopped
|
||
networks:
|
||
- proxy-net
|
||
|
||
certbot:
|
||
image: certbot/certbot:latest
|
||
container_name: certbot
|
||
volumes:
|
||
- ./certs:/etc/letsencrypt
|
||
- ./html:/var/www/certbot
|
||
entrypoint: "/bin/sh -c 'trap exit TERM; while :; do certbot renew; sleep 12h & wait $${!}; done;'"
|
||
restart: unless-stopped
|
||
|
||
networks:
|
||
proxy-net:
|
||
external: true
|
||
```
|
||
|
||
### 5.2. Создание базового nginx.conf
|
||
```bash
|
||
mkdir -p conf.d html
|
||
nano nginx.conf
|
||
```
|
||
|
||
**Содержимое `nginx.conf`:**
|
||
```nginx
|
||
user nginx;
|
||
worker_processes auto;
|
||
error_log /var/log/nginx/error.log warn;
|
||
pid /var/run/nginx.pid;
|
||
|
||
events {
|
||
worker_connections 1024;
|
||
}
|
||
|
||
http {
|
||
include /etc/nginx/mime.types;
|
||
default_type application/octet-stream;
|
||
|
||
# Логирование
|
||
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
|
||
'$status $body_bytes_sent "$http_referer" '
|
||
'"$http_user_agent" "$http_x_forwarded_for"';
|
||
access_log /var/log/nginx/access.log main;
|
||
|
||
# Оптимизация
|
||
sendfile on;
|
||
tcp_nopush on;
|
||
tcp_nodelay on;
|
||
keepalive_timeout 65;
|
||
types_hash_max_size 2048;
|
||
client_max_body_size 50M;
|
||
|
||
# Gzip сжатие
|
||
gzip on;
|
||
gzip_vary on;
|
||
gzip_proxied any;
|
||
gzip_comp_level 6;
|
||
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
|
||
|
||
# Включение конфигов для каждого домена
|
||
include /etc/nginx/conf.d/*.conf;
|
||
}
|
||
```
|
||
|
||
### 5.3. Создание сети для Docker
|
||
```bash
|
||
# Создать общую сеть для всех проектов
|
||
docker network create proxy-net
|
||
```
|
||
|
||
### 5.4. Запуск Nginx
|
||
```bash
|
||
cd /opt/projects/nginx-proxy
|
||
docker compose up -d
|
||
|
||
# Проверить
|
||
docker compose ps
|
||
docker compose logs -f
|
||
```
|
||
|
||
### 5.5. Получение SSL-сертификатов
|
||
```bash
|
||
# Для каждого домена выполнить:
|
||
docker compose run --rm certbot certonly \
|
||
--webroot \
|
||
--webroot-path=/var/www/certbot \
|
||
-d aegisone.ru \
|
||
-d www.aegisone.ru \
|
||
-d service.aegisone.ru \
|
||
-d git.aegisone.ru \
|
||
--email your@email.com \
|
||
--agree-tos \
|
||
--non-interactive
|
||
|
||
# Проверить сертификаты
|
||
ls -la certs/live/aegisone.ru/
|
||
```
|
||
|
||
### 5.6. Пример конфига для домена (aegisone.ru)
|
||
```bash
|
||
nano conf.d/aegisone.conf
|
||
```
|
||
|
||
**Содержимое `conf.d/aegisone.conf`:**
|
||
```nginx
|
||
# HTTP → HTTPS редирект
|
||
server {
|
||
listen 80;
|
||
server_name aegisone.ru www.aegisone.ru;
|
||
return 301 https://aegisone.ru$request_uri;
|
||
}
|
||
|
||
# HTTPS сервер
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name aegisone.ru www.aegisone.ru;
|
||
|
||
# SSL сертификаты
|
||
ssl_certificate /etc/nginx/certs/live/aegisone.ru/fullchain.pem;
|
||
ssl_certificate_key /etc/nginx/certs/live/aegisone.ru/privkey.pem;
|
||
|
||
# SSL настройки
|
||
ssl_protocols TLSv1.2 TLSv1.3;
|
||
ssl_ciphers HIGH:!aNULL:!MD5;
|
||
ssl_prefer_server_ciphers on;
|
||
|
||
# Проксирование на PHP-контейнер
|
||
location / {
|
||
proxy_pass http://aegisone-php:80;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5.7. Конфиг для поддомена (service.aegisone.ru)
|
||
```bash
|
||
nano conf.d/service-aegisone.conf
|
||
```
|
||
|
||
**Содержимое `conf.d/service-aegisone.conf`:**
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name service.aegisone.ru;
|
||
return 301 https://service.aegisone.ru$request_uri;
|
||
}
|
||
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name service.aegisone.ru;
|
||
|
||
ssl_certificate /etc/nginx/certs/live/aegisone.ru/fullchain.pem;
|
||
ssl_certificate_key /etc/nginx/certs/live/aegisone.ru/privkey.pem;
|
||
|
||
ssl_protocols TLSv1.2 TLSv1.3;
|
||
ssl_ciphers HIGH:!aNULL:!MD5;
|
||
ssl_prefer_server_ciphers on;
|
||
|
||
# Проксирование на Python-контейнер
|
||
location / {
|
||
proxy_pass http://aegisone-py:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5.8. Перезапуск Nginx после изменений
|
||
```bash
|
||
cd /opt/projects/nginx-proxy
|
||
docker compose restart nginx
|
||
|
||
# Проверить конфиг
|
||
docker compose exec nginx nginx -t
|
||
```
|
||
|
||
---
|
||
|
||
## 6. Gitea (Git-сервер)
|
||
|
||
### 6.1. Создание docker-compose.yml
|
||
```bash
|
||
cd /opt/projects/gitea
|
||
mkdir -p data
|
||
nano docker-compose.yml
|
||
```
|
||
|
||
**Содержимое `docker-compose.yml`:**
|
||
```yaml
|
||
version: '3.8'
|
||
|
||
services:
|
||
gitea:
|
||
image: gitea/gitea:latest
|
||
container_name: gitea
|
||
environment:
|
||
- USER_UID=1000
|
||
- USER_GID=1000
|
||
- GITEA__database__DB_TYPE=postgres
|
||
- GITEA__database__HOST=db:5432
|
||
- GITEA__database__NAME=gitea
|
||
- GITEA__database__USER=gitea
|
||
- GITEA__database__PASSWD=gitea_password
|
||
- GITEA__server__DOMAIN=git.aegisone.ru
|
||
- GITEA__server__HTTP_PORT=3000
|
||
- GITEA__server__ROOT_URL=https://git.aegisone.ru/
|
||
volumes:
|
||
- ./data:/data
|
||
- /etc/timezone:/etc/timezone:ro
|
||
- /etc/localtime:/etc/localtime:ro
|
||
ports:
|
||
- "3000:3000"
|
||
- "2222:22"
|
||
depends_on:
|
||
- db
|
||
restart: unless-stopped
|
||
networks:
|
||
- proxy-net
|
||
- gitea-net
|
||
|
||
db:
|
||
image: postgres:15-alpine
|
||
container_name: gitea-db
|
||
environment:
|
||
- POSTGRES_USER=gitea
|
||
- POSTGRES_PASSWORD=gitea_password
|
||
- POSTGRES_DB=gitea
|
||
volumes:
|
||
- ./data/postgres:/var/lib/postgresql/data
|
||
restart: unless-stopped
|
||
networks:
|
||
- gitea-net
|
||
|
||
networks:
|
||
proxy-net:
|
||
external: true
|
||
gitea-net:
|
||
driver: bridge
|
||
```
|
||
|
||
### 6.2. Запуск Gitea
|
||
```bash
|
||
cd /opt/projects/gitea
|
||
docker compose up -d
|
||
|
||
# Проверить
|
||
docker compose ps
|
||
docker compose logs -f gitea
|
||
```
|
||
|
||
### 6.3. Настройка Nginx для Gitea
|
||
```bash
|
||
nano /opt/projects/nginx-proxy/conf.d/gitea.conf
|
||
```
|
||
|
||
**Содержимое `conf.d/gitea.conf`:**
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name git.aegisone.ru;
|
||
return 301 https://git.aegisone.ru$request_uri;
|
||
}
|
||
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name git.aegisone.ru;
|
||
|
||
ssl_certificate /etc/nginx/certs/live/aegisone.ru/fullchain.pem;
|
||
ssl_certificate_key /etc/nginx/certs/live/aegisone.ru/privkey.pem;
|
||
|
||
ssl_protocols TLSv1.2 TLSv1.3;
|
||
ssl_ciphers HIGH:!aNULL:!MD5;
|
||
ssl_prefer_server_ciphers on;
|
||
|
||
client_max_body_size 50M;
|
||
|
||
location / {
|
||
proxy_pass http://gitea:3000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 6.4. Перезапуск Nginx
|
||
```bash
|
||
cd /opt/projects/nginx-proxy
|
||
docker compose restart nginx
|
||
```
|
||
|
||
### 6.5. Первоначальная настройка Gitea
|
||
1. Откройте `https://git.aegisone.ru`
|
||
2. Заполните форму регистрации первого пользователя (он станет администратором)
|
||
3. В настройках Gitea:
|
||
- Включить Gitea Actions (CI/CD)
|
||
- Настроить SSH-порт (2222)
|
||
- Создать организацию `aegisone`
|
||
|
||
### 6.6. Создание репозиториев
|
||
```bash
|
||
# Через веб-интерфейс Gitea создать:
|
||
# - aegisone/aegisone-php (публичная часть)
|
||
# - aegisone/aegisone-py (сервисная часть)
|
||
# - aegisone/infra (конфигурации Docker, Nginx, CI/CD)
|
||
# - aegisone/project2 (второй проект)
|
||
# - aegisone/project3 (третий проект)
|
||
```
|
||
|
||
---
|
||
|
||
## 7. Подготовка к переносу AegisOne (PHP)
|
||
|
||
### 7.1. Создание docker-compose.yml
|
||
```bash
|
||
cd /opt/projects/aegisone-php
|
||
nano docker-compose.yml
|
||
```
|
||
|
||
**Содержимое `docker-compose.yml`:**
|
||
```yaml
|
||
version: '3.8'
|
||
|
||
services:
|
||
nginx:
|
||
image: nginx:alpine
|
||
container_name: aegisone-php-nginx
|
||
volumes:
|
||
- ./src:/var/www/html:ro
|
||
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
||
ports:
|
||
- "9080:80"
|
||
depends_on:
|
||
- php
|
||
restart: unless-stopped
|
||
networks:
|
||
- proxy-net
|
||
- aegisone-net
|
||
|
||
php:
|
||
image: php:7.4-fpm
|
||
container_name: aegisone-php-fpm
|
||
volumes:
|
||
- ./src:/var/www/html
|
||
environment:
|
||
- DB_HOST=mysql
|
||
- DB_PORT=3306
|
||
- DB_NAME=j30663893_engineering
|
||
- DB_USER=j30663893_engin
|
||
- DB_PASS=.-SHGWa_
|
||
depends_on:
|
||
- mysql
|
||
restart: unless-stopped
|
||
networks:
|
||
- aegisone-net
|
||
|
||
mysql:
|
||
image: mysql:5.7
|
||
container_name: aegisone-php-mysql
|
||
environment:
|
||
MYSQL_ROOT_PASSWORD: root_password
|
||
MYSQL_DATABASE: j30663893_engineering
|
||
MYSQL_USER: j30663893_engin
|
||
MYSQL_PASSWORD: .-SHGWa_
|
||
volumes:
|
||
- mysql_data:/var/lib/mysql
|
||
- ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
|
||
ports:
|
||
- "3306:3306"
|
||
restart: unless-stopped
|
||
networks:
|
||
- aegisone-net
|
||
|
||
volumes:
|
||
mysql_data:
|
||
|
||
networks:
|
||
proxy-net:
|
||
external: true
|
||
aegisone-net:
|
||
driver: bridge
|
||
```
|
||
|
||
### 7.2. Создание nginx.conf для PHP
|
||
```bash
|
||
nano nginx.conf
|
||
```
|
||
|
||
**Содержимое `nginx.conf`:**
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name localhost;
|
||
root /var/www/html;
|
||
index index.php index.html;
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.php?$query_string;
|
||
}
|
||
|
||
location ~ \.php$ {
|
||
fastcgi_pass php:9000;
|
||
fastcgi_index index.php;
|
||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||
include fastcgi_params;
|
||
}
|
||
|
||
location ~ /\.ht {
|
||
deny all;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 7.3. Перенос файлов с хостинга
|
||
```bash
|
||
# На локальной машине (Windows):
|
||
# 1. Скачать файлы с хостинга через FTP/SFTP
|
||
# 2. Или скопировать из локальной папки проекта
|
||
|
||
# Копирование на VPS:
|
||
scp -r D:\YandexDisk\site_aegisone\* angel@<IP-VPS>:/opt/projects/aegisone-php/src/
|
||
|
||
# На VPS:
|
||
cd /opt/projects/aegisone-php
|
||
# Проверить файлы
|
||
ls -la src/
|
||
```
|
||
|
||
### 7.4. Миграция БД
|
||
```bash
|
||
# Экспорт с хостинга (через phpMyAdmin или mysqldump)
|
||
# mysqldump -u j30663893_engin -p j30663893_engineering > backup.sql
|
||
|
||
# Копирование на VPS
|
||
scp backup.sql angel@<IP-VPS>:/opt/projects/aegisone-php/
|
||
|
||
# На VPS:
|
||
cd /opt/projects/aegisone-php
|
||
cp backup.sql init.sql
|
||
|
||
# Запуск контейнеров
|
||
docker compose up -d
|
||
|
||
# Проверка
|
||
docker compose ps
|
||
docker compose logs -f
|
||
```
|
||
|
||
### 7.5. Настройка Nginx для aegisone.ru
|
||
```bash
|
||
# Файл уже создан в шаге 5.6 (conf.d/aegisone.conf)
|
||
# Перезапустить Nginx
|
||
cd /opt/projects/nginx-proxy
|
||
docker compose restart nginx
|
||
```
|
||
|
||
### 7.6. Проверка работоспособности
|
||
1. Открыть `https://aegisone.ru`
|
||
2. Проверить все страницы: главная, услуги, блог, контакты
|
||
3. Проверить форму обратной связи
|
||
4. Проверить карусель, FAQ, переключение темы
|
||
5. Проверить Яндекс.Карту
|
||
|
||
---
|
||
|
||
## 8. Подготовка Python-админки (FastAPI)
|
||
|
||
### 8.1. Создание структуры проекта
|
||
```bash
|
||
cd /opt/projects/aegisone-py
|
||
mkdir -p app/{api,models,schemas,services,tasks,templates,static/{css,js,img},utils}
|
||
mkdir -p migrations
|
||
touch app/__init__.py app/main.py app/config.py app/database.py
|
||
touch requirements.txt Dockerfile docker-compose.yml alembic.ini
|
||
```
|
||
|
||
### 8.2. requirements.txt
|
||
```bash
|
||
nano requirements.txt
|
||
```
|
||
|
||
**Содержимое `requirements.txt`:**
|
||
```
|
||
fastapi==0.104.1
|
||
uvicorn[standard]==0.24.0
|
||
sqlalchemy==2.0.23
|
||
alembic==1.13.0
|
||
psycopg2-binary==2.9.9
|
||
python-jose[cryptography]==3.3.0
|
||
passlib[bcrypt]==1.7.4
|
||
python-multipart==0.0.6
|
||
jinja2==3.1.2
|
||
celery==5.3.4
|
||
redis==5.0.1
|
||
weasyprint==60.1
|
||
openpyxl==3.1.2
|
||
yandex-disk==3.1.1
|
||
pydantic==2.5.2
|
||
pydantic-settings==2.1.0
|
||
httpx==0.25.2
|
||
```
|
||
|
||
### 8.3. Dockerfile
|
||
```bash
|
||
nano Dockerfile
|
||
```
|
||
|
||
**Содержимое `Dockerfile`:**
|
||
```dockerfile
|
||
FROM python:3.11-slim
|
||
|
||
WORKDIR /app
|
||
|
||
# Установка системных зависимостей
|
||
RUN apt-get update && apt-get install -y \
|
||
gcc \
|
||
libpq-dev \
|
||
&& rm -rf /var/lib/apt/lists/*
|
||
|
||
# Копирование requirements и установка Python-зависимостей
|
||
COPY requirements.txt .
|
||
RUN pip install --no-cache-dir -r requirements.txt
|
||
|
||
# Копирование исходного кода
|
||
COPY . .
|
||
|
||
# Запуск приложения
|
||
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
|
||
```
|
||
|
||
### 8.4. docker-compose.yml
|
||
```bash
|
||
nano docker-compose.yml
|
||
```
|
||
|
||
**Содержимое `docker-compose.yml`:**
|
||
```yaml
|
||
version: '3.8'
|
||
|
||
services:
|
||
app:
|
||
build: .
|
||
container_name: aegisone-py-app
|
||
ports:
|
||
- "8000:8000"
|
||
environment:
|
||
- DATABASE_URL=postgresql://aegisone:aegisone_password@db:5432/aegisone
|
||
- REDIS_URL=redis://redis:6379/0
|
||
- SECRET_KEY=your-secret-key-change-in-production
|
||
- ALGORITHM=HS256
|
||
- ACCESS_TOKEN_EXPIRE_MINUTES=60
|
||
volumes:
|
||
- ./app:/app/app
|
||
depends_on:
|
||
- db
|
||
- redis
|
||
restart: unless-stopped
|
||
networks:
|
||
- proxy-net
|
||
- aegisone-py-net
|
||
|
||
worker:
|
||
build: .
|
||
container_name: aegisone-py-worker
|
||
command: celery -A app.tasks worker --loglevel=info
|
||
environment:
|
||
- DATABASE_URL=postgresql://aegisone:aegisone_password@db:5432/aegisone
|
||
- REDIS_URL=redis://redis:6379/0
|
||
volumes:
|
||
- ./app:/app/app
|
||
depends_on:
|
||
- db
|
||
- redis
|
||
restart: unless-stopped
|
||
networks:
|
||
- aegisone-py-net
|
||
|
||
db:
|
||
image: postgres:15-alpine
|
||
container_name: aegisone-py-db
|
||
environment:
|
||
- POSTGRES_USER=aegisone
|
||
- POSTGRES_PASSWORD=aegisone_password
|
||
- POSTGRES_DB=aegisone
|
||
volumes:
|
||
- postgres_data:/var/lib/postgresql/data
|
||
ports:
|
||
- "5432:5432"
|
||
restart: unless-stopped
|
||
networks:
|
||
- aegisone-py-net
|
||
|
||
redis:
|
||
image: redis:7-alpine
|
||
container_name: aegisone-py-redis
|
||
ports:
|
||
- "6379:6379"
|
||
restart: unless-stopped
|
||
networks:
|
||
- aegisone-py-net
|
||
|
||
volumes:
|
||
postgres_data:
|
||
|
||
networks:
|
||
proxy-net:
|
||
external: true
|
||
aegisone-py-net:
|
||
driver: bridge
|
||
```
|
||
|
||
### 8.5. Базовый app/main.py
|
||
```bash
|
||
nano app/main.py
|
||
```
|
||
|
||
**Содержимое `app/main.py`:**
|
||
```python
|
||
from fastapi import FastAPI, Request
|
||
from fastapi.templating import Jinja2Templates
|
||
from fastapi.staticfiles import StaticFiles
|
||
from fastapi.responses import HTMLResponse
|
||
|
||
app = FastAPI(title="AegisOne Engineering - Admin Panel")
|
||
|
||
# Подключение шаблонов и статики
|
||
templates = Jinja2Templates(directory="app/templates")
|
||
app.mount("/static", StaticFiles(directory="app/static"), name="static")
|
||
|
||
@app.get("/", response_class=HTMLResponse)
|
||
async def root(request: Request):
|
||
return templates.TemplateResponse("index.html", {"request": request})
|
||
|
||
@app.get("/health")
|
||
async def health_check():
|
||
return {"status": "ok"}
|
||
```
|
||
|
||
### 8.6. Запуск Python-админки
|
||
```bash
|
||
cd /opt/projects/aegisone-py
|
||
docker compose up -d --build
|
||
|
||
# Проверить
|
||
docker compose ps
|
||
docker compose logs -f app
|
||
```
|
||
|
||
### 8.7. Настройка Nginx для service.aegisone.ru
|
||
```bash
|
||
# Файл уже создан в шаге 5.7 (conf.d/service-aegisone.conf)
|
||
# Перезапустить Nginx
|
||
cd /opt/projects/nginx-proxy
|
||
docker compose restart nginx
|
||
```
|
||
|
||
---
|
||
|
||
## 9. CI/CD с Gitea Actions
|
||
|
||
### 9.1. Включение Gitea Actions
|
||
1. Открыть `https://git.aegisone.ru`
|
||
2. Зайти в **Site Administration** → **Configuration**
|
||
3. Включить **Actions** (Enable Gitea Actions)
|
||
4. Сохранить настройки
|
||
|
||
### 9.2. Создание workflow для aegisone-py
|
||
```bash
|
||
# На локальной машине:
|
||
cd D:\YandexDisk\site_aegisone
|
||
mkdir -p .gitea/workflows
|
||
nano .gitea/workflows/deploy.yml
|
||
```
|
||
|
||
**Содержимое `.gitea/workflows/deploy.yml`:**
|
||
```yaml
|
||
name: Deploy AegisOne Python
|
||
|
||
on:
|
||
push:
|
||
branches: [main]
|
||
|
||
jobs:
|
||
deploy:
|
||
runs-on: ubuntu-latest
|
||
steps:
|
||
- name: Checkout code
|
||
uses: actions/checkout@v4
|
||
|
||
- name: Build Docker image
|
||
run: |
|
||
docker build -t aegisone-py:latest .
|
||
|
||
- name: Deploy to VPS
|
||
uses: appleboy/ssh-action@v1.0.0
|
||
with:
|
||
host: ${{ secrets.VPS_HOST }}
|
||
username: ${{ secrets.VPS_USER }}
|
||
key: ${{ secrets.VPS_SSH_KEY }}
|
||
script: |
|
||
cd /opt/projects/aegisone-py
|
||
docker compose down
|
||
docker compose up -d --build
|
||
docker system prune -f
|
||
```
|
||
|
||
### 9.3. Настройка секретов в Gitea
|
||
1. Открыть репозиторий `aegisone/aegisone-py`
|
||
2. **Settings** → **Secrets**
|
||
3. Добавить секреты:
|
||
- `VPS_HOST`: IP-адрес VPS
|
||
- `VPS_USER`: `angel` (или ваш пользователь)
|
||
- `VPS_SSH_KEY`: Приватный SSH-ключ для подключения
|
||
|
||
### 9.4. Настройка SSH-ключей для CI/CD
|
||
```bash
|
||
# На VPS:
|
||
# Создать SSH-ключ для Gitea Actions
|
||
ssh-keygen -t ed25519 -C "gitea-actions" -f /home/angel/.ssh/gitea_actions -N ""
|
||
|
||
# Добавить публичный ключ в authorized_keys
|
||
cat /home/angel/.ssh/gitea_actions.pub >> /home/angel/.ssh/authorized_keys
|
||
|
||
# Скопировать приватный ключ для добавления в секреты Gitea
|
||
cat /home/angel/.ssh/gitea_actions
|
||
```
|
||
|
||
### 9.5. Тестирование CI/CD
|
||
1. Закоммитить изменения в `main`
|
||
2. Открыть репозиторий → **Actions**
|
||
3. Проверить выполнение workflow
|
||
4. Убедиться, что деплой прошел успешно
|
||
|
||
---
|
||
|
||
## 10. Бэкапы и мониторинг
|
||
|
||
### 10.1. Настройка бэкапов PostgreSQL
|
||
```bash
|
||
# Создать скрипт бэкапа
|
||
nano /opt/projects/backups/backup-postgres.sh
|
||
```
|
||
|
||
**Содержимое `backup-postgres.sh`:**
|
||
```bash
|
||
#!/bin/bash
|
||
BACKUP_DIR="/opt/projects/backups/postgres"
|
||
DATE=$(date +%Y%m%d_%H%M%S)
|
||
DB_NAME="aegisone"
|
||
DB_USER="aegisone"
|
||
DB_PASSWORD="aegisone_password"
|
||
|
||
# Создать директорию
|
||
mkdir -p $BACKUP_DIR
|
||
|
||
# Создать бэкап
|
||
PGPASSWORD=$DB_PASSWORD pg_dump -h localhost -U $DB_USER $DB_NAME | gzip > $BACKUP_DIR/${DB_NAME}_${DATE}.sql.gz
|
||
|
||
# Удалить старые бэкапы (старше 30 дней)
|
||
find $BACKUP_DIR -name "*.sql.gz" -mtime +30 -delete
|
||
|
||
echo "Backup created: ${DB_NAME}_${DATE}.sql.gz"
|
||
```
|
||
|
||
**Сделать скрипт исполняемым:**
|
||
```bash
|
||
chmod +x /opt/projects/backups/backup-postgres.sh
|
||
```
|
||
|
||
### 10.2. Настройка cron для автоматических бэкапов
|
||
```bash
|
||
# Открыть crontab
|
||
crontab -e
|
||
|
||
# Добавить задачу (бэкап каждый день в 3:00)
|
||
0 3 * * * /opt/projects/backups/backup-postgres.sh >> /opt/projects/backups/backup.log 2>&1
|
||
```
|
||
|
||
### 10.3. Бэкап MySQL (для PHP-части)
|
||
```bash
|
||
nano /opt/projects/backups/backup-mysql.sh
|
||
```
|
||
|
||
**Содержимое `backup-mysql.sh`:**
|
||
```bash
|
||
#!/bin/bash
|
||
BACKUP_DIR="/opt/projects/backups/mysql"
|
||
DATE=$(date +%Y%m%d_%H%M%S)
|
||
DB_NAME="j30663893_engineering"
|
||
DB_USER="j30663893_engin"
|
||
DB_PASSWORD=".-SHGWa_"
|
||
|
||
mkdir -p $BACKUP_DIR
|
||
|
||
docker exec aegisone-php-mysql mysqldump -u $DB_USER -p$DB_PASSWORD $DB_NAME | gzip > $BACKUP_DIR/${DB_NAME}_${DATE}.sql.gz
|
||
|
||
find $BACKUP_DIR -name "*.sql.gz" -mtime +30 -delete
|
||
|
||
echo "MySQL backup created: ${DB_NAME}_${DATE}.sql.gz"
|
||
```
|
||
|
||
**Сделать исполняемым и добавить в cron:**
|
||
```bash
|
||
chmod +x /opt/projects/backups/backup-mysql.sh
|
||
crontab -e
|
||
# Добавить: 30 3 * * * /opt/projects/backups/backup-mysql.sh >> /opt/projects/backups/backup.log 2>&1
|
||
```
|
||
|
||
### 10.4. Мониторинг с Uptime Kuma (опционально)
|
||
```bash
|
||
cd /opt/projects
|
||
mkdir -p uptime-kuma
|
||
cd uptime-kuma
|
||
nano docker-compose.yml
|
||
```
|
||
|
||
**Содержимое `docker-compose.yml`:**
|
||
```yaml
|
||
version: '3.8'
|
||
|
||
services:
|
||
uptime-kuma:
|
||
image: louislam/uptime-kuma:latest
|
||
container_name: uptime-kuma
|
||
ports:
|
||
- "3001:3001"
|
||
volumes:
|
||
- ./data:/app/data
|
||
restart: unless-stopped
|
||
networks:
|
||
- proxy-net
|
||
|
||
networks:
|
||
proxy-net:
|
||
external: true
|
||
```
|
||
|
||
**Запуск:**
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
**Настройка Nginx для Uptime Kuma:**
|
||
```bash
|
||
nano /opt/projects/nginx-proxy/conf.d/uptime.conf
|
||
```
|
||
|
||
**Содержимое `conf.d/uptime.conf`:**
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name monitor.aegisone.ru;
|
||
return 301 https://monitor.aegisone.ru$request_uri;
|
||
}
|
||
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name monitor.aegisone.ru;
|
||
|
||
ssl_certificate /etc/nginx/certs/live/aegisone.ru/fullchain.pem;
|
||
ssl_certificate_key /etc/nginx/certs/live/aegisone.ru/privkey.pem;
|
||
|
||
location / {
|
||
proxy_pass http://uptime-kuma:3001;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 11. Чек-лист завершения
|
||
|
||
### Этап 1: Базовая настройка
|
||
- [ ] Подключение к VPS по SSH
|
||
- [ ] Создание пользователя без root
|
||
- [ ] Настройка SSH-ключей
|
||
- [ ] Обновление системы
|
||
- [ ] Настройка фаервола (UFW)
|
||
- [ ] Настройка Fail2Ban
|
||
- [ ] Настройка часового пояса
|
||
- [ ] Настройка swap-файла
|
||
|
||
### Этап 2: Docker
|
||
- [ ] Установка Docker и Docker Compose
|
||
- [ ] Настройка пользователя для Docker (без sudo)
|
||
- [ ] Создание общей сети `proxy-net`
|
||
- [ ] Проверка `docker run hello-world`
|
||
|
||
### Этап 3: Nginx + SSL
|
||
- [ ] Создание структуры `/opt/projects/nginx-proxy/`
|
||
- [ ] Настройка `docker-compose.yml` для Nginx
|
||
- [ ] Создание `nginx.conf`
|
||
- [ ] Запуск Nginx
|
||
- [ ] Получение SSL-сертификатов Let's Encrypt
|
||
- [ ] Создание конфигов для доменов (aegisone.ru, service.aegisone.ru, git.aegisone.ru)
|
||
- [ ] Проверка HTTPS для всех доменов
|
||
|
||
### Этап 4: Gitea
|
||
- [ ] Создание структуры `/opt/projects/gitea/`
|
||
- [ ] Настройка `docker-compose.yml` для Gitea
|
||
- [ ] Запуск Gitea
|
||
- [ ] Настройка Nginx для git.aegisone.ru
|
||
- [ ] Первоначальная настройка Gitea (регистрация админа)
|
||
- [ ] Включение Gitea Actions
|
||
- [ ] Создание репозиториев
|
||
- [ ] Настройка SSH-ключей для CI/CD
|
||
|
||
### Этап 5: AegisOne PHP
|
||
- [ ] Создание структуры `/opt/projects/aegisone-php/`
|
||
- [ ] Настройка `docker-compose.yml`
|
||
- [ ] Перенос файлов с хостинга
|
||
- [ ] Миграция БД
|
||
- [ ] Запуск контейнеров
|
||
- [ ] Настройка Nginx для aegisone.ru
|
||
- [ ] Проверка работоспособности сайта
|
||
|
||
### Этап 6: AegisOne Python
|
||
- [ ] Создание структуры `/opt/projects/aegisone-py/`
|
||
- [ ] Настройка `Dockerfile` и `docker-compose.yml`
|
||
- [ ] Создание базового FastAPI приложения
|
||
- [ ] Запуск контейнеров
|
||
- [ ] Настройка Nginx для service.aegisone.ru
|
||
- [ ] Проверка работоспособности API
|
||
|
||
### Этап 7: CI/CD
|
||
- [ ] Создание workflow `.gitea/workflows/deploy.yml`
|
||
- [ ] Настройка секретов в Gitea
|
||
- [ ] Тестирование деплоя
|
||
- [ ] Настройка rollback
|
||
|
||
### Этап 8: Бэкапы и мониторинг
|
||
- [ ] Настройка бэкапов PostgreSQL
|
||
- [ ] Настройка бэкапов MySQL
|
||
- [ ] Настройка cron для автоматических бэкапов
|
||
- [ ] (Опционально) Установка Uptime Kuma
|
||
- [ ] Настройка алертов
|
||
|
||
### Этап 9: Финальная проверка
|
||
- [ ] Все домены работают по HTTPS
|
||
- [ ] PHP-часть (aegisone.ru) работает
|
||
- [ ] Python-часть (service.aegisone.ru) работает
|
||
- [ ] Gitea (git.aegisone.ru) работает
|
||
- [ ] CI/CD деплой работает
|
||
- [ ] Бэкапы создаются автоматически
|
||
- [ ] Мониторинг настроен
|
||
|
||
---
|
||
|
||
## Полезные команды
|
||
|
||
### Управление Docker
|
||
```bash
|
||
# Посмотреть запущенные контейнеры
|
||
docker ps
|
||
|
||
# Посмотреть все контейнеры (включая остановленные)
|
||
docker ps -a
|
||
|
||
# Посмотреть логи контейнера
|
||
docker logs -f <container_name>
|
||
|
||
# Остановить контейнер
|
||
docker stop <container_name>
|
||
|
||
# Запустить контейнер
|
||
docker start <container_name>
|
||
|
||
# Перезапустить контейнер
|
||
docker restart <container_name>
|
||
|
||
# Удалить контейнер
|
||
docker rm <container_name>
|
||
|
||
# Посмотреть использование ресурсов
|
||
docker stats
|
||
|
||
# Очистить неиспользуемые ресурсы
|
||
docker system prune -f
|
||
```
|
||
|
||
### Управление Docker Compose
|
||
```bash
|
||
# Запустить все сервисы
|
||
docker compose up -d
|
||
|
||
# Остановить все сервисы
|
||
docker compose down
|
||
|
||
# Перезапустить все сервисы
|
||
docker compose restart
|
||
|
||
# Посмотреть логи
|
||
docker compose logs -f
|
||
|
||
# Посмотреть статус
|
||
docker compose ps
|
||
|
||
# Пересобрать и запустить
|
||
docker compose up -d --build
|
||
```
|
||
|
||
### Управление Nginx
|
||
```bash
|
||
# Проверить конфиг
|
||
docker compose exec nginx nginx -t
|
||
|
||
# Перезагрузить конфиг
|
||
docker compose exec nginx nginx -s reload
|
||
|
||
# Посмотреть логи
|
||
docker compose logs -f nginx
|
||
```
|
||
|
||
### Управление Gitea
|
||
```bash
|
||
# Посмотреть логи
|
||
docker compose logs -f gitea
|
||
|
||
# Перезапустить
|
||
docker compose restart gitea
|
||
```
|
||
|
||
### Системные команды
|
||
```bash
|
||
# Посмотреть использование диска
|
||
df -h
|
||
|
||
# Посмотреть использование памяти
|
||
free -h
|
||
|
||
# Посмотреть загрузку CPU
|
||
htop
|
||
|
||
# Посмотреть логи системы
|
||
journalctl -f
|
||
|
||
# Посмотреть открытые порты
|
||
sudo ss -tulpn
|
||
```
|
||
|
||
---
|
||
|
||
## Контакты и поддержка
|
||
|
||
**Документ создан:** 2026-05-17
|
||
**Версия:** 1.0
|
||
**Автор:** AI-ассистент + Владелец
|
||
**Статус:** Готов к выполнению
|
||
|
||
> **Важно:** Если при выполнении возникнут вопросы — лучше уточнить, чем переделывать потом.
|
||
> **Примечание:** Все пароли и ключи в примерах являются демонстрационными. Замените их на реальные перед использованием в продакшене.
|