Ricerca nel sito web

Come installare DokuWiki su Ubuntu 22.04


Questo tutorial esiste per queste versioni del sistema operativo

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

Su questa pagina

  1. Prerequisiti
  2. Installa Apache e PHP
  3. Installa DokuWiki Ubuntu 22.04
  4. Crea un host virtuale Apache per DokuWiki
  5. Abilita SSL sul sito Web DokuWiki
  6. Accedi a DokuWiki
  7. Impostazione del rinnovo automatico
  8. Conclusione

DokuWiki è un software wiki semplice, facile da usare e altamente versatile scritto in PHP. È gratuito, open source e utilizza un semplice formato di file per archiviare i propri dati invece di utilizzare qualsiasi sistema di database. Offre molte funzionalità che ti aiutano a ridimensionare e ottimizzare facilmente il tuo sito wiki. Sta guadagnando popolarità grazie alla sua sintassi pulita e leggibile. Utilizzando Dokuwiki, puoi creare i tuoi siti Web personali o aziendali tramite il pannello Web Dokuwiki.

In questo tutorial, ti mostreremo come installare DokuWiki con Apache e il certificato SSL Lets Encrypt su Ubuntu 22.04.

Prerequisiti

  • Un server che esegue Ubuntu 22.04.
  • Un nome di dominio valido viene indirizzato al tuo server.
  • Una password di root è configurata sul tuo server.

Installa Apache e PHP

Innanzitutto, dovrai installare il server web Apache, PHP e altre librerie PHP sul tuo sistema. Puoi installarli tutti eseguendo il seguente comando:

apt-get install apache2 php php-gd php-xml php-json -y

dopo aver installato tutti i pacchetti, avviare il servizio Apache e abilitarlo all'avvio all'avvio con il seguente comando:

systemctl start apache2
systemctl enable apache2

Al termine, puoi procedere al passaggio successivo.

Installa DokuWiki Ubuntu 22.04

Successivamente, visita la pagina di download ufficiale di DokuWiki, copia l'URL di download e scarica l'ultima versione di DokuWiki con il seguente comando:

wget https://download.dokuwiki.org/out/dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz

Una volta completato il download, crea una directory DokuWiki all'interno della directory root web di Apache ed estrai il DokuWiki:

mkdir /var/www/html/dokuwiki
tar -xvzf dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz -C /var/www/html/dokuwiki/ --strip-components=1

Successivamente, copia il file .htaccess di esempio con il seguente comando:

cp /var/www/html/dokuwiki/.htaccess{.dist,}

Successivamente, cambia la proprietà del dokuwiki in www-data:

chown -R www-data:www-data /var/www/html/dokuwiki

Una volta terminato, puoi procedere al passaggio successivo.

Crea un host virtuale Apache per DokuWiki

Successivamente, sarà necessario creare un file di configurazione dell'host virtuale Apache per servire il sito Web DokuWiki. Puoi crearlo con il seguente comando

nano /etc/apache2/sites-available/dokuwiki.conf

Aggiungi le seguenti righe:

<VirtualHost *:80>
        ServerName    doku.example.com      
        DocumentRoot  /var/www/html/dokuwiki

        <Directory ~ "/var/www/html/dokuwiki/(bin/|conf/|data/|inc/)">
            <IfModule mod_authz_core.c>
                AllowOverride All
                Require all denied
            </IfModule>
            <IfModule !mod_authz_core.c>
                Order allow,deny
                Deny from all
            </IfModule>
        </Directory>

        ErrorLog   /var/log/apache2/dokuwiki_error.log
        CustomLog  /var/log/apache2/dokuwiki_access.log combined
</VirtualHost>

Salva e chiudi il file quando hai finito. Quindi, abilita il file di configurazione dell'host virtuale DokuWiki e ricarica il servizio Apache con il seguente comando:

a2ensite dokuwiki.conf
systemctl reload apache2

Ora puoi controllare lo stato di Apache usando il seguente comando:

systemctl status apache2

