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

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

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

Вимоги

• Зареєструвати (придбати) доменне ім'я.
• Серверний екземпляр Fedora 25 з мінімум 1 ГБ ОЗП .
• Користувач Sudo.
• Ймовірно, вам доведеться відкрити порт 2368 за допомогою semanage port -a -t http_port_t -p tcp 2368.

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

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

   cat /etc/fedora-release
   # Fedora release 25 (Twenty Five)
   

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

   useradd -c "John Doe" johndoe && passwd johndoe
   

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

   usermod -aG wheel johndoe
   

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

   su - johndoe
   

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

   sudo dnf check-update || sudo dnf upgrade -y
   

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

   timedatectl list-timezones
   sudo timedatectl set-timezone 'Region/City'
   

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

   sudo dnf install @development-tools -y
   

8. Встановіть текстовий редактор Vim і Wget:

   sudo dnf install -y vim wget
   

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

   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 dnf install -y certbot
   

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

   certbot --version
   # certbot 0.14.1
   

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

   sudo certbot certonly --standalone --domains blog.domain.tld --rsa-key-size 2048 --must-staple --email [email protected] --no-eff-email --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 --silent --location https://rpm.nodesource.com/setup_6.x | sudo bash -
   sudo dnf 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 (наразі 5.7 ) з офіційного репозиторію MySQL Dnf:

   cd /tmp
   
   # Adding the MySQL dnf Repository
   wget https://dev.mysql.com/get/mysql57-community-release-fc25-10.noarch.rpm
   sudo dnf install -y mysql57-community-release-fc25-10.noarch.rpm
   
   # Installing MySQL
   sudo dnf install -y mysql-community-server
   

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

   mysql --version
   # mysql  Ver 14.14 Distrib 5.7.19, for Linux (x86_64) using  EditLine wrapper
   

3. Запустіть MySQL Server і перевірте його статус:

   sudo systemctl start mysqld.service
   sudo systemctl status mysqld.service
   

4. MySQL версії 5.7 або вище генерує тимчасовий випадковий пароль для rootкористувача MySQL після встановлення, а пароль зберігається у файлі журналу помилок MySQL, розташованому за адресою /var/log/mysqld.log. Щоб розкрити його, скористайтеся такою командою:

   sudo grep 'temporary password' /var/log/mysqld.log
   

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

   NOTE: Password Validation Plugin is installed and enabled, so your new password for root user needs to be strong (one upper case letter, one lower case letter, one digit, and one special character, and that the total password length is at least 8 characters). If you want to relax that or disable plugin completely (not recommended) consult the official MySQL documentation for how to do that.

   sudo mysql_secure_installation
   

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

   mysql -u root -p
   # Enter password:
   

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

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

8. Вийти з MySQL:

   exit
   

Встановіть NGINX

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

   sudo dnf install -y nginx
   

2. Verify that it is installed by checking the NGINX version:

   sudo nginx -v
   # nginx version: nginx/1.10.2
   

3. Check status, enable and start NGINX service (daemon):

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

4. Create /etc/nginx/ssl directory and generate a new Diffie-Hellman (DH) parameters:

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

5. Create log directory for blog.domain.tld virtual host:

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

6. Configure NGINX as a HTTP(S) reverse proxy server:

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

7. Paste the following in /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;
       listen 80;
       listen [::]:443 ssl http2;
       listen 443 ssl http2;
   
       server_name blog.domain.tld;
       root /var/www/ghost;
   
       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;
       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. Save and test NGINX configuration for syntax errors:

   sudo nginx -t
   

9. Reload NGINX configuration:

   sudo systemctl reload nginx.service
   

Install Ghost

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

1. Create document root directory:

   sudo mkdir -p /var/www/
   

2. Create a new ghost user:

   sudo useradd -c 'Ghost application' ghost
   

3. Download Ghost:

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

4. Unzip Ghost into the /var/www/ghost directory (recommended install location):

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

5. Move to the new ghost directory:

   cd /var/www/ghost
   

6. Change the ownership of the /var/www/ghost directory:

   sudo chown -R ghost:ghost .
   

7. Switch to new ghost user:

   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 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.