Як розгорнути Ghost v0.11 LTS на Debian 8

Ghost — це платформа для ведення блогів з відкритим кодом, яка набирає популярності серед розробників і звичайних користувачів з моменту її випуску в 2013 році. Він акцентує увагу на контенті та веденні блогів. Найпривабливішим у Ghost є його простий, чистий та чуйний дизайн. Ви можете писати свої дописи в блозі з мобільного телефону. Вміст для Ghost написаний мовою Markdown. Ghost ідеально підходить для окремих осіб або невеликих груп письменників.

У цьому посібнику ми збираємося налаштувати та розгорнути безпечний блог Ghost v0.11.x LTS на Debian 8 VPS за допомогою Let's Encrypt , Certbot , Node.js , NPM , NGINX та MySQL .

Вимоги

• Зареєструвати (придбати) доменне ім'я.
• Серверний екземпляр Debian 8 з мінімум 1 ГБ оперативної пам'яті .
• Користувач Sudo.

Перед тим як ти почнеш

1. Перевірте версію Debian:

   lsb_release -ds
   # Debian GNU/Linux 8.9 (jessie)
   

2. Створіть новий обліковий запис користувача без права root :

   adduser johndoe --gecos "John Doe"
   

3. Зробіть його суперкористувачем, додавши його до sudoгрупи:

   usermod -aG sudo johndoe
   

4. Перейти до нового користувача:

   su - johndoe
   

5. Оновіть програмне забезпечення операційної системи:

   sudo apt-get update && sudo apt-get upgrade -y
   

6. Налаштуйте часовий пояс:

   sudo dpkg-reconfigure tzdata
   

7. Встановіть необхідні інструменти:

   sudo apt-get install -y build-essential zip unzip git apt-transport-https
   

8. Перезавантажте систему, якщо потрібно:

   sudo shutdown -r now
   

Встановіть Certbot

NOTE: Before starting this step, ensure that you have set DNS records for your domain.

Ми збираємося використовувати Let's Encrypt CA і клієнт Certbot EFF , щоб отримати сертифікат SSL/TLS для нашого блогу Ghost. Не забудьте замінити всі екземпляри на blog.domain.tldім’я вашого домену.

