Απαιτήσεις
Πριν ξεκινήσεις
Εγκαταστήστε την PHP
Εγκαταστήστε το MariaDB
Εγκαταστήστε το Nginx
Εγκαταστήστε το Composer
Εγκαταστήστε το BookStack
Το BookStack είναι μια απλή, αυτο-φιλοξενούμενη, εύχρηστη πλατφόρμα για την οργάνωση και την αποθήκευση πληροφοριών. Το BookStack είναι πλήρως δωρεάν και ανοιχτό, καθώς και άδεια MIT. Η πηγή είναι διαθέσιμη στο GitHub . Σε αυτό το σεμινάριο θα εγκαταστήσουμε το BookStack σε μια νέα παρουσία του Debian 9 Vultr.
Απαιτήσεις
- MySQL έκδοση 5.6 ή μεταγενέστερη. ή MariaDB
- Git (Δεν απαιτείται αυστηρά, αλλά βοηθά στη διαχείριση ενημερώσεων)
- Συνθέτης
- PHP έκδοση 7.0.0 ή νεότερη
- Επεκτάσεις PHP:
OpenSSL
PDO
MBstring
Tokenizer
GD
MySQLND
Tidy
SimpleXML
DOM
Πριν ξεκινήσεις
Ελέγξτε την έκδοση του Debian.
lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)
Βεβαιωθείτε ότι το σύστημά σας είναι ενημερωμένο.
apt update && apt upgrade -y
Εγκαταστήστε τα απαραίτητα πακέτα.
apt install -y sudo unzip curl git
Δημιουργήστε ένα νέο μη-root λογαριασμό χρήστη με sudo
πρόσβαση και να μεταβείτε σε αυτό.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
ΣΗΜΕΙΩΣΗ: Αντικαταστήστε το johndoe
με το όνομα χρήστη σας.
Ρυθμίστε τη ζώνη ώρας.
sudo dpkg-reconfigure tzdata
Εγκαταστήστε την PHP
Εγκαταστήστε την PHP και τις απαραίτητες επεκτάσεις 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
Ελέγξτε την έκδοση.
php -v
Εγκαταστήστε το MariaDB
Εγκαταστήστε το MariaDB.
sudo apt install -y mariadb-server
Ελέγξτε την έκδοση.
mysql --version
Εκτελέστε το mysql_secure installation
σενάριο για να βελτιώσετε την ασφάλεια του MariaDB.
sudo mysql_secure_installation
Συνδεθείτε στο κέλυφος MariaDB ως χρήστης ρίζας.
sudo mysql -u root -p
# Enter password:
Ρυθμίστε μια νέα βάση δεδομένων και χρήστη της MariaDB και θυμηθείτε τα διαπιστευτήρια.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
Έξοδος από το MariaDB.
exit
Εγκαταστήστε το Nginx
Εγκαταστήστε το Nginx.
sudo apt install -y nginx
Ελέγξτε την έκδοση.
sudo nginx -v
Διαμόρφωση του Nginx για BookStack. Εκτελέστε sudo vim /etc/nginx/sites-available/bookstack.conf
και συμπληρώστε το αρχείο με τα ακόλουθα.
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;
}
}
Ενεργοποιήστε τη νέα bookstack.conf
διαμόρφωση συνδέοντας το αρχείο στον sites-enabled
κατάλογο.
sudo ln -s /etc/nginx/sites-available/bookstack.conf /etc/nginx/sites-enabled/
Δοκιμάστε τη διαμόρφωση.
sudo nginx -t
Επαναφόρτωση Nginx.
sudo systemctl reload nginx.service
Εγκαταστήστε το Composer
Εγκαταστήστε το 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
Ελέγξτε την έκδοση.
composer --version
Εγκαταστήστε το BookStack
Δημιουργήστε έναν ριζικό φάκελο εγγράφων.
sudo mkdir -p /var/www/bookstack
Αλλάξτε την ιδιοκτησία του /var/www/bookstack
καταλόγου σε johndoe
.
sudo chown -R johndoe:johndoe /var/www/bookstack
Κλωνοποιήστε τον κλάδο έκδοσης του αποθετηρίου BookStack GitHub στον ριζικό φάκελο του εγγράφου.
cd /var/www/bookstack
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch .
Εκτελέστε την composer install
εντολή από τον /var/www/bookstack
κατάλογο.
composer install
Αντιγράψτε το .env.example
αρχείο .env
και συμπληρώστε το με τη δική σας βάση δεδομένων και τα στοιχεία αλληλογραφίας σας.
cp .env.example .env
Βεβαιωθείτε ότι οι φάκελοι storage
, bootstrap/cache
και public/uploads
είναι εγγράψιμοι από τον διακομιστή web.
Στη ρίζα της εφαρμογής, εκτελέστε την ακόλουθη εντολή.
php artisan key:generate
Αυτό θα δημιουργήσει ένα μοναδικό κλειδί εφαρμογής.
Εκτελέστε php artisan migrate
για ενημέρωση της βάσης δεδομένων.
Αλλάξτε την ιδιοκτησία του /var/www/bookstack
καταλόγου σε www-data
.
sudo chown -R www-data:www-data /var/www/bookstack
Τώρα μπορείτε να συνδεθείτε χρησιμοποιώντας τα προεπιλεγμένα στοιχεία διαχειριστή [email protected]
με κωδικό πρόσβασης password
. Συνιστάται να αλλάξετε αυτά τα στοιχεία αμέσως μετά την πρώτη σας σύνδεση.