OpenLiteSpeed logo Manuel utilisateur OpenLiteSpeed

Proxy WebSocket

WebSocket est un protocole qui peut etre utilise a la place de HTTP pour fournir une communication bidirectionnelle en temps reel sur Internet. A partir de la version 1.1.1, OpenLiteSpeed prend en charge les backends WebSocket au moyen de proxies WebSocket. Ces proxies envoient la communication WebSocket au backend approprie indique dans le champ Adresse.

Table des matières

Proxy WebSocket

URI

Description

Indique les URI qui utiliseront ce backend WebSocket. Le trafic vers cette URI ne sera transféré au backend WebSocket que s'il contient une demande d'upgrade WebSocket.

Le trafic sans cette demande d'upgrade sera automatiquement transféré au contexte auquel appartient cette URI. Si aucun contexte n'existe pour cette URI, LSWS traitera ce trafic comme s'il accédait à un contexte statique avec l'emplacement $DOC_ROOT/URI.

Syntaxe

Une URI simple (commençant par "/"). Si l’URI se termine par "/", ce backend WebSocket inclura toutes les sous-URI sous cette URI.

Exemple

Utiliser le proxy WebSocket avec un contexte permet de servir différents types de trafic de différentes façons sur la même page, ce qui optimise les performances. Vous pouvez envoyer le trafic WebSocket au backend WebSocket tout en configurant un contexte statique afin que LSWS serve le contenu statique de la page, ou un contexte LSAPI afin que LSWS serve le contenu PHP (dans les deux cas, LSWS le fait plus efficacement que le backend WebSocket).

Adresse

Description

Adresse de socket unique utilisée par le backend WebSocket. Les sockets IPv4, les sockets IPv6 et les Unix Domain Sockets (UDS) sont pris en charge. Les sockets IPv4 et IPv6 peuvent être utilisés pour la communication sur le réseau. UDS ne peut être utilisé que lorsque le backend WebSocket réside sur la même machine que le serveur.

Syntaxe

adresse IPv4/IPv6:port, UDS://chemin, ou unix:chemin

Exemple

127.0.0.1:5434
UDS://tmp/lshttpd/php.sock
unix:/tmp/lshttpd/php.sock

Conseils

Security Si le backend WebSocket fonctionne sur la même machine, UDS est préférable. Si vous devez utiliser un socket IPv4 ou IPv6, définissez l’adresse IP sur localhost ou 127.0.0.1 afin que le backend WebSocket soit inaccessible depuis d’autres machines.
Performance Les Unix Domain Sockets offrent généralement de meilleures performances que les sockets IPv4 ou IPv6.