In questo tutorial, ti mostreremo come installare Etherpad su un VPS Ubuntu 18.04.
Etherpad è un'applicazione basata sul Web open source che consente la modifica collaborativa in tempo reale di un documento tramite un browser Web. Ciò consente agli utenti di digitare, modificare e rivedere simultaneamente i documenti:è disponibile anche la funzionalità di chat, che aiuta ulteriormente gli utenti a collaborare sui documenti. Iniziamo con l'installazione.
Prerequisiti
- Un Ubuntu 18.04 VPS (useremo il nostro piano SSD 2 VPS)
- Node.js versione 6.9.0 o successiva (versione preferita:Node.js 8.9 o successiva)
- Accesso all'account utente root (o accesso a un account amministratore con privilegi root)
Passaggio 1:accedi al server e aggiorna i pacchetti del sistema operativo del server
Accedi al tuo server Ubuntu 18.04 tramite SSH come utente root:
ssh root@IP_Address -p Port_number
Dovrai sostituire "Indirizzo_IP" e "Numero_porta" con il rispettivo indirizzo IP e numero di porta SSH del tuo server. Inoltre, se necessario, sostituisci "root" con il nome utente dell'account amministratore.
Prima di poter iniziare con l'installazione di Etherpad, dobbiamo assicurarci che tutti i pacchetti del sistema operativo Ubuntu installati sul server siano aggiornati. Possiamo farlo eseguendo i seguenti comandi:
sudo apt-get update sudo apt-get upgrade
Fase 2:installa i pacchetti richiesti
Installa i pacchetti richiesti che aiuteranno Etherpad a funzionare sul nostro server:
sudo apt install libssl-dev pkg-config gcc g++ make build-essential
Etherpad richiede anche Node.js, quindi installeremo l'ultima versione (al momento della stesura di questo tutorial), Node.js 10.15.3. L'ultima versione di Node.js può essere installata dal repository "nodesource". Una volta scaricato il tarball, estrailo in una nuova directory in /opt/nodejs/ .
cd /opt wget https://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz tar xJf node-v*-linux-x64.tar.xz sudo mkdir /opt/nodejs/ && mv node-*-linux-x64/* /opt/nodejs
Fase 3:installa MySQL e crea un database MySQL
Avremo bisogno di MySQL per archiviare i dati che Etherpad crea e manipola. Installa MySQL usando il seguente comando:
apt-get install mysql-server mysql-client
Crea un nuovo utente e database MySQL:
mysql> create database etherpad_db; mysql> grant all privileges on etherpad_db.* to etherpad@localhost identified by 'Str0ngPa55w0rd'; mysql> flush privileges; mysql> quit
Non dimenticare di modificare Str0ngPa55w0rd con una password reale e sicura.
Fase 4:crea un utente Etherpad
Per creare un nuovo utente di sistema per l'istanza Etherpad, eseguire i seguenti comandi:
sudo adduser --home /opt/etherpad --shell /bin/bash etherpad sudo install -d -m 755 -o etherpad -g etherpad /opt/etherpad sudo su - etherpad PATH=$PATH:/opt/nodejs/bin echo "PATH=$PATH:/opt/nodejs/bin" >> ~/.profile
Controlla la versione di Node.js:
etherpad@localhost:~$ node --version v10.15.3
Ora possiamo iniziare a installare Etherpad.
Fase 5:installa e configura Etherpad
Clona il repository Etherpad dalla pagina GitHub usando il seguente comando:
git clone git://github.com/ether/etherpad-lite.git ~/etherpad-lite
Vai alla directory "etherpad-lite" ed esegui lo script bash "run.sh" per avviare Etherpad.
cd /opt/etherpad/etherpad-lite/ bin/run.sh
Copia il file "settings.json.template" in un nuovo file chiamato "settings.json":
cp settings.json.template settings.json
Quindi modifica il file settings.json utilizzando il tuo editor di testo preferito (useremo "nano"):
nano settings.json
Aggiungi/modifica quanto segue:
- Sostituisci "ip":"0.0.0.0" con "ip":"127.0.0.1"
- Rimuovi le seguenti righe:
"dbType" : "dirty",
"dbSettings" : {
"filename" : "var/dirty.db"
}, - Modifica le righe sulle impostazioni di MySQL in modo che assomiglino a:
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpad",
"host" : "localhost",
"port" : 3306,
"password": "Str0ngPa55w0rd",
"database": "etherpad_db"
}, - Sostituisci “trustProxy” :false con “trustProxy” :true
- Imposta una password per l'utente "admin":
"users": {
"admin": {
// "password" can be replaced with "hash" if you install ep_hash_auth
"password": "Str0ngPa55w0rd",
"is_admin": true
}, Quindi salva ed esci dal file una volta apportate tutte le modifiche.
Esegui il comando seguente per installare tutte le altre dipendenze e avviare il servizio Etherpad:
~/etherpad-lite/bin/installDeps.sh ~/etherpad-lite/bin/run.sh
Per accedere a Etherpad, apri il tuo browser web e digita l'indirizzo IP del server con la porta '9001':http://server_IP_address:9001/
Puoi interrompere il processo Etherpad usando CTRL + C.
Fase 6:imposta un proxy inverso in Apache
Per accedere al tuo editor Etherpad solo utilizzando il tuo nome di dominio, senza il numero di porta 9001 nell'URL, dobbiamo configurarlo dietro un proxy inverso.
Per farlo, dobbiamo abilitare alcuni moduli proxy aggiuntivi in Apache. Possiamo farlo con i seguenti comandi:
a2enmod proxy a2enmod proxy_http
Riavvia Apache per rendere effettive le modifiche:
systemctl restart apache2
Una volta che 'mod_proxy' e 'mod_proxy_http' sono abilitati in Apache, crea un nuovo file di configurazione per il tuo dominio con il seguente comando:
nano /etc/apache2/sites-available/your-domain.com.conf
E inserisci le seguenti righe:
<VirtualHost *:80> ServerNameyour-domain.comServerAliaswww.your-domain.comProxyRequests Off <Proxy *> Order deny,allow Allow from all </Proxy> ProxyPass /http://127.0.0.1:9001/ProxyPassReverse /http://127.0.0.1:9001/<Location /> Order allow,deny Allow from all </Location> </VirtualHost>
Ricorda di sostituire "tuo-dominio.com" con il tuo nome di dominio effettivo. Salva il file, chiudilo e disabilita la configurazione predefinita di Apache:
a2dissite 000-default
Abilita la configurazione "tuo-dominio.com.conf" in Apache utilizzando:
a2ensite your-domain.com
Facoltativamente, possiamo usare questo comando per abilitarlo:
ln -s /etc/apache2/sites-available/your-domain.com.conf /etc/apache2/sites-enabled/your-domain.com.conf
Quindi riavvia Apache per rendere effettive le modifiche:
systemctl restart apache2
Passaggio 7:crea un servizio systemd per Etherpad
Possiamo anche creare un servizio systemd in modo da poter avviare Etherpad come qualsiasi altro servizio Ubuntu. Crea questo file nel percorso /etc/systemd/system/etherpad.service :
nano /etc/systemd/system/etherpad.service
E aggiungi le seguenti righe:
[Unit] Description=Etherpad-lite, the collaborative editor. After=syslog.target network.target [Service] Type=simple User=etherpad Group=etherpad WorkingDirectory=/opt/etherpad/etherpad-lite Environment=NODE_ENV=production ExecStart=/opt/nodejs/bin/node /opt/etherpad/etherpad-lite/src/node/server.js Restart=always [Install] WantedBy=multi-user.target
Salva l'uscita dal file. Dopodiché, ricarica i file usando questo comando:
sudo systemctl daemon-reload
Ora puoi avviare il servizio Etherpad e abilitare l'avvio automatico di Etherpad all'avvio del server:
sudo systemctl start etherpad.service sudo systemctl enable etherpad.service
Questo è tutto. Se hai seguito correttamente tutte le istruzioni, ora puoi accedere al tuo editor Etherpad utilizzando il tuo nome di dominio.
Ovviamente, non devi installare e configurare Etherpad su Ubuntu 18.04, se utilizzi una delle nostre soluzioni di hosting Ubuntu gestito, nel qual caso puoi semplicemente chiedere ai nostri esperti amministratori Linux di configurare e configurare Etherpad su Ubuntu 18.04 per te. Sono disponibili 24 ore su 24, 7 giorni su 7 e si prenderanno immediatamente cura della tua richiesta. Abbiamo anche pubblicato un post su Come installare Etherpad su Ubuntu 20.04.
PS . Se ti è piaciuto questo post su come installare Etherpad su un VPS Ubuntu 18.04 , condividilo con i tuoi amici sui social network utilizzando i pulsanti di condivisione qui sotto, o semplicemente lascia un commento in basso nella sezione commenti. Grazie.