BookStack to proste i otwarte oprogramowanie do tworzenia i organizowania dokumentacji, notatek i wiedzy. Jest to świetne rozwiązanie dla zespołów, firm lub nawet do użytku osobistego. BookStack jest zbudowany w oparciu o framework Laravel i używa PHP, Nginx/Apache oraz MySQL/MariaDB. Ten przewodnik przeprowadzi Cię przez proces instalacji BookStack na serwerze z systemem operacyjnym Debian 12 (Bookworm).

Spis Treści

1. Wymagania Wstępne
2. Aktualizacja Systemu
3. Instalacja Serwera WWW (Nginx) i PHP
4. Instalacja Bazy Danych (MariaDB)
5. Instalacja Composera
6. Instalacja BookStack
7. Konfiguracja Nginx
8. Konfiguracja Zapory Sieciowej (UFW)
9. Dostęp do BookStack
10. Promocja: Postaw BookStack na naszym VPS Linux!
11. Podsumowanie

—

1. Wymagania Wstępne

• Serwer z zainstalowanym czystym systemem **Debian 12 (Bookworm)**.
• Dostęp root lub użytkownik z uprawnieniami `sudo`.
• Minimum 2 GB RAM (zalecane 4 GB lub więcej).
• Minimum 10 GB wolnej przestrzeni dyskowej.
• Dostęp do internetu.
• Nazwa domeny (np. `twojadomena.com`) lub adres IP serwera.

—

2. Aktualizacja Systemu

Zawsze zacznij od aktualizacji list pakietów i uaktualnienia istniejących pakietów do najnowszych wersji. To zapewnia, że masz najnowsze poprawki bezpieczeństwa i zależności.

sudo apt update && sudo apt upgrade -y
sudo apt dist-upgrade -y
sudo apt autoremove -y

—

3. Instalacja Serwera WWW (Nginx) i PHP

BookStack wymaga serwera WWW (Nginx lub Apache) oraz PHP w wersji 8.1 lub nowszej. Debian 12 domyślnie dostarcza PHP 8.2, co jest idealne.

sudo apt install nginx php8.2 php8.2-fpm php8.2-mysql php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip php8.2-cli unzip git -y

Po instalacji upewnij się, że Nginx i PHP-FPM są uruchomione i włączone do startu systemu:

sudo systemctl start nginx
sudo systemctl enable nginx
sudo systemctl start php8.2-fpm
sudo systemctl enable php8.2-fpm

—

4. Instalacja Bazy Danych (MariaDB)

BookStack wymaga bazy danych MySQL lub MariaDB. W tym przewodniku użyjemy MariaDB.

sudo apt install mariadb-server mariadb-client -y

Zabezpiecz instalację MariaDB i ustaw hasło dla użytkownika `root` bazy danych:

sudo mysql_secure_installation

Postępuj zgodnie z instrukcjami: ustaw hasło dla roota MariaDB, usuń anonimowych użytkowników, zablokuj zdalny dostęp roota i usuń testową bazę danych.

Zaloguj się do MariaDB i utwórz bazę danych oraz użytkownika dla BookStack:

sudo mysql -u root -p

Wprowadź swoje hasło roota MariaDB. Następnie wykonaj polecenia SQL:

CREATE DATABASE bookstack;
CREATE USER 'bookstackuser'@'localhost' IDENTIFIED BY 'Twoje_Mega_Silne_Haslo_DB!';
GRANT ALL PRIVILEGES ON bookstack.* TO 'bookstackuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Zastąp `Twoje_Mega_Silne_Haslo_DB!` bezpiecznym i unikalnym hasłem.

—

5. Instalacja Composera

Composer to menedżer zależności dla PHP, niezbędny do instalacji BookStack.

cd ~
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Zweryfikuj instalację:

composer --version

—

6. Instalacja BookStack

Stwórz katalog dla BookStack, pobierz pliki z GitHub i skonfiguruj zależności.

Tworzenie Katalogu i Klonowanie Repozytorium

