Πώς να εγκαταστήσετε το BookStack στο FreeBSD 12

Εισαγωγή

Απαιτήσεις

Πριν ξεκινήσεις

Εγκαταστήστε την PHP

Εγκαταστήστε το MariaDB

Εγκαταστήστε το Nginx

Εγκαταστήστε το Composer

Εγκαταστήστε το BookStack

Εισαγωγή

Το BookStack είναι μια απλή, αυτο-φιλοξενούμενη εύχρηστη πλατφόρμα για την οργάνωση και την αποθήκευση πληροφοριών. Το BookStack είναι πλήρως δωρεάν και ανοιχτό, καθώς και άδεια MIT. Η πηγή είναι διαθέσιμη στο GitHub . Σε αυτό το σεμινάριο, θα εγκαταστήσουμε το BookStack σε μια νέα παρουσία του FreeBSD 12 Vultr.

Απαιτήσεις

• PHP έκδοση 7.0.0 ή μεταγενέστερη με τις ακόλουθες επεκτάσεις:
  • OpenSSL
  • PDO
  • MBString
  • Tokenizer
  • GD
  • MySQLND
  • Tidy
  • SimpleXML
  • DOM
• MySQL/MariaDB έκδοση 5.6 ή νεότερη
• Git (Δεν απαιτείται αυστηρά, αλλά βοηθά στη διαχείριση ενημερώσεων)
• Συνθέτης

Πριν ξεκινήσεις

Ελέγξτε την έκδοση του FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Βεβαιωθείτε ότι το σύστημά σας FreeBSD είναι ενημερωμένο.

freebsd-update fetch install
pkg update && pkg upgrade -y

Εγκαταστήστε τα απαραίτητα πακέτα.

pkg install -y sudo vim unzip curl wget bash socat git

Δημιουργήστε έναν νέο λογαριασμό χρήστη με το όνομα χρήστη που προτιμάτε, θα χρησιμοποιήσουμε johndoe.

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Εκτελέστε την visudoεντολή και αφαιρέστε το σχόλιο της %wheel ALL=(ALL) ALLγραμμής για να επιτρέψετε στα μέλη της wheelομάδας να εκτελέσουν οποιαδήποτε εντολή.

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

Τώρα, μεταβείτε στον νέο χρήστη που δημιουργήσατε με su.

su - johndoe

ΣΗΜΕΙΩΣΗ: Αντικαταστήστε το johndoeμε το όνομα χρήστη σας.

Ρυθμίστε τη ζώνη ώρας.

sudo tzsetup

Εγκαταστήστε την PHP

Εγκαταστήστε την PHP, καθώς και τις απαραίτητες επεκτάσεις PHP.

sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-pecl-imagick php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-mysqli php72-phar php72-opcache php72-tidy

Ελέγξτε την έκδοση.

php --version
# PHP 7.2.18 (cli) (built: May  9 2019 01:13:31) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

Μαλακή σύνδεση php.ini-productionμε php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Ενεργοποιήστε και ξεκινήστε το PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Εγκαταστήστε το MariaDB

Εγκαταστήστε το MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Ελέγξτε την έκδοση.

mysql --version
# mysql  Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1

Ξεκινήστε και ενεργοποιήστε το MariaDB.

sudo sysrc mysql_enable="yes" 
sudo service mysql-server start

Εκτελέστε το mysql_secure_installationσενάριο για να βελτιώσετε την ασφάλεια της εγκατάστασής σας.

sudo mysql_secure_installation

Συνδεθείτε στο MariaDB ως χρήστης root.

mysql -u root -p
# Enter password:

Δημιουργία νέας βάσης δεδομένων και χρήστη. Θυμηθείτε τα διαπιστευτήρια για αυτόν τον νέο χρήστη.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;

Εγκαταστήστε το Nginx

Εγκαταστήστε το Nginx.

sudo pkg install -y nginx

Ελέγξτε την έκδοση.

nginx -v
# nginx version: nginx/1.14.2

Ενεργοποιήστε και ξεκινήστε το Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Εκτελέστε sudo vim /usr/local/etc/nginx/bookstack.confκαι ρυθμίστε το Nginx για το BookStack.

server {
  listen 80;
  listen [::]:80;
  server_name example.com;
  root /usr/local/www/bookstack/public;

  index index.php index.html;

  location / {
    try_files $uri $uri/ /index.php$is_args$args;
  }

  location ~ \.php$ {
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass 127.0.0.1:9000;
  }
}

Αποθηκεύστε το αρχείο και βγείτε με :+ W+ Q.

Τώρα πρέπει να συμπεριλάβουμε bookstack.confστο κύριο nginx.confαρχείο.

Εκτελέστε sudo vim /usr/local/etc/nginx/nginx.confκαι προσθέστε την ακόλουθη γραμμή στο http {}μπλοκ.

include bookstack.conf;

Δοκιμάστε τις αλλαγές στη διαμόρφωση του Nginx.

sudo nginx -t

Επαναφόρτωση Nginx.

sudo service nginx reload

Εγκαταστήστε το Composer

Εγκαταστήστε το Composer παγκοσμίως εκτελώντας το ακόλουθο σενάριο στο τερματικό σας.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

ΣΗΜΕΙΩΣΗ: Στο μπλοκ εντολών που αναφέρεται παραπάνω, ο κατακερματισμός θα αλλάζει με κάθε έκδοση του προγράμματος εγκατάστασης. Επισκεφτείτε τη διεύθυνση https://getcomposer.org/download για τις πιο πρόσφατες εντολές εγκατάστασης του Composer.

Ελέγξτε την έκδοση.

composer --version
# Composer version 1.8.5 2019-04-09 17:46:47

Εγκαταστήστε το BookStack

Δημιουργήστε έναν ριζικό φάκελο εγγράφων.

sudo mkdir -p /usr/local/www/bookstack

Αλλάξτε την ιδιοκτησία του /usr/local/www/bookstackκαταλόγου σε johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/bookstack

Κλωνοποιήστε τον κλάδο έκδοσης του αποθετηρίου BookStack GitHub στον ριζικό φάκελο του εγγράφου.

cd /usr/local/www/bookstack
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch .

Εκτελέστε την εντολή εγκατάστασης του συνθέτη από τον /usr/local/www/bookstackκατάλογο.

composer install

Αντιγράψτε το .env.exampleαρχείο .envκαι συμπληρώστε το με τη δική σας βάση δεδομένων και τα στοιχεία αλληλογραφίας σας.

cp .env.example .env

Βεβαιωθείτε ότι οι φάκελοι storage, bootstrap/cacheκαι public/uploadsείναι εγγράψιμοι από τον διακομιστή web.

Στη ρίζα της εφαρμογής, εκτελέστε την ακόλουθη εντολή.

php artisan key:generate

Αυτό θα δημιουργήσει ένα μοναδικό κλειδί εφαρμογής.

Εκτελέστε php artisan migrateγια ενημέρωση της βάσης δεδομένων.

Αλλάξτε την ιδιοκτησία του /usr/local/www/bookstackκαταλόγου σε www.

sudo chown -R www:www /usr/local/www/bookstack

Τώρα μπορείτε να συνδεθείτε χρησιμοποιώντας τα προεπιλεγμένα στοιχεία διαχειριστή admin@admin.comμε κωδικό πρόσβασης password. Συνιστάται να αλλάξετε αυτά τα στοιχεία αμέσως μετά την πρώτη σας σύνδεση.