Logo Neurocoda

Hexo Webhook Auto-Deployment

Neurocoda
Neurocoda
2026-07-03 12:52:13 389 Words 2 Mins ...
Web hexo git webhook docker

Что такое Hexo?

Hexo — это быстрый, простой и эффективный фреймворк для блогов. Hexo использует Markdown (или другие языки разметки) для разбора статей и в течение нескольких секунд генерирует статические веб-страницы с красивыми темами.

Соответствующая среда этой статьи:

  • Сервер с публичным IP
  • Платформа Git для хостинга сайта, сгенерированного Hexo (Github или собственный Git-репозиторий)
  • Локально запущенный Hexo

Если у вас нет сервера с публичным IP, вы можете пропустить раздел Настройка сервера и использовать такие платформы, как Github Pages. Однако раздел Локальная настройка остается тем же.

Схема построения сайта в этой статье:

  • Пишем статьи локально, после чего собираем сайт через hexo и пушим его в репозиторий GitHub с помощью git push. После завершения push’а GitHub отправляет уведомление через webhook на мой публичный сервер, который автоматически клонирует сайт в каталог, обслуживаемый nginx в качестве обратного прокси.

На стороне сервера автоматизация получения webhook-уведомлений и клонирования выполняется с помощью контейнера neurocoda/gitrigger:latest.

Настройка Git-платформы

Создайте репозиторий.

Локальная настройка

Установка Node.js

Инструкции по установке для разных систем: https://hexo.io/zh-cn/docs/

У меня локально Ubuntu:

Согласно: https://github.com/nodesource/distributions

Terminal window
curl -fsSL https://deb.nodesource.com/setup_23.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt-get install -y nodejs

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

Terminal window
node -v

Установка Hexo-cli

Terminal window
npm install -g hexo-cli

Создание репозитория Hexo

Terminal window
hexo init <folder>
cd <folder>
npm install

Настройка Git

Создание SSH-ключа:

Terminal window
ssh-keygen

Получение открытого ключа:

Terminal window
cat /root/.ssh/id_ed25519.pub

Добавьте полученный открытый ключ на выбранную вами Git-платформу

Github: https://github.com/settings/keys

Добавление Git в Hexo

В корневой директории Hexo:

Установка плагина:

Terminal window
npm install hexo-deployer-git --save
Terminal window
vim _config.yml

Найдите внизу и добавьте информацию о репозитории:

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: [email protected]:neurocoda/Hexo.git
  branch: main

Настройка сервера

Настройка брандмауэра

Открытие портов брандмауэра:

Terminal window
ufw allow 22
ufw allow 80
ufw allow 443

Включение и проверка статуса брандмауэра:

Terminal window
ufw enable
ufw status

Установка Nginx, Docker

Обновление источников:

Terminal window
apt update
apt upgrade -y

Установка docker-compose, nginx, python3-certbot-nginx:

Terminal window
apt install docker-compose nginx certbot python3-certbot-nginx

Проверьте, что nginx работает корректно:

Terminal window
systemctl status nginx

Настройка SSH-ключей

Если ваш репозиторий приватный, необходимо настроить SSH-ключи:

Создание SSH-ключа:

Terminal window
ssh-keygen

Получение открытого ключа:

Terminal window
cat /root/.ssh/id_ed25519.pub

Добавьте полученный открытый ключ на выбранную вами Git-платформу

Github: https://github.com/settings/keys

Настройка Webhook

Настройка webhook в репозитории:

Запуск службы

Создание docker-compose.yml:

Terminal window
vim docker-compose.yml

Вставьте следующее содержимое:

version: '3.8'


services:
  hexo:
    image: neurocoda/gitrigger:latest
    container_name: hexo
    restart: unless-stopped
    ports:
      - "127.0.0.1:7890:5000"
    environment:
      REPO_URL: "[email protected]:neurocoda/Hexo.git"
    volumes:
      - /root/.ssh/id_ed25519:/root/.ssh/id_rsa:ro
      - /var/www/sites:/clone_data

