====== Полное руководство по развертыванию Wiki.js с HTTPS через Nginx (самоподписанные сертификаты) ======

===== 1. Подготовка сервера =====

==== 1.1. Обновление системы ====
<code>
sudo apt update && sudo apt dist-upgrade -y
sudo reboot
</code>

==== 1.2. Установка зависимостей ====
<code>
sudo apt install -y docker docker-compose nginx openssl
</code>
===== 2. Настройка Wiki.js =====

==== 2.1. Создание секрета для БД ====
<code>
sudo mkdir -p /etc/wiki
sudo openssl rand -base64 32 > /etc/wiki/.db-secret
sudo chmod 600 /etc/wiki/.db-secret
</code>
==== 2.2. Создание Docker-сети и тома ====
<code>
docker network create wikinet
docker volume create pgdata
</code>
==== 2.3. Запуск контейнеров Wiki.js ====
<code>
docker run -d --name=db \
 -e POSTGRES_DB=wiki \
 -e POSTGRES_USER=wiki \
 -e POSTGRES_PASSWORD_FILE=/etc/wiki/.db-secret \
 -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro \
 -v pgdata:/var/lib/postgresql/data \
 --restart=unless-stopped \
 --network=wikinet \
 postgres:17-alpine
</code>
<code>
docker run -d --name=wiki \
 -e DB_TYPE=postgres \
 -e DB_HOST=db \
 -e DB_PORT=5432 \
 -e DB_PASS_FILE=/etc/wiki/.db-secret \
 -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro \
 -e DB_USER=wiki \
 -e DB_NAME=wiki \
 -e UPGRADE_COMPANION=1 \
 --restart=unless-stopped \
 --network=wikinet \
 ghcr.io/requarks/wiki:2
</code>
<code>
docker run -d --name=wiki-update-companion \
 -v /var/run/docker.sock:/var/run/docker.sock:ro \
 --restart=unless-stopped \
 --network=wikinet \
 ghcr.io/requarks/wiki-update-companion:latest
</code>
===== 3. Настройка Nginx + HTTPS =====

==== 3.1. Генерация SSL-сертификатов ====
<code>
sudo mkdir -p /etc/nginx/ssl/wiki.test
</code>
<code>
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
 -keyout /etc/nginx/ssl/wiki.test/key.pem \
 -out /etc/nginx/ssl/wiki.test/cert.pem \
 -subj "/CN=wiki.test" \
 -addext "subjectAltName=DNS:wiki.test"
</code>
<code>
sudo chmod 644 /etc/nginx/ssl/wiki.test/*
</code>
==== 3.2. Создание конфига Nginx ====
<code>
sudo tee /etc/nginx/conf.d/wiki.test.conf << 'EOF'
server {
   listen 80;
   server_name wiki.test;
   return 301 https://$host$request_uri;
}

server {
   listen 443 ssl;
   server_name wiki.test;

   ssl_certificate /etc/nginx/ssl/wiki.test/cert.pem;
   ssl_certificate_key /etc/nginx/ssl/wiki.test/key.pem;

   location / {
       proxy_pass http://wiki: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;
   }
}
EOF
</code>
==== 3.3. Запуск Nginx в Docker ====
<code>
docker run -d --name=nginx-proxy \
 -p 80:80 \
 -p 443:443 \
 -v /etc/nginx/conf.d:/etc/nginx/conf.d \
 -v /etc/nginx/ssl:/etc/nginx/ssl \
 --network=wikinet \
 --restart=unless-stopped \
 nginx:alpine
</code>
===== 4. Проверка работы =====

==== 4.1. Добавление домена в hosts (если нужно) ====
<code>
echo "127.0.0.1 wiki.test" | sudo tee -a /etc/hosts
</code>
==== 4.2. Проверка доступности ====
<code>
curl -vk https://wiki.test
</code>
==== 4.3. Проверка логов ====
<code>
docker logs nginx-proxy
docker logs wiki
</code>
===== 5. Дополнительные настройки =====

==== 5.1. Открытие портов в Firewall (если используется) ====
<code>
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
</code>
==== 5.2. Настройка автоматического обновления сертификатов
 ====
<code>
sudo crontab -e
</code>
Добавить строку:
<code>
@monthly openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/nginx/ssl/wiki.test/key.pem -out /etc/nginx/ssl/wiki.test/cert.pem -subj "/CN=wiki.test" -addext "subjectAltName=DNS:wiki.test" && docker restart nginx-proxy
</code>
===== 7. Готово! =====


----

>Wiki.js теперь доступен по:  
>HTTP: http://wiki.test (автоматически перенаправляет на HTTPS)  
>HTTPS: https://wiki.test

----

>Для доступа с других устройств добавьте запись в их файл `hosts`:
><IP_сервера> wiki.test