Ako nainštalovať WonderCMS na Debian 12

Tento návod existuje pre tieto verzie OS

  • Debian 12 (knihomoľ)
  • Debian 9 (Stretch)

Na tejto stránke

  1. Predpoklady
  2. Inštalácia závislostí
  3. Konfigurácia PHP
  4. Konfigurácia brány firewall
  5. Sťahovanie zdrojového kódu WonderCMS
  6. Konfigurácia virtuálneho hostiteľa Apache
  7. Zabezpečenie WonderCMS pomocou Letsencrypt
  8. Prístup k inštalácii WonderCMS
  9. Záver

WonderCMS je ľahký, open-source redakčný systém (CMS) navrhnutý pre jednoduchosť a jednoduchosť používania. Na rozdiel od mnohých iných platforiem CMS, ktoré si vyžadujú rozsiahle nastavenie alebo veľké zdroje, WonderCMS funguje na jedinej databáze s plochým súborom, čo znamená, že nepotrebuje tradičný databázový systém ako MySQL. Vďaka tomu je jeho inštalácia a správa mimoriadne jednoduchá, pričom často nevyžaduje nič viac ako nahrávanie súborov CMS na server. Napriek svojej malej veľkosti ponúka WonderCMS základné funkcie, ako je úprava obsahu, možnosti SEO, prispôsobenie tém a podpora doplnkov, čo z neho robí životaschopnú možnosť pre používateľov, ktorí chcú minimalistické a jednoduché riešenie na vytváranie a správu webových stránok.

V tomto návode vám ukážeme, ako nainštalovať WonderCMS na server Debian 12 s webovým serverom Apache a PHP 8.x.

Predpoklady

Pred začatím sa uistite, že máte nasledovné:

  • Server Debian 12.
  • Používateľ bez oprávnenia root s oprávneniami správcu.
  • Názov domény smerujúci na IP adresu servera.

Inštalácia závislostí

WonderCMS je open-source redakčný systém napísaný v PHP. Je to plochý CMS, čo znamená, že na inštaláciu nevyžaduje databázu ako MySQL/MariaDB. Ako databázu používal textové súbory.

V tejto príručke nainštalujete WonderCMS s webovým serverom Apache a PHP 8.2.

Pred inštaláciou balíkov obnovte a aktualizujte úložisko Debianu pomocou príkazu nižšie.

sudo apt update

Po aktualizácii nainštalujte závislosti pre WonderCMS vykonaním príkazu nižšie. WonderCMS je plochý CMS, nevyžaduje databázu. Nainštalujete teda iba webový server Apache a balíky PHP.

sudo apt install apache2 php php-common php-mbstring php-curl php-zip unzip

Zadajte y na potvrdenie inštalácie.

Po dokončení inštalácie overte službu Apache pomocou príkazu nižšie. Apache by mal byť v predvolenom nastavení spustený a povolený.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Nižšie vidíte povolenú a spustenú službu Apache.

Nakoniec overte verziu PHP a povoľte rozšírenia pomocou nasledujúceho príkazu.

php -m
php -v

Vo výstupe nižšie môžete vidieť, že je nainštalované PHP 8.2.

Konfigurácia PHP

Po nainštalovaní závislostí musíte nakonfigurovať PHP pre WonderCMS. Budete musieť upraviť konfiguráciu php.ini pre webový server Apache a zmeniť niektoré predvolené nastavenia, ako je časové pásmo, limit pamäte, čas spustenia a maximálna veľkosť nahrávaného súboru.

Otvorte konfiguráciu php.ini pre webový server Apache pomocou nasledujúceho príkazu editora nano.

sudo nano /etc/php/8.2/apache2/php.ini

Zmeňte predvolenú konfiguráciu PHP, ako je uvedené nižšie - Uistite sa, že ste upravili časové pásmo a memory_limit podľa aktuálneho serverového prostredia.

date.timezone = "Europe/Amsterdam"
memory_limit = 512M
upload_max_filesize = 128MB
post_max_size = 128MB
max_execution_time = 300
max_input_vars = 5000

Uložte a ukončite súbor, keď skončíte.

Teraz reštartujte službu Apache, aby ste použili svoju modifikáciu na PHP.

sudo systemctl restart apache2

Konfigurácia brány firewall

V tejto príručke spustíte WonderCMS s povolenou bránou firewall. V tomto príklade budete používať UFW. Takže teraz musíte nainštalovať UFW a otvoriť porty pre služby SSH, HTTP a HTTPS.

Nainštalujte UFW na svoj server Debian pomocou nasledujúceho príkazu. Zadajte y pre potvrdenie a pokračujte.

sudo apt install ufw

Po dokončení inštalácie aktivujte profil OpenSSH na otvorenie portu 22 a profil „WWW Full“ na otvorenie portov HTTP aj HTTPS.

sudo ufw allow OpenSSH
sudo ufw allow "WWW Full"

Teraz spustite nasledujúci príkaz na spustenie a povolenie UFW. Zadajte y na potvrdenie a UFW by malo byť spustené a povolené.