1. Встановіть програмне забезпечення для керування сертифікатами Certbot (раніше Let's Encrypt client ), створене за допомогою Python:

   sudo -s
   printf "deb http://ftp.debian.org/debian jessie-backports main" >> /etc/apt/sources.list.d/jessie-backports.list
   exit        
   sudo apt-get update
   sudo apt-get install -y certbot -t jessie-backports
   

2. Перевірте версію Certbot:

   certbot --version
   # certbot 0.10.2
   

3. Отримати сертифікат RSA за допомогою окремого методу аутентифікації (плагін):

   sudo certbot certonly --standalone --domains blog.domain.tld --rsa-key-size 2048 --must-staple --email [email protected] --agree-tos
   
   # IMPORTANT NOTES:
   #  - Congratulations! Your certificate and chain have been saved at 
   /etc/letsencrypt/live/blog.domain.tld/fullchain.pem. 
   #  Your cert will expire on YYYY-MM-DD. . . .
   #  . . .
   

   Після виконання попередніх кроків ваш сертифікат і закритий ключ будуть у /etc/letsencrypt/live/blog.domain.tldкаталозі.

Встановіть Node.js і NPM

NOTE: Ghost currently supports Node.js versions 4.5+ and 6.9+ only.

Ghost побудовано на Node.js. Ми збираємося встановити рекомендовану версію для Ghost, яка є v6 Boron LTSна момент написання цієї статті.

1. Завантажте та встановіть Node.js v6 LTS:

   curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

2. Перевірте версію Node.js і NPM:

   node -v && npm -v
   # v6.11.2
   # 3.10.10
   

Встановіть MySQL

За замовчуванням Ghost налаштований на використання бази даних SQLite, яка не потребує налаштування.

Крім того, Ghost також можна використовувати з базою даних MySQL, змінивши конфігурацію бази даних. Спочатку потрібно створити базу даних і користувача, а потім змінити існуючу конфігурацію sqlite3.

1. Завантажте та встановіть MySQL:

   sudo apt-get install -y mysql-server
   

   NOTE: During the installation, you will be prompted for MySQL "root" user password. You should set a secure password for the MySQL "root" user.

2. Перевірте версію MySQL:

   mysql --version
   # mysql  Ver 14.14 Distrib 5.5.57, for debian-linux-gnu (x86_64) using readline 6.3
   

3. Перевірте, чи запущено та працює демон MySQL:

   sudo systemctl status mysql.service
   sudo systemctl is-enabled mysql.service
   

4. Запустіть mysql_secure_installationсценарій, щоб трохи захистити свою базу даних:

   sudo mysql_secure_installation
   

5. Увійдіть в MySQL як користувач root:

   mysql -u root -p
   # Enter password:
   

6. Створіть нову базу даних MySQL і користувача:

   create database dbname;
   grant all on dbname.* to 'user' identified by 'password';
   

7. Вийти з MySQL:

   exit
   

Встановіть NGINX

1. Завантажте та встановіть останню основну версію NGINX з офіційного репозиторію NGINX:

   wget https://nginx.org/keys/nginx_signing.key
   sudo apt-key add nginx_signing.key
   rm nginx_signing.key
   sudo -s
   printf "deb https://nginx.org/packages/mainline/debian/ `lsb_release -sc` nginx \ndeb-src https://nginx.org/packages/mainline/debian/ `lsb_release -sc` nginx \n" >> /etc/apt/sources.list.d/nginx_mainline.list
   exit
   sudo apt-get update
   sudo apt-get install -y nginx nginx-module-geoip nginx-module-image-filter nginx-module-njs nginx-module-perl nginx-module-xslt nginx-nr-agent
   

2. Переконайтеся, що він встановлений, перевіривши версію NGINX:

   sudo nginx -v
   # nginx version: nginx/1.13.4
   

3. Перевірте статус, увімкніть і запустіть службу NGINX (демон):

   sudo systemctl status nginx.service # inactive (dead)
   sudo systemctl enable nginx.service
   sudo systemctl start nginx.service
   

4. Створіть /etc/nginx/sslкаталог і згенеруйте нову групу Діффі-Хеллмана ( DH ):

   sudo mkdir -p /etc/nginx/ssl
   sudo openssl dhparam -out /etc/nginx/ssl/dhparams-2048.pem 2048
   

5. Створити каталог журналів для blog.domain.tldвіртуального хоста:

   sudo mkdir -p /var/log/nginx/blog.domain.tld
   

6. Налаштуйте NGINX як зворотний проксі-сервер HTTP ( S ):

   sudo vim /etc/nginx/conf.d/ghost.conf
   

7. Вставте наступне в /etc/nginx/conf.d/ghost.conf:

   # domain: blog.domain.tld
   # public: /var/www/ghost
   
   upstream ghost_app {
       server 127.0.0.1:2368;
       keepalive 32;
   }
   
   server {
       listen [::]:80 default_server;
       listen 80 default_server;
       listen [::]:443 ssl http2 default_server;
       listen 443 ssl http2 default_server;
   
       server_name blog.domain.tld; # Change to your domain/hostname
       root /var/www/ghost; # Change to the path where Ghost is
   
       error_log /var/log/nginx/blog.domain.tld/error.log;
       access_log /var/log/nginx/blog.domain.tld/access.log;
   
       client_max_body_size 100M;
   
       ssl_certificate /etc/letsencrypt/live/blog.domain.tld/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/blog.domain.tld/privkey.pem;
       ssl_dhparam ssl/dhparams-2048.pem;
   
       ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
       ssl_ciphers 'ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS';
       ssl_prefer_server_ciphers on;
   
       ssl_buffer_size 4K;
   
       ssl_session_timeout 1d;
       ssl_session_cache shared:SSL:50M;
       ssl_session_tickets off;
   
       ssl_stapling on;
       ssl_stapling_verify on;
       ssl_trusted_certificate /etc/letsencrypt/live/blog.domain.tld/chain.pem;
   
       resolver 8.8.8.8 8.8.4.4 valid=300s;
   
       location / {
           proxy_pass http://ghost_app;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header Host $http_host;
           proxy_set_header X-Forwarded-Proto $scheme;
           proxy_hide_header X-Powered-By;
   
           proxy_http_version 1.1;
           proxy_set_header Connection "";
   
       }
   }
   

8. Збережіть та перевірте конфігурацію NGINX на наявність синтаксичних помилок:

   sudo nginx -t
   

9. Перезавантажте конфігурацію NGINX:

   sudo systemctl reload nginx.service
   

Встановіть Ghost

NOTE: If you want to host multiple Ghost blogs on same VPS, each Ghost instance must be running on a separate port.

1. Створіть кореневий каталог документа:

   sudo mkdir -p /var/www/
   

2. Створити нового ghostкористувача:

   sudo adduser --shell /bin/bash --gecos 'Ghost application' --disabled-password ghost
   

3. Завантажити Ghost:

   curl -L https://github.com/TryGhost/Ghost/releases/download/0.11.11/Ghost-0.11.11.zip -o ghost.zip
   

4. Розпакуйте Ghost в /var/www/ghostкаталог (рекомендоване місце для встановлення):

   sudo unzip -uo ghost.zip -d /var/www/ghost
   rm ghost.zip
   

5. Перейдіть до нового ghostкаталогу:

   cd /var/www/ghost
   

6. Змінити власника /var/www/ghostкаталогу:

   sudo chown -R ghost:ghost .
   

7. Перейти до нового ghostкористувача:

   sudo su - ghost
   

8. Перейдіть до кореня документа /var/www/ghost:

   cd /var/www/ghost
   

9. Встановіть Ghost лише з виробничими залежностями. Коли це завершиться, Ghost буде встановлено:

   npm install --production
   

10. Налаштуйте Ghost, змінивши url, mailі databaseвластивість виробничого об’єкта всередині config.jsфайлу:

    cp config.example.js config.js
    vim /var/www/ghost/config.js
    
    
    var path = require('path'),
        config;
    
    config = {
    // ### Production
    // When running Ghost in the wild, use the production environment.
    // Configure your URL and mail settings here
    production: {
        url: 'https://blog.domain.tld',
        mail: {
            transport: 'SMTP',
            options: {
                service: 'Mailgun',
                auth: {
                    user: '',
                    pass: ''
                }
            }
        },
        database: {
            client: 'mysql',
            connection: {
                host: '127.0.0.1',
                user: 'your_database_user',
                password: 'your_database_password',
                database: 'your_database_name',
                charset: 'utf8'
            },
            debug: false
        },
        // . . .
        // . . .
    

    NOTE: You should configure mail settings also. Consult the official Ghost documentation on how to do that.

11. Запустіть Ghost у виробничому середовищі:

    npm start --production
    

    Тепер привид буде бігати. І інтерфейс блогу, і інтерфейс адміністратора захищені HTTPS, а також працює HTTP/2 . Ви можете відкрити свій браузер і відвідати сайт за адресою https://blog.domain.tld. Не забудьте замінити blog.domain.tldна своє доменне ім’я.

12. Завершіть процес Ghost, натиснувши CTRL+, Cі вийдіть із ghostкористувача назад до користувача root:

    exit
    

Запуск Ghost як системної служби

Якщо ви закриєте термінальний сеанс за допомогою VPS, ваш блог також зникне. Це не добре. Щоб уникнути цього, ми збираємося використовувати Systemd. Завдяки цьому наш блог буде працювати цілодобово.

1. Створіть ghost.serviceфайл модуля Systemd. Запустіть sudo vim /etc/systemd/system/ghost.serviceта скопіюйте/вставте такий вміст:

   [Unit]
   Description=Ghost - the professional publishing platform
   Documentation=https://docs.ghost.org/v0.11.11/docs
   After=network.target
   
   [Service]
   Type=simple
   # Edit WorkingDirectory, User and Group as needed
   WorkingDirectory=/var/www/ghost
   User=ghost
   Group=ghost
   ExecStart=/usr/bin/npm start --production
   ExecStop=/usr/bin/npm stop --production
   Restart=always
   SyslogIdentifier=Ghost
   
   [Install]
   WantedBy=multi-user.target
   

2. Увімкніть і запустіть ghost.service:

   sudo systemctl enable ghost.service && sudo systemctl start ghost.service
   

3. Перевірити ghost.serviceстатус:

   sudo systemctl status ghost.service && sudo systemctl is-enabled ghost.service
   

4. Перейдіть до https://blog.domain.tld/ghost/та створіть користувача адміністратора Ghost. Зробіть це якомога швидше!

Висновок

Це воно. Тепер у нас є повністю функціональний блог Ghost. Ваш сервер доставляє вміст через HTTP/2, якщо він підтримується клієнтом. Якщо ви хочете змінити тему Ghost за замовчуванням під назвою Casper на спеціальну, ви можете просто завантажити та розпакувати тему в /var/www/ghost/content/themesпапку та вибрати її через інтерфейс адміністратора Ghost, розташований за адресою https://blog.domain.tld/ghost.