Dans ce tutoriel, nous allons vous montrer comment installer Etherpad sur un VPS Ubuntu 18.04.
Etherpad est une application Web open source qui permet l'édition collaborative en temps réel d'un document via un navigateur Web. Cela permet aux utilisateurs de taper, modifier et réviser simultanément des documents - même la fonctionnalité de chat est disponible, ce qui aide davantage les utilisateurs à collaborer sur des documents. Commençons par l'installation.
Prérequis
- Un VPS Ubuntu 18.04 (nous utiliserons notre plan SSD 2 VPS)
- Node.js version 6.9.0 ou supérieure (version préférée :Node.js 8.9 ou supérieure)
- Accès au compte utilisateur root (ou accès à un compte administrateur avec privilèges root)
Étape 1 :Connectez-vous au serveur et mettez à jour les packages du système d'exploitation du serveur
Connectez-vous à votre serveur Ubuntu 18.04 via SSH en tant qu'utilisateur root :
ssh root@IP_Address -p Port_number
Vous devrez remplacer 'IP_Address' et 'Port_number' par l'adresse IP et le numéro de port SSH respectifs de votre serveur. De plus, remplacez "root" par le nom d'utilisateur du compte administrateur si nécessaire.
Avant de pouvoir commencer l'installation d'Etherpad, nous devons nous assurer que tous les packages du système d'exploitation Ubuntu installés sur le serveur sont à jour. Nous pouvons le faire en exécutant les commandes suivantes :
sudo apt-get update sudo apt-get upgrade
Étape 2 :Installez les packages requis
Installez les packages requis qui permettront à Etherpad de fonctionner sur notre serveur :
sudo apt install libssl-dev pkg-config gcc g++ make build-essential
Etherpad nécessite également Node.js, nous allons donc installer la dernière version (au moment de la rédaction de ce tutoriel), Node.js 10.15.3. La dernière version de Node.js peut être installée à partir du référentiel "nodesource". Une fois que vous avez téléchargé l'archive, extrayez-la dans un nouveau répertoire à /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
Étape 3 :Installez MySQL et créez une base de données MySQL
Nous aurons besoin de MySQL pour stocker les données créées et manipulées par Etherpad. Installez MySQL à l'aide de la commande suivante :
apt-get install mysql-server mysql-client
Créez un nouvel utilisateur et une nouvelle base de données MySQL :
mysql> create database etherpad_db; mysql> grant all privileges on etherpad_db.* to etherpad@localhost identified by 'Str0ngPa55w0rd'; mysql> flush privileges; mysql> quit
N'oubliez pas de modifier Str0ngPa55w0rd avec un vrai mot de passe fort.
Étape 4 :Créer un utilisateur Etherpad
Afin de créer un nouvel utilisateur système pour l'instance Etherpad, exécutez les commandes suivantes :
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
Vérifiez la version de Node.js :
etherpad@localhost:~$ node --version v10.15.3
Nous pouvons maintenant commencer à installer Etherpad.
Étape 5 :Installer et configurer Etherpad
Clonez le dépôt Etherpad depuis la page GitHub à l'aide de la commande suivante :
git clone git://github.com/ether/etherpad-lite.git ~/etherpad-lite
Accédez au répertoire "etherpad-lite" et exécutez le script bash "run.sh" pour démarrer Etherpad.
cd /opt/etherpad/etherpad-lite/ bin/run.sh
Copiez le fichier "settings.json.template" dans un nouveau fichier nommé "settings.json" :
cp settings.json.template settings.json
Modifiez ensuite le fichier settings.json à l'aide de votre éditeur de texte préféré (nous utiliserons "nano") :
nano settings.json
Ajoutez/modifiez les éléments suivants :
- Remplacez "ip" :"0.0.0.0" par "ip" :"127.0.0.1"
- Supprimez les lignes suivantes :
"dbType" : "dirty",
"dbSettings" : {
"filename" : "var/dirty.db"
}, - Modifiez les lignes concernant les paramètres MySQL afin qu'elles ressemblent à :
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpad",
"host" : "localhost",
"port" : 3306,
"password": "Str0ngPa55w0rd",
"database": "etherpad_db"
}, - Remplacer "trustProxy" : false par "trustProxy" : true
- Définissez un mot de passe pour l'utilisateur "admin" :
"users": {
"admin": {
// "password" can be replaced with "hash" if you install ep_hash_auth
"password": "Str0ngPa55w0rd",
"is_admin": true
}, Ensuite, enregistrez et quittez le fichier une fois que toutes les modifications ont été apportées.
Exécutez la commande suivante pour installer toutes les autres dépendances et démarrer le service Etherpad :
~/etherpad-lite/bin/installDeps.sh ~/etherpad-lite/bin/run.sh
Pour accéder à Etherpad, ouvrez votre navigateur Web et tapez l'adresse IP du serveur avec le port '9001' :http://server_IP_address:9001/
Vous pouvez arrêter le processus Etherpad en utilisant CTRL + C.
Étape 6 :Définir un proxy inverse dans Apache
Afin d'accéder à votre éditeur Etherpad uniquement en utilisant votre nom de domaine, sans le numéro de port 9001 dans l'URL, nous devons le configurer derrière un proxy inverse.
Pour ce faire, nous devons activer certains modules proxy supplémentaires à Apache. Nous pouvons le faire avec les commandes suivantes :
a2enmod proxy a2enmod proxy_http
Redémarrez Apache pour que les modifications prennent effet :
systemctl restart apache2
Une fois "mod_proxy" et "mod_proxy_http" activés dans Apache, créez un nouveau fichier de configuration pour votre domaine avec la commande suivante :
nano /etc/apache2/sites-available/your-domain.com.conf
Et saisissez les lignes suivantes :
<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>
N'oubliez pas de remplacer votre "votre-domaine.com" par votre nom de domaine actuel. Enregistrez le fichier, fermez-le et désactivez la configuration Apache par défaut :
a2dissite 000-default
Activez la configuration "votre-domaine.com.conf" dans Apache en utilisant :
a2ensite your-domain.com
En option, nous pouvons utiliser cette commande pour l'activer :
ln -s /etc/apache2/sites-available/your-domain.com.conf /etc/apache2/sites-enabled/your-domain.com.conf
Redémarrez ensuite Apache pour que les modifications prennent effet :
systemctl restart apache2
Étape 7 :Créer un service systemd pour Etherpad
Nous pouvons également créer un service systemd afin de pouvoir démarrer Etherpad comme n'importe quel autre service Ubuntu. Créez ce fichier au chemin /etc/systemd/system/etherpad.service :
nano /etc/systemd/system/etherpad.service
Et ajoutez les lignes suivantes :
[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
Enregistrez la sortie du fichier. Après cela, rechargez les fichiers à l'aide de cette commande :
sudo systemctl daemon-reload
Vous pouvez maintenant démarrer le service Etherpad et activer Etherpad pour qu'il démarre automatiquement au démarrage du serveur :
sudo systemctl start etherpad.service sudo systemctl enable etherpad.service
C'est ça. Si vous avez bien suivi toutes les instructions, vous pouvez maintenant accéder à votre éditeur Etherpad en utilisant votre nom de domaine.
Bien sûr, vous n'avez pas besoin d'installer et de configurer Etherpad sur Ubuntu 18.04, si vous utilisez l'une de nos solutions d'hébergement Ubuntu géré, auquel cas vous pouvez simplement demander à nos administrateurs Linux experts d'installer et de configurer Etherpad sur Ubuntu 18.04 pour vous. Ils sont disponibles 24h/24 et 7j/7 et prendront immédiatement en charge votre demande. Nous avons également publié un article sur Comment installer Etherpad sur Ubuntu 20.04.
PS . Si vous avez aimé cet article sur comment installer Etherpad sur un VPS Ubuntu 18.04 , partagez-le avec vos amis sur les réseaux sociaux en utilisant les boutons de partage ci-dessous, ou laissez simplement un commentaire dans la section des commentaires. Merci.