sudo ufw enable

Nakoniec overte stav UFW pomocou príkazu nižšie. Na UFW sú povolené profily OpenSSH aj „WWW Full“.

sudo ufw status

Sťahovanie zdrojového kódu WonderCMS

V tejto časti si stiahnete zdrojový kód WonderCMS a nakonfigurujete koreňový adresár dokumentu s príslušnými povoleniami a vlastníctvom. Skôr ako začnete, nezabudnite navštíviť stránku WonderCMS GitHub a získať najnovší odkaz na stiahnutie.

Prejdite do adresára /var/www a stiahnite si zdrojový kód WonderCMS pomocou príkazu wget nižšie.

cd /var/www/
wget https://github.com/WonderCMS/wondercms/releases/download/3.4.3/wondercms-343.zip

Po stiahnutí rozbaľte zdrojový kód WonderCMS do adresára /var/www/wondercms pomocou príkazu unzip.

unzip wondercms-343.zip -d /var/www/wondercms

Nakoniec zmeňte vlastníctvo adresára /var/www/wondercms na používateľa www-data. Vďaka tomu umožníte Apache čítať, zapisovať a spúšťať do koreňového adresára dokumentov WonderCMS.

sudo chown -R www-data:www-data /var/www/wondercms
sudo chmod -R 755 /var/www/wondercms

Konfigurácia virtuálneho hostiteľa Apache

V tomto príklade spustíte WonderCMS s Apache, takže na to musíte vytvoriť konfiguráciu virtuálneho hostiteľa. Uistite sa, že názov vašej domény ukazuje na IP adresu vášho servera Debian.

Najprv použite príkaz uvedený nižšie na aktiváciu modulu prepisovania na Apache. WonderCMS vyžaduje, aby bol povolený mod_rewrite.

sudo a2enmod rewrite

Po povolení vytvorte novú konfiguráciu virtuálneho hostiteľa /etc/apache2/sites-available/wondercms.conf pomocou príkazu editora nano.

sudo nano /etc/apache2/sites-available/wondercms.conf

Vložte nasledujúcu konfiguráciu. Nezabudnite zmeniť názov domény, cestu ku koreňovému adresáru dokumentu a protokolové súbory s vašimi informáciami.

<VirtualHost *:80>
ServerName cms.howtoforge.local
DirectoryIndex index.php
DocumentRoot /var/www/wondercms
Redirect /wondercms/loginURL /loginURL
ErrorLog /var/log/apache2/cms.howtoforge.local-error.log
CustomLog /var/log/apache2/cms.howtoforge.local-access.log combined
<Directory /var/www/wondercms>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>

Uložte a ukončite súbor, keď skončíte.

Potom vykonajte nasledujúci príkaz, aby ste povolili súbor virtuálneho hostiteľa wondercms.conf. Potom overte Apache a uistite sa, že máte správnu syntax.

sudo a2ensite wondercms.conf
sudo apachectl configtest

Ak máte správnu syntax Apache, mali by ste dostať výstupnú syntax OK.

Nakoniec spustite príkaz uvedený nižšie, aby ste reštartovali službu Apache a použili svoje zmeny. Vďaka tomu by mala byť vaša inštalácia WonderCMS pripravená.

sudo systemctl restart apache2

Zabezpečenie WonderCMS pomocou Letsencrypt

Po nakonfigurovaní virtuálneho hostiteľa Apache zabezpečte inštaláciu WonderCMS pomocou protokolu HTTPS. V tomto prípade použijete Certbot a Letsencrypt.

Na zabezpečenie inštalácie WonderCMS môžete vygenerovať certifikáty s vlastným podpisom pre názvy lokálnych domén alebo interné siete.

Nainštalujte Certbot a doplnok Certbot Apache pomocou príkazu nižšie. Zadajte y na potvrdenie inštalácie.

sudo apt install certbot python3-certbot-apache

Po dokončení inštalácie vygenerujte certifikáty SSL pre názov domény WonderCMS. Nezabudnite tiež zmeniť názov domény a e-mailovú adresu tak, aby zodpovedali vašim informáciám.

sudo certbot --apache --agree-tos --no-eff-email --redirect --hsts --staple-oscp --email [email  -d cms.howtoforge.local

Po dokončení procesu by mal byť váš certifikát dostupný v adresári /etc/letsencrypt/live/howtoforge.local. Vaša inštalácia WonderCMS by mala byť automaticky zabezpečená pomocou HTTPS.

Prístup k inštalácii WonderCMS

Otvorte webový prehliadač a navštívte názov svojej domény WonderCMS, napríklad https://howtoforge.local/. Na domovskej stránke WonderCMS by ste mali vidieť vygenerované heslo. Skopírujte heslo a uložte ho na tajné miesto.

Záver

Gratulujem! Úspešne ste nainštalovali WonderCMS na server Debian 12 spolu s webovým serverom Apache a PHP 8.2. WonderCMS ste tiež zabezpečili pomocou UFW a SSL certifikátov od Letsencrypt.