Dovresti vedere il seguente output:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-06-25 15:44:31 UTC; 4min 30s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 52450 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 52131 (apache2)
      Tasks: 6 (limit: 4579)
     Memory: 16.9M
        CPU: 331ms
     CGroup: /system.slice/apache2.service
             ??52131 /usr/sbin/apache2 -k start
             ??52454 /usr/sbin/apache2 -k start
             ??52455 /usr/sbin/apache2 -k start
             ??52456 /usr/sbin/apache2 -k start
             ??52457 /usr/sbin/apache2 -k start
             ??52458 /usr/sbin/apache2 -k start

Jun 25 15:44:30 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

A questo punto, il web server Apache è configurato per servire il sito DokuWiki. Ora puoi procedere con l'installazione di Lets Encrypt SSL sul tuo sito web.

Abilita SSL sul sito web DokuWiki

Per abilitare SSL su DokuWiki, dovrai installare il client Certbot nel tuo sistema. Il Certbot è uno strumento Lets Encrypt utilizzato per scaricare e gestire l'SSL.

Puoi installare Certbot con il seguente comando:

apt-get install certbot python3-certbot-apache -y

Una volta installato, esegui il seguente comando per installare Lets Encrypt SSL per il tuo sito web:

certbot --apache -d dokuwiki.linuxbuz.com

Ti verrà chiesto di fornire la tua email valida e di accettare i termini di servizio come mostrato di seguito:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): 

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

Obtaining a new certificate
Performing the following challenges:
http-01 challenge for dokuwiki.linuxbuz.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabled Apache socache_shmcb module
Enabled Apache ssl module
Deploying Certificate to VirtualHost /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabling available site: /etc/apache2/sites-available/dokuwiki-le-ssl.conf

Successivamente, seleziona se reindirizzare o meno il traffico HTTP su HTTPS come mostrato di seguito:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Digita 2 e premi Invio per avviare il processo. Una volta completata l'installazione, dovresti ottenere il seguente output:

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/dokuwiki.conf to ssl vhost in /etc/apache2/sites-available/dokuwiki-le-ssl.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://dokuwiki.linuxbuz.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=dokuwiki.linuxbuz.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/dokuwiki.linuxbuz.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/dokuwiki.linuxbuz.com/privkey.pem
   Your cert will expire on 2020-09-05. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

A questo punto, il tuo sito Dokuwiki è protetto con Lets Encrypt SSL.

Accedi al DokuWiki

Ora apri il tuo browser web e digita l'URL https://dokuwiki.linuxbuz.com/install.php. Dovresti vedere la schermata di installazione di DokuWiki:

Fornisci il tuo nome wiki, nome utente amministratore, password, e-mail, scegli la tua politica e fai clic sul pulsante Salva. Verrai reindirizzato alla seguente pagina:

Clicca su \il tuo nuovo DokuWiki\. Dovresti vedere la seguente schermata:

Fare clic sul pulsante Accedi. Verrai reindirizzato alla schermata di accesso di DokuWiki come mostrato di seguito:

Fornisci il nome utente e la password dell'amministratore e fai clic sul pulsante Accedi. Dovresti vedere la dashboard di DokuWiki nella seguente schermata:

Impostazione del rinnovo automatico

Per impostazione predefinita, i certificati Let's Encrypt sono validi per 90 giorni. Quindi, dovrai impostare un cron job per rinnovare automaticamente il certificato SSL. È sicuro creare un cron job che viene eseguito ogni settimana o anche ogni giorno.

Se desideri rinnovare manualmente il certificato SSL, esegui il seguente comando:

certbot renew --dry-run

Puoi impostare un cron job per rinnovare automaticamente il certificato SSL ogni giorno alle 6:00 modificando il seguente file:

crontab -e

Aggiungi la seguente riga:

00 06 * * *   root /usr/bin/certbot renew >/dev/null 2>&1

Salva e chiudi il file quando hai finito.

Conclusione

Congratulazioni! hai installato correttamente DokuWiki e lo hai protetto con Lets Encrypt SSL su Ubuntu 22.04. Ora puoi creare il tuo sito wiki utilizzando DokuWiki. Non esitate a chiedermi se avete domande.