Kako namestiti BookStack na FreeBSD 12

Uvod

BookStack je preprosta platforma za organiziranje in shranjevanje informacij, ki se sama gosti in je enostavna za uporabo. BookStack je popolnoma brezplačen in odprt ter ima licenco MIT. Vir je na voljo na GitHubu . V tej vadnici bomo namestili BookStack na nov primerek FreeBSD 12 Vultr.

Zahteve

• PHP različica 7.0.0 ali novejša z naslednjimi razširitvami:
  • OpenSSL
  • PDO
  • MBString
  • Tokenizer
  • GD
  • MySQLND
  • Tidy
  • SimpleXML
  • DOM
• MySQL/MariaDB različice 5.6 ali novejše
• Git (ni nujno potreben, vendar pomaga upravljati posodobitve)
• Skladatelj

Preden začneš

Preverite različico FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Prepričajte se, da je vaš sistem FreeBSD posodobljen.

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

Namestite potrebne pakete.

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

Ustvarite nov uporabniški račun s svojim želenim uporabniškim imenom, mi bomo uporabili 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!

Zaženite visudoukaz in razkomentirajte %wheel ALL=(ALL) ALLvrstico, da omogočite članom wheelskupine, da izvedejo kateri koli ukaz.

visudo

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

Zdaj preklopite na novo ustvarjenega uporabnika z su.

su - johndoe

OPOMBA: Zamenjajte johndoez vašim uporabniškim imenom.

Nastavite časovni pas.

sudo tzsetup

Namesti PHP

Namestite PHP in potrebne razširitve 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

Preverite različico.

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

Mehka povezava php.ini-productiondo php.ini.

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

Omogočite in zaženite PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Namestite MariaDB

Namestite MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Preverite različico.

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

Zaženite in omogočite MariaDB.

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

Zaženite mysql_secure_installationskript, da izboljšate varnost svoje namestitve.

sudo mysql_secure_installation

Prijavite se v MariaDB kot root uporabnik.

mysql -u root -p
# Enter password:

Ustvarite novo bazo podatkov in uporabnika. Zapomni si poverilnice za tega novega uporabnika.

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

Namestite Nginx

Namestite Nginx.

sudo pkg install -y nginx

Preverite različico.

nginx -v
# nginx version: nginx/1.14.2

Omogočite in zaženite Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Zaženite sudo vim /usr/local/etc/nginx/bookstack.confin nastavite Nginx za 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;
  }
}

Shranite datoteko in zapustite s :+ W+ Q.

Zdaj moramo vključiti bookstack.confv glavno nginx.confdatoteko.

Zaženite sudo vim /usr/local/etc/nginx/nginx.confin dodajte naslednjo vrstico v http {}blok.

include bookstack.conf;

Preizkusite naše spremembe konfiguracije Nginx.

sudo nginx -t

Ponovno naložite Nginx.

sudo service nginx reload

Namesti Composer

Namestite Composer globalno tako, da v terminalu zaženete naslednji skript.

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

OPOMBA: V ukaznem bloku, ki je naveden zgoraj, se bo hash spremenil z vsako različico namestitvenega programa. Za najnovejše namestitvene ukaze Composer obiščite https://getcomposer.org/download .

Preverite različico.

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

Namestite BookStack

Ustvarite korensko mapo dokumenta.

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

Spremenite lastništvo /usr/local/www/bookstackimenika v johndoe.

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

Klonirajte vejo izdaje repozitorija BookStack GitHub v korensko mapo dokumenta.

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

Zaženite ukaz za namestitev skladatelja iz /usr/local/www/bookstackimenika.

composer install

Kopirajte .env.exampledatoteko .envin jo zapolnite z lastno bazo podatkov in e-poštnimi podatki.

cp .env.example .env

Prepričajte se, da spletni strežnik lahko piše v mape storage, bootstrap/cachein public/uploads.

V korenu aplikacije zaženite naslednji ukaz.

php artisan key:generate

To bo ustvarilo edinstven ključ aplikacije.

Zaženite, php artisan migrateda posodobite bazo podatkov.

Spremenite lastništvo /usr/local/www/bookstackimenika v www.

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

Zdaj se lahko prijavite s privzetimi skrbniškimi podatki [email protected]z geslom password. Priporočljivo je, da te podatke spremenite neposredno po prvi prijavi.