Към съдържанието

Деплой на docs.vi-lab.eu върху Apache2

Този документ описва как да хоствате този MkDocs сайт върху Apache2 под домейн docs.vi-lab.eu.

1. Изграждане на статичния сайт

На машината, където е кодът:

cd /path/to/docs.vi-lab.eu   # или корена на zhar, ако mkdocs.yml е там

pip install mkdocs-material mkdocs-minify-plugin mkdocs-git-revision-date-localized-plugin

mkdocs build

Генерираният статичен сайт ще е в директория site/.

2. Копиране към сървъра

На сървъра с Apache2:

sudo mkdir -p /var/www/docs.vi-lab.eu

Прехвърлете съдържанието на site/:

rsync -av site/ user@server:/var/www/docs.vi-lab.eu/

(или локално копиране, ако build-ът се прави директно на сървъра)

3. Apache2 VirtualHost конфигурация

Създайте файл /etc/apache2/sites-available/docs.vi-lab.eu.conf:

<VirtualHost *:80>
    ServerName docs.vi-lab.eu

    DocumentRoot /var/www/docs.vi-lab.eu

    <Directory /var/www/docs.vi-lab.eu>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/docs.vi-lab.eu-error.log
    CustomLog ${APACHE_LOG_DIR}/docs.vi-lab.eu-access.log combined
</VirtualHost>

Активирайте сайта и рестартирайте Apache:

sudo a2ensite docs.vi-lab.eu.conf
sudo systemctl reload apache2

4. DNS настройки

В DNS на домейна vi-lab.eu:

  • Тип: A или CNAME
  • Име: docs
  • Стойност: IP адресът на сървъра (за A) или основен хост (за CNAME)
  • TTL: по подразбиране (напр. 3600)

5. HTTPS (препоръчително)

С Let’s Encrypt:

sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d docs.vi-lab.eu

След успешна конфигурация сайтът ще бъде достъпен на:

https://docs.vi-lab.eu