sudo mkdir -p /var/www/bookstack
sudo chown -R www-data:www-data /var/www/bookstack # Zapewnij odpowiednie uprawnienia
sudo git clone https://github.com/BookStackApp/BookStack.git /var/www/bookstack

Konfiguracja Uprawnień

sudo chown -R www-data:www-data /var/www/bookstack
sudo chmod -R 755 /var/www/bookstack
sudo chmod -R 775 /var/www/bookstack/storage /var/www/bookstack/bootstrap/cache /var/www/bookstack/public/uploads

Instalacja Zależności Composera

cd /var/www/bookstack
sudo composer install --no-dev

Konfiguracja Pliku Środowiskowego (.env)

Utwórz plik `.env` i uzupełnij dane bazy danych oraz URL aplikacji.

sudo cp .env.example .env
sudo nano .env

Edytuj następujące linie, używając danych bazy danych, które utworzyłeś:

APP_URL=http://twojadomena.com # Lub https://twojadomena.com jeśli używasz SSL
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bookstack
DB_USERNAME=bookstackuser
DB_PASSWORD=Twoje_Mega_Silne_Haslo_DB!

Zapisz i zamknij plik.

Generowanie Klucza Aplikacji Laravel

sudo php artisan key:generate

Uruchamianie Migracji Bazy Danych

sudo php artisan migrate

—

7. Konfiguracja Nginx

Stwórz plik konfiguracyjny Nginx dla BookStack.

sudo nano /etc/nginx/sites-available/bookstack.conf

Wklej następującą konfigurację (zastąp `twojadomena.com` swoją domeną lub adresem IP serwera):

server {
    listen 80;
    server_name twojadomena.com; # Zmień na swoją domenę lub adres IP
    root /var/www/bookstack/public;

    index index.php index.html index.htm;

    charset utf-8;

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

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Zapisz i zamknij plik.

Aktywacja Konfiguracji i Ponowne Uruchomienie Nginx

sudo ln -s /etc/nginx/sites-available/bookstack.conf /etc/nginx/sites-enabled/
sudo nginx -t # Test konfiguracji
sudo systemctl restart nginx
sudo systemctl reload nginx

Usuń domyślną konfigurację Nginx, aby uniknąć konfliktów:

sudo rm /etc/nginx/sites-enabled/default

—

8. Konfiguracja Zapory Sieciowej (UFW)

Upewnij się, że porty HTTP (80) i HTTPS (443, jeśli skonfigurujesz SSL) są otwarte.

sudo apt install ufw -y # Jeśli nie zainstalowano
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp comment 'Allow SSH'
sudo ufw allow 80/tcp comment 'Allow HTTP'
sudo ufw allow 443/tcp comment 'Allow HTTPS (if applicable)'
sudo ufw enable # Potwierdź y

Sprawdź status UFW:

sudo ufw status verbose

—

9. Dostęp do BookStack

Po wykonaniu wszystkich kroków, powinieneś móc uzyskać dostęp do swojej instalacji BookStack, wpisując adres swojej domeny (lub adres IP serwera) w przeglądarce:

http://twojadomena.com

Przy pierwszym dostępie zostaniesz poproszony o utworzenie konta administratora. Użyj domyślnych danych logowania, jeśli nie stworzyłeś użytkownika podczas migracji:

• **Email:** `[email protected]`
• **Hasło:** `password`

Pamiętaj, aby natychmiast zmienić te domyślne dane logowania!

—

10. Promocja: Postaw BookStack na naszym VPS Linux!

—

Podsumowanie

Gratulacje! Pomyślnie zainstalowałeś BookStack na swoim serwerze z Debianem 12. Teraz możesz rozpocząć tworzenie i organizowanie swojej dokumentacji w intuicyjnym i potężnym środowisku.

Pamiętaj o regularnych aktualizacjach BookStack, PHP i systemu operacyjnego, aby zapewnić bezpieczeństwo i dostęp do najnowszych funkcji. Rozważ również konfigurację certyfikatu SSL (np. za pomocą Let’s Encrypt), aby zabezpieczyć komunikację z Twoim BookStackiem.