Выполните команду up в каталоге с docker-compose.yml:

Terminal window
docker-compose up -d

Просмотр статуса контейнера:

Terminal window
docker ps -a

Статус Up означает, что контейнер работает корректно. (Здесь у меня есть и другие службы, поэтому вид может отличаться.)

Просмотр логов контейнера:

Terminal window
docker logs hexo

Настройка обратного прокси

Редактирование nginx.conf:

Terminal window
vim /etc/nginx/nginx.conf

Добавление обратного прокси:

user www-data;
worker_processes auto;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;


events {
    worker_connections 768;
    # multi_accept on;
}


http {
    ##
    # Basic Settings
    ##
    sendfile on;
    tcp_nopush on;
    types_hash_max_size 2048;
    # server_tokens off;


    # server_names_hash_bucket_size 64;
    # server_name_in_redirect off;


    include /etc/nginx/mime.types;
    default_type application/octet-stream;


    ##
    # My Server
    ##


  server {
      server_name neurocoda.com;


      root /var/www/sites/Hexo;
      index index.html index.htm;


      location / {
          try_files $uri $uri/ =404;
      }


      location ~* \.(?:css|js|jpg|jpeg|png|gif|ico|svg|webp)$ {
          try_files $uri =404;
          expires 30d;
          add_header Cache-Control "public";
      }


      error_page 404 /404.html;
      location = /404.html {
          root /var/www/sites/hexo;
      }
  }


    server {
        listen 80;
        server_name webhook.neurocoda.com;


        location / {
            proxy_pass http://127.0.0.1:7890;
            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;
        }
    }


    ##
    # SSL Settings
    ##
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; # Dropping SSLv3, ref: POODLE
    ssl_prefer_server_ciphers on;


    ##
    # Logging Settings
    ##
    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;


    ##
    # Gzip Settings
    ##
    gzip on;


    # gzip_vary on;
    # gzip_proxied any;
    # gzip_comp_level 6;
    # gzip_buffers 16 8k;
    # gzip_http_version 1.1;
    # gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;


    ##
    # Virtual Host Configs
    ##
    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
}


# mail {
#     # See sample authentication script at:
#     # http://wiki.nginx.org/ImapAuthenticateWithApachePhpScript
#
#     # auth_http localhost/auth.php;
#     # pop3_capabilities "TOP" "USER";
#     # imap_capabilities "IMAP4rev1" "UIDPLUS";
#
#     server {
#         listen     localhost:110;
#         protocol   pop3;
#         proxy      on;
#     }
#
#     server {
#         listen     localhost:143;
#         protocol   imap;
#         proxy      on;
#     }
# }

После изменения конфигурации проверьте синтаксис:

Terminal window
nginx -t

Перезагрузка конфигурации nginx:

Terminal window
systemctl reload nginx

Убедитесь, что DNS-записи настроены правильно:

Настройка SSL

Настройка SSL:

Terminal window
certbot --nginx

Введите запрашиваемую информацию

Проверьте синтаксис nginx.conf после изменений от certbot:

Terminal window
nginx -t

Перезагрузка конфигурации nginx

Terminal window
systemctl reload nginx

Тестирование синхронизации

В локальной директории Hexo:

Terminal window
hexo clean & hexo g & hexo d

После завершения выполнения откройте ваш сервер — с большой вероятностью веб-страница уже отображается.

Часто задаваемые вопросы

Проблемы с правами доступа

Terminal window
chmod 755 /var/www/sites/Hexo
chown -R www-data:www-data /var/www/sites/Hexo
Title: Hexo Webhook Auto-Deployment Author: Neurocoda Created at: 2026-07-03 12:52:13 Link: https://neurocoda.com/ru/posts/hexo-webhook-auto-deployment-ru/ License: This work is licensed under CC BY-ND 4.0.
Comments
← Previous Post Тригонометрические функции и их свойства Next Post → Essence of Derivatives