Kako namestiti BookStack na Debian 9

BookStack je preprosta platforma za organiziranje in shranjevanje informacij, ki jo gosti sam in je preprosta 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 Debian 9 Vultr.

Zahteve

• MySQL različica 5.6 ali novejša; ali MariaDB
• Git (ni nujno potreben, vendar pomaga upravljati posodobitve)
• Skladatelj
• PHP različica 7.0.0 ali novejša
• PHP razširitve:
  • OpenSSL
  • PDO
  • MBstring
  • Tokenizer
  • GD
  • MySQLND
  • Tidy
  • SimpleXML
  • DOM

Preden začneš

Preverite različico Debiana.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

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

apt update && apt upgrade -y

Namestite potrebne pakete.

apt install -y sudo unzip curl git

Ustvarite nov nekorenski uporabniški račun z sudodostopom in preklopite nanj.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

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

Nastavite časovni pas.

sudo dpkg-reconfigure tzdata

Namesti PHP

Namestite PHP in potrebne razširitve PHP.

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-tidy php7.0-curl php7.0-ldap php7.0-mcrypt php7.0-gd php7.0-xml php7.0-zip php7.0-mysql php7.0-mbstring php7.0-common

Preverite različico.

php -v

Namestite MariaDB

Namestite MariaDB.

sudo apt install -y mariadb-server

Preverite različico.

mysql --version

Zaženite mysql_secure installationskript, da izboljšate varnost MariaDB.

sudo mysql_secure_installation

Povežite se z lupino MariaDB kot root uporabnik.

sudo mysql -u root -p
# Enter password:

Nastavite novo zbirko podatkov MariaDB in uporabnika ter si zapomnite poverilnice.

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

Zapustite MariaDB.

exit

Namestite Nginx

Namestite Nginx.

sudo apt install -y nginx

Preverite različico.

sudo nginx -v

Konfigurirajte Nginx za BookStack. Zaženite sudo vim /etc/nginx/sites-available/bookstack.confin napolnite datoteko z naslednjim.

server {
  listen 80;
  listen [::]:80;

  server_name example.com;

  root /var/www/bookstack/public;

  index index.php index.html;

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }

  location ~ \.php$ {
    fastcgi_index index.php;
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php/php7.0-fpm.sock;
  }
}

Aktivirajte novo bookstack.confkonfiguracijo tako, da datoteko povežete z sites-enabledimenikom.

sudo ln -s /etc/nginx/sites-available/bookstack.conf /etc/nginx/sites-enabled/

Preizkusite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namesti Composer

Namesti Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { 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

Preverite različico.

composer --version

Namestite BookStack

Ustvarite korensko mapo dokumenta.

sudo mkdir -p /var/www/bookstack

Spremenite lastništvo /var/www/bookstackimenika v johndoe.

sudo chown -R johndoe:johndoe /var/www/bookstack

Klonirajte vejo izdaje repozitorija BookStack GitHub v korensko mapo dokumenta.

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

Zaženite composer installukaz iz /var/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 /var/www/bookstackimenika v www-data.

sudo chown -R www-data:www-data /var/www/bookstack

Zdaj se lahko prijavite s privzetimi skrbniškimi podatki admin@admin.comz geslom password. Priporočljivo je, da te podatke spremenite neposredno po prvi prijavi.