{{tag>application software synchronisation synchroniser firefox chrome marque-page favoris}}
====== Installation du service xBrowserSync ======
===== Environnement =====
^ Système | Debian GNU/Linux 13 (trixie) |
^ Noyau | Linux 6.12.107+deb13-amd64 |
^ Architecture | x86-64 |
^ version | xBrowserSync 1.1.13 |
^ Date | 10/2026 |
===== Procédure =====
:TODO_DOCUPDATE:
* [[software:applications:mongodb:installer-serveur-mongodb-debian13|Installer le serveur de base de données nosql MongoDB]] ;
Invoquer **mongosh**, puis les commandes suivantes depuis le prompt :
use admin
db.createUser({ user: "xbrowsersyncdb", pwd: "MyPasswordHere", roles: [ { role: "readWrite", db: "xbrowsersync" }, { role: "readWrite", db: "xbrowsersynctest" } ] })
use xbrowsersync
db.newsynclogs.createIndex( { "expiresAt": 1 }, { expireAfterSeconds: 0 } )
db.newsynclogs.createIndex({ "ipAddress": 1 })
quit
Installer les paquets suivants :
apt install -y git
Créer un utilisateur standard ''xbro''
adduser --comment "Run xBrowserSync service" xbro
install -o xbro -g xbro -m 750 -d /srv/xbrowsersync
su - xbro
cd /srv/xbrowsersync/
umask 0077
git clone https://github.com/xbrowsersync/api.git
La version xBrowserSync 1.1.13 compile correctement avec Node.js 15
# Télécharger et installer nvm :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
# au lieu de redémarrer le shell
\. "$HOME/.nvm/nvm.sh"
# Télécharger et installer Node.js 15 :
nvm install 15
Pour Vérifiez la version de Node.js :
node -v # Doit afficher "v15.14.0".
npm -v # Doit afficher "7.7.6".
Si plusieurs versions de Node.js coexistent dans l'environnement, on définit la v15 par défaut via la commande :
nvm install 15
nvm alias default v15.14.0
cd api
npm install
Les dépendances nécessaire au programme sont installées dans le dossier ''./node_modules''
Vérifier l'installation des dépendances :
npm list
Créer le dossier d'enregistrement des logs :
# en root
install -o xbro -g root -m 750 -d /var/log/xBrowserSync
Pour tester l'application :
node dist/api.js
Arrêter l'exécution avec ctrl + c. Le fichier de trace ''/var/log/xBrowserSync/api.log'' a été créé avec un contenu de la forme :
{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"msg":"Service started at http://127.0.0.1:8080/","time":"2026-10-10T08:24:58.553Z","v":0}
{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"req":null,"msg":"Process terminated by SIGINT","time":"2026-10-10T08:25:16.809Z","v":0}
{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"msg":"Service shutting down","time":"2026-10-10T08:25:16.809Z","v":0}
Ici on peut voir que l'application s'exécute par défaut sur la **boucle locale** et utilise le port **8080**.
A ce stade l'application fonctionne mais pour la rendre accessible il nous faut encore :
* Créer un fichier unité systemd de type service pour l'exécuter comme daemon système ;
* Installer un reverse proxy écoutant sur les ports standards HTTP ou HTTPS et redirigeant le trafic entrant vers l'application.
===== Création du service systemd =====
touch /etc/systemd/system/xbrowsersync.service
Ci-dessous le contenu du fichier unité ''/etc/systemd/system/xbrowsersync.service''
[Unit]
Description=API de synchronisation des favoris xBrowserSync
#Before=
After=mongod.service
ConditionPathExists=/srv/xbrowsersync/api
#ConditionFileIsExecutable=
[Service]
#Environment=
Type=simple
User=xbro
Group=xbro
WorkingDirectory=/srv/xbrowsersync/api
#ExecStartPre=
ExecStart=node dist/api.js
#ExecStop=
KillSignal=SIGINT
#ExecStopPost=
#RemainAfterExit=
Restart=on-failure
RestartSec=30
[Install]
WantedBy=multi-user.target
Activer le nouveau service :
systemctl --system daemon-reload
systemctl enable --now xbrowsersync.service
systemctl status xbrowsersync.service
On peut tester un redémarrage et vérifier que le service s'exécute bien :
systemclt reboot
# Après redémarrage et reconnexion en root
systemctl status xbrowsersync.service
===== Reverse-proxy via Nginx =====
===== Références =====
* [[https://github.com/xbrowsersync/api/tree/v1.1.13|GitHub du projet xBrowserSync]]
* [[https://nodejs.org/fr/download|Installer Node.js (nodejs.org)]]
* [[https://openclassrooms.com/fr/courses/1733551-gerez-votre-serveur-linux-et-ses-services/5236081-mettez-en-place-un-reverse-proxy-avec-nginx|Configurer un reverse-proxy avec Nginx (openclassrooms.com)]]