{"id":18,"date":"2026-10-13T14:15:06","date_gmt":"2026-10-13T14:15:06","guid":{"rendered":"https:\/\/rf-diy.com\/?p=18"},"modified":"2026-10-13T14:18:09","modified_gmt":"2026-10-13T14:18:09","slug":"18","status":"publish","type":"post","link":"https:\/\/rf-diy.com\/index.php\/2026\/10\/13\/18\/","title":{"rendered":"Ngnix avec OpenWebRX+ sur Raspberry"},"content":{"rendered":"\n
Transformer son Raspberry Pi OpenWebRX+ en station multi-applications avec Nginx<\/h1>\n\n\n\n
En tant que radioamateur, vous avez sans doute configur\u00e9 une image OpenWebRX+<\/strong> sur votre Raspberry Pi pour \u00e9couter le spectre hertzien directement depuis un navigateur web. Par d\u00e9faut, OpenWebRX \u00e9coute sur le port 8073<\/code> (par exemple : [http:\/\/192.168.1.50:8073](http:\/\/192.168.1.50:8073)<\/code>).<\/p>\n\n\n\n
Cependant, dans votre shack, vous aimeriez s\u00fbrement ajouter d’autres services par la suite : un tableau de bord m\u00e9t\u00e9o, un client APRS, un carnet de trafic (logbook) en ligne ou un outil de pilotage de rotor d’antenne. Le probl\u00e8me ? Multiplier les adresses avec des num\u00e9ros de port diff\u00e9rents (:8073<\/code>, :8080<\/code>, :5000<\/code>) devient vite compliqu\u00e9 \u00e0 retenir.<\/p>\n\n\n\n
La solution consiste \u00e0 installer Nginx<\/strong> pour qu’il agisse comme un proxy invers\u00e9 (reverse proxy)<\/strong>, un v\u00e9ritable \u00ab\u00a0aiguilleur du ciel\u00a0\u00bb num\u00e9rique.<\/p>\n\n\n\n
Pas de panique si Linux ne vous est pas familier : cet article vous guide pas \u00e0 pas, avec des explications claires et des tests de v\u00e9rification \u00e0 chaque \u00e9tape.<\/p>\n\n\n\n
\u00c9tape 0 : Le bilan de sant\u00e9 pr\u00e9liminaire (V\u00e9rifications avant installation)<\/h2>\n\n\n\n
Avant d’installer de nouveaux logiciels sur le Raspberry Pi qui fait tourner votre r\u00e9cepteur SDR, il est prudent de v\u00e9rifier son \u00e9tat de sant\u00e9. C’est l’\u00e9quivalent de v\u00e9rifier le TOS et la tension d’alimentation avant d’allumer un amplificateur !<\/p>\n\n\n\n
\n
Connectez-vous en SSH \u00e0 votre Raspberry Pi :<\/strong>Ouvrez un terminal (sur Linux\/Mac) ou PuTTY (sur Windows) et tapez : Bashssh pi@<ip_de_votre_pi><\/code> (Remplacez <ip_de_votre_pi><\/code> par l’adresse IP locale de votre Raspberry Pi, par exemple 192.168.1.50<\/code>, puis entrez votre mot de passe).<\/em><\/li>\n\n\n\n
V\u00e9rifier l’espace disque disponible :<\/strong>Une carte SD satur\u00e9e plantera l’installation. Tapez la commande suivante : Bashdf -h<\/code> Regardez la ligne \/<\/code> (ou racine). Assurez-vous d’avoir au moins 1 Go ou 2 Go d’espace libre<\/strong> pour \u00eatre tranquille.<\/li>\n\n\n\n
V\u00e9rifier si le port 80 est d\u00e9j\u00e0 occup\u00e9 :<\/strong>Puisque Nginx va utiliser le port HTTP standard (80<\/code>), v\u00e9rifions qu’aucun autre service ne l’utilise d\u00e9j\u00e0 : Bashsudo ss -tulpn | grep :80<\/code>\n
\n
Si la commande ne renvoie rien :<\/strong> C’est parfait, le port 80 est libre.<\/li>\n\n\n\n
Si une ligne appara\u00eet :<\/strong> Un autre serveur web tourne peut-\u00eatre d\u00e9j\u00e0 en arri\u00e8re-plan.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
Rafra\u00eechir les listes de paquets (Test de connexion Internet) :<\/strong> Bashsudo apt update<\/code> Cette commande interroge les serveurs officiels pour r\u00e9cup\u00e9rer les derni\u00e8res versions logicielles. Si elle s’ex\u00e9cute sans erreur r\u00e9seau, votre Pi est pr\u00eat.<\/li>\n<\/ol>\n\n\n\n
\u00c9tape 1 : Qu’est-ce que Nginx et comment l’installer ?<\/h2>\n\n\n\n
C’est quoi, Nginx ?<\/h3>\n\n\n\n
Imaginez Nginx comme le standardiste ou le r\u00e9partiteur d’un grand club radio : il se tient sur le port principal (le port 80, celui du web standard). Quand un visiteur tape l’adresse de votre Raspberry Pi, Nginx regarde ce qui est demand\u00e9 et redirige silencieusement le trafic vers la bonne application interne (comme OpenWebRX sur le port 8073, ou une future application sur un autre port).<\/p>\n\n\n\n
Installation<\/h3>\n\n\n\n
Installez Nginx via le gestionnaire de paquets de l’OS (qui g\u00e8re l’installation de mani\u00e8re automatis\u00e9e) :<\/p>\n\n\n\n
Explication des termes :<\/em>sudo<\/code> signifie \u00ab\u00a0ex\u00e9cuter en tant qu’administrateur\u00a0\u00bb (root), apt<\/code> est le gestionnaire de logiciels, install<\/code> demande l’installation, et -y<\/code> valide automatiquement les questions de confirmation.<\/li>\n<\/ul>\n\n\n\n
\u00c9tape 2 : Le premier grand test (V\u00e9rifier que Nginx tourne)<\/h2>\n\n\n\n
Une fois l’installation termin\u00e9e, le service doit d\u00e9marrer automatiquement. V\u00e9rifions son \u00e9tat :<\/p>\n\n\n\n
Bash<\/p>\n\n\n\n
sudo systemctl status nginx\n<\/code><\/pre>\n\n\n\n
\n
Le test de succ\u00e8s :<\/strong> Vous devriez voir du texte avec la mention en vert active (running)<\/code><\/strong>.<\/li>\n\n\n\n
Pour quitter cet \u00e9cran de statut, appuyez sur la touche q<\/code><\/strong> de votre clavier.<\/li>\n<\/ul>\n\n\n\n
Test visuel depuis un navigateur :<\/strong><\/p>\n\n\n\n
Ouvrez un navigateur web sur un ordinateur ou un smartphone connect\u00e9 au m\u00eame r\u00e9seau local, puis tapez simplement l’adresse IP de votre Raspberry Pi (ex: [http:\/\/192.168.1.50](http:\/\/192.168.1.50)<\/code>).<\/p>\n\n\n\n
\n
Si vous voyez une page indiquant \u00ab\u00a0Welcome to nginx!\u00a0\u00bb<\/strong>, bravo ! Le serveur web de base fonctionne parfaitement.<\/li>\n<\/ul>\n\n\n\n
\u00c9tape 3 : Configurer Nginx pour pointer vers OpenWebRX+<\/h2>\n\n\n\n
Actuellement, Nginx affiche sa page de bienvenue. Nous allons lui dire de renvoyer tout le trafic vers OpenWebRX (qui tourne en local sur le port 8073<\/code>).<\/p>\n\n\n\n\n
Supprimer la page par d\u00e9faut de Nginx :<\/strong> Bashsudo rm \/etc\/nginx\/sites-enabled\/default<\/code><\/li>\n\n\n\n
Cr\u00e9er un fichier de configuration pour OpenWebRX :<\/strong> Bashsudo nano \/etc\/nginx\/sites-available\/openwebrx<\/code> (L’\u00e9diteur de texte nano<\/code> s’ouvre dans votre terminal).<\/em><\/li>\n\n\n\n
Coller le bloc de configuration suivant :<\/strong>Utilisez le clic droit ou Ctrl+Shift+V<\/code> pour coller ce texte dans le terminal : Nginxserver { listen 80; server_name _; location \/ { proxy_pass http:\/\/127.0.0.1:8073; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \"upgrade\"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }<\/code>\n
\n
Note technique essentielle pour la radio :<\/strong> Les lignes contenant Upgrade<\/code> et Connection \"upgrade\"<\/code> sont indispensables. OpenWebRX utilise des WebSockets<\/strong> permanents pour transmettre en temps r\u00e9el le flux audio et le waterfall (le spectre radio). Sans ces lignes, l’interface figerait.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
Enregistrer et quitter nano :<\/strong>\n
\n
Appuyez sur Ctrl + O<\/code> puis sur Entr\u00e9e<\/code> pour enregistrer.<\/li>\n\n\n\n
Appuyez sur Ctrl + X<\/code> pour quitter l’\u00e9diteur.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
Activer la configuration :<\/strong>On cr\u00e9e un lien symbolique pour indiquer \u00e0 Nginx que ce site est actif : Bashsudo ln -s \/etc\/nginx\/sites-available\/openwebrx \/etc\/nginx\/sites-enabled\/<\/code><\/li>\n<\/ol>\n\n\n\n
\u00c9tape 4 : Le coin du d\u00e9pannage (Tests de robustesse et d\u00e9bogage)<\/h2>\n\n\n\n
En radio, on v\u00e9rifie toujours son montage avant d’appuyer sur la p\u00e9dale PTT. En informatique, c’est pareil : il faut tester la syntaxe de configuration avant de red\u00e9marrer le serveur.<\/p>\n\n\n\n
Test 1 : Le \u00ab\u00a0TOSm\u00e8tre\u00a0\u00bb de Nginx (V\u00e9rification de la syntaxe)<\/h3>\n\n\n\n
Tapez la commande de test :<\/p>\n\n\n\n
Bash<\/p>\n\n\n\n
sudo nginx -t\n<\/code><\/pre>\n\n\n\n
\n
R\u00e9sultat attendu :<\/strong>nginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok<\/code>nginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/code><\/li>\n\n\n\n
En cas d’erreur :<\/strong> Nginx vous indiquera pr\u00e9cis\u00e9ment le num\u00e9ro de ligne o\u00f9 se trouve l’erreur (souvent un point-virgule ;<\/code> oubli\u00e9 dans le fichier de configuration).<\/li>\n<\/ul>\n\n\n\n
Test 2 : Recharger le service proprement<\/h3>\n\n\n\n
Si le test de syntaxe est valid\u00e9, appliquez les modifications en rechargeant Nginx :<\/p>\n\n\n\n
Test 3 : En cas de panne (Que faire si la page ne s’affiche pas ?)<\/h3>\n\n\n\n
Si en tapant l’adresse IP de votre Pi vous obtenez une erreur de type \u00ab\u00a0502 Bad Gateway\u00a0\u00bb ou que la page ne charge pas :<\/p>\n\n\n\n
\n
V\u00e9rifiez qu’OpenWebRX tourne toujours en arri\u00e8re-plan :<\/strong> Bashsudo systemctl status openwebrx<\/code><\/li>\n\n\n\n
Consultez les journaux d’erreurs (logs) de Nginx pour comprendre le probl\u00e8me :<\/strong> Bashsudo tail -n 20 \/var\/log\/nginx\/error.log<\/code> Cette commande affiche les 20 derni\u00e8res lignes du journal d’erreurs, ce qui vous mettra imm\u00e9diatement sur la piste (probl\u00e8me de port, erreur de frappe, etc.).<\/li>\n<\/ol>\n\n\n\n
\u00c9tape 5 : Pr\u00e9parer l’avenir pour vos autres applications web<\/h2>\n\n\n\n
D\u00e9sormais, lorsque vous tapez simplement l’adresse IP de votre Raspberry Pi dans votre navigateur (ex: [http:\/\/192.168.1.50](http:\/\/192.168.1.50)<\/code>), Nginx intercepte la requ\u00eate sur le port 80 et affiche directement votre interface OpenWebRX, sans avoir besoin d’ajouter :8073<\/code><\/strong>.<\/p>\n\n\n\n
Le port 80 \u00e9tant maintenant g\u00e9r\u00e9 de main de ma\u00eetre par Nginx, vous \u00eates dans une position id\u00e9ale pour le futur :<\/p>\n\n\n\n
\n
Quand vous installerez un nouvel outil web (un dashboard de suivi m\u00e9t\u00e9o, un logbook partag\u00e9, etc.), il vous suffira de le faire tourner sur un port interne distinct (ex: port 8080<\/code>).<\/li>\n\n\n\n
Vous cr\u00e9erez un nouveau fichier de configuration dans Nginx (ou utiliserez des sous-dossiers \/ sous-domaines) pour aiguiller proprement les requ\u00eates.<\/li>\n<\/ul>\n\n\n\n
Bonne installation, bons bricolages informatiques et 73 \u00e0 tous !<\/p>\n\n\n\n
<\/p>\n\n\n\n<\/figure>\n\n\n\n
Voici une FAQ (Foire aux Questions) en 10 points pour vous accompagner dans l’installation et la compr\u00e9hension de Nginx sur votre Raspberry Pi OpenWebRX+ :<\/p>\n\n\n\n
1. Pourquoi installer Nginx alors qu’OpenWebRX+ fonctionne d\u00e9j\u00e0 tr\u00e8s bien tout seul ?<\/h2>\n\n\n\n
OpenWebRX+ \u00e9coute par d\u00e9faut sur le port 8073<\/code>. Nginx agit comme un proxy invers\u00e9<\/strong> (un aiguilleur) qui centralise tout le trafic sur le port HTTP standard (80<\/code>). Cela vous \u00e9vite d’avoir \u00e0 taper des num\u00e9ros de port \u00e0 rallonge et vous pr\u00e9pare \u00e0 h\u00e9berger d’autres applications sur le m\u00eame Raspberry Pi.<\/p>\n\n\n\n
2. Ai-je besoin de comp\u00e9tences avanc\u00e9es en programmation ou sous Linux pour r\u00e9aliser cette installation ?<\/h2>\n\n\n\n
Non, absolument pas.<\/strong> Le tutoriel est con\u00e7u pour \u00eatre accessible \u00e0 tous les radioamateurs. Il vous suffit d’utiliser un terminal pour copier-coller les commandes indiqu\u00e9es, chaque \u00e9tape \u00e9tant expliqu\u00e9e en d\u00e9tail pour comprendre son r\u00f4le (un peu comme le manuel d’un kit radio).<\/p>\n\n\n\n
3. Pourquoi est-il indispensable de faire un bilan de sant\u00e9 pr\u00e9liminaire (\u00c9tape 0) ?<\/h2>\n\n\n\n
C’est l’\u00e9quivalent de v\u00e9rifier le TOS et l’alimentation avant d’allumer un amplificateur. V\u00e9rifier l’espace disque (df -h<\/code>) et l’occupation du port 80<\/code> \u00e9vite les pannes d’installation dues \u00e0 une carte SD satur\u00e9e ou \u00e0 un conflit de port.<\/p>\n\n\n\n
4. Que faire si le port 80 est d\u00e9j\u00e0 utilis\u00e9 par un autre service sur mon Raspberry Pi ?<\/h2>\n\n\n\n
Si la commande de v\u00e9rification du port 80 renvoie un r\u00e9sultat, cela signifie qu’un autre serveur web (comme Apache) tourne d\u00e9j\u00e0. Il faudra soit d\u00e9sinstaller ce service concurrent, soit l’arr\u00eater pour lib\u00e9rer la place indispensable \u00e0 Nginx.<\/p>\n\n\n\n
5. \u00c0 quoi servent les lignes Upgrade<\/code> et Connection \"upgrade\"<\/code> dans la configuration Nginx d’OpenWebRX ?<\/h2>\n\n\n\n
Ces lignes sont cruciales<\/strong> pour la radio logicielle. OpenWebRX utilise des WebSockets<\/strong> permanents pour actualiser en temps r\u00e9el le waterfall (spectre) et diffuser l’audio. Sans ces instructions, l’interface web figerait ou n’afficherait pas le spectre correctement.<\/p>\n\n\n\n
6. Comment puis-je m’assurer que ma configuration Nginx ne contient pas d’erreur avant de l’appliquer ?<\/h2>\n\n\n\n
Avant de red\u00e9marrer le serveur, vous devez lancer le test de syntaxe avec la commande sudo nginx -t<\/code>. C’est le \u00ab\u00a0TOSm\u00e8tre\u00a0\u00bb de Nginx : il valide la syntaxe et vous signale pr\u00e9cis\u00e9ment la ligne en erreur (un oubli de point-virgule par exemple) si le fichier a \u00e9t\u00e9 mal modifi\u00e9.<\/p>\n\n\n\n
7. J’obtiens une erreur \u00ab\u00a0502 Bad Gateway\u00a0\u00bb en essayant d’acc\u00e9der \u00e0 OpenWebRX, que se passe-t-il ?<\/h2>\n\n\n\n
Cette erreur indique que Nginx est bien d\u00e9marr\u00e9, mais qu’il ne parvient pas \u00e0 communiquer avec OpenWebRX. V\u00e9rifiez en priorit\u00e9 que le service OpenWebRX tourne toujours en arri\u00e8re-plan \u00e0 l’aide de la commande sudo systemctl status openwebrx<\/code>.<\/p>\n\n\n\n
8. O\u00f9 puis-je trouver de l’aide ou lire les journaux de bord (logs) en cas de panne ?<\/h2>\n\n\n\n
En cas de dysfonctionnement, Nginx enregistre tout dans un journal. Vous pouvez afficher les 20 derni\u00e8res erreurs enregistr\u00e9es avec la commande :<\/p>\n\n\n\n
Cela vous donnera un indice pr\u00e9cieux sur la nature du probl\u00e8me.<\/p>\n\n\n\n
9. Comment pourrai-je ajouter une nouvelle application web (ex: un carnet de trafic ou un suivi m\u00e9t\u00e9o) par la suite ?<\/h2>\n\n\n\n
Il vous suffira de lancer votre nouvelle application sur un port interne distinct (par exemple le port 8080<\/code>), puis de cr\u00e9er un nouveau fichier de configuration dans Nginx pour rediriger le trafic vers ce port via un sous-dossier ou un sous-domaine.<\/p>\n\n\n\n
10. Nginx me permettra-t-il de s\u00e9curiser l’acc\u00e8s \u00e0 mon Raspberry Pi depuis l’ext\u00e9rieur de chez moi ?<\/h2>\n\n\n\n
Oui.<\/strong> Nginx est la brique de base incontournable si vous souhaitez plus tard installer un certificat de s\u00e9curit\u00e9 SSL\/TLS (HTTPS) via des outils comme Certbot, ou ajouter une protection par mot de passe pour vos applications.<\/p>\n\n\n\n
Transformer son Raspberry Pi OpenWebRX+ en station multi-applications avec Nginx En tant que radioamateur, vous avez sans doute configur\u00e9 une image OpenWebRX+ sur votre Raspberry Pi pour \u00e9couter le spectre hertzien directement depuis un navigateur web. Par d\u00e9faut, OpenWebRX \u00e9coute sur le port 8073 (par exemple : [http:\/\/192.168.1.50:8073](http:\/\/192.168.1.50:8073)). Cependant, dans votre shack, vous aimeriez s\u00fbrement […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-18","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/posts\/18","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/comments?post=18"}],"version-history":[{"count":2,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/posts\/18\/revisions"}],"predecessor-version":[{"id":23,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/posts\/18\/revisions\/23"}],"wp:attachment":[{"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/media?parent=18"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/categories?post=18"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rf-diy.com\/index.php\/wp-json\/wp\/v2\/tags?post=18"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"\"](\"https:\/\/rf-diy.com\/wp-content\/uploads\/2026\/10\/Gemini_Generated_Image_ajlh0eajlh0eajlh-1024x559.jpg\")
<\/figure>\n\n\n\n