walkero
/
nghttp2
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

Update doc

This commit is contained in:
Tatsuhiro Tsujikawa 2015-03-11 00:16:29 +09:00
parent a0524ef05d
commit 5789987ca3
1 changed files with 22 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/sources/nghttpx-howto.rst
View File

@ -59,11 +59,11 @@ SPDY protocols and it works as so called SPDY proxy.
With ``--frontend-no-tls`` option, SSL/TLS is turned off in frontend With ``--frontend-no-tls`` option, SSL/TLS is turned off in frontend
connection, so the connection gets insecure. connection, so the connection gets insecure.
The backend must be HTTP/1 proxy server. nghttpx only supports The backend must be HTTP/1 proxy server. nghttpx supports multiple
multiple backend server addresses. It translates incoming requests to backend server addresses. It translates incoming requests to HTTP/1
HTTP/1 request to backend server. The backend server performs real request to backend server. The backend server performs real proxy
proxy work for each request, for example, dispatching requests to the work for each request, for example, dispatching requests to the origin
origin server and caching contents. server and caching contents.
For example, to make nghttpx listen to encrypted HTTP/2 requests at For example, to make nghttpx listen to encrypted HTTP/2 requests at
port 8443, and a backend HTTP/1 proxy server is configured to listen port 8443, and a backend HTTP/1 proxy server is configured to listen
@ -124,7 +124,9 @@ HTTP/1 frontend connection can be upgraded to HTTP/2 using HTTP
Upgrade. To disable SSL/TLS in backend connection, use Upgrade. To disable SSL/TLS in backend connection, use
``--backend-no-tls`` option. ``--backend-no-tls`` option.
The backend connection is created one per worker (thread). By default, the number of backend HTTP/2 connections per worker
(thread) is determined by number of ``-b`` option. To adjust this
value, use ``--backend-http2-connections-per-worker`` option.
The backend server is supporsed to be a HTTP/2 web server (e.g., The backend server is supporsed to be a HTTP/2 web server (e.g.,
nghttpd). The one use-case of this mode is utilize existing HTTP/1 nghttpd). The one use-case of this mode is utilize existing HTTP/1
@ -156,7 +158,9 @@ HTTP/1 frontend connection can be upgraded to HTTP/2 using HTTP
Upgrade. To disable SSL/TLS in backend connection, use Upgrade. To disable SSL/TLS in backend connection, use
``--backend-no-tls`` option. ``--backend-no-tls`` option.
The backend connection is created one per worker (thread). By default, the number of backend HTTP/2 connections per worker
(thread) is determined by number of ``-b`` option. To adjust this
value, use ``--backend-http2-connections-per-worker`` option.
The backend server must be a HTTP/2 proxy. You can use nghttpx in The backend server must be a HTTP/2 proxy. You can use nghttpx in
`HTTP/2 proxy mode`_ as backend server. The one use-case of this mode `HTTP/2 proxy mode`_ as backend server. The one use-case of this mode
@ -196,6 +200,10 @@ With ``--frontend-no-tls`` option, SSL/TLS is turned off in frontend
connection, so the connection gets insecure. To disable SSL/TLS in connection, so the connection gets insecure. To disable SSL/TLS in
backend connection, use ``--backend-no-tls`` option. backend connection, use ``--backend-no-tls`` option.
By default, the number of backend HTTP/2 connections per worker
(thread) is determined by number of ``-b`` option. To adjust this
value, use ``--backend-http2-connections-per-worker`` option.
The backend server is supporsed to be a HTTP/2 web server or HTTP/2 The backend server is supporsed to be a HTTP/2 web server or HTTP/2
proxy. If backend server is HTTP/2 proxy, use proxy. If backend server is HTTP/2 proxy, use
``--no-location-rewrite`` and ``--no-host-rewrite`` options to disable ``--no-location-rewrite`` and ``--no-host-rewrite`` options to disable
@ -285,11 +293,11 @@ re-open log files, send USR1 signal to nghttpx process. It will
re-open files specified by ``--accesslog-file`` and re-open files specified by ``--accesslog-file`` and
``--errorlog-file`` options. ``--errorlog-file`` options.
Multiple HTTP/1 backend addresses Multiple backend addresses
--------------------------------- --------------------------
nghttpx supports multiple HTTP/1 backend addresses. To specify them, nghttpx supports multiple backend addresses. To specify them, just
just use ``-b`` option repeatedly. For example, to use backend1:8080 use ``-b`` option repeatedly. For example, to use backend1:8080 and
and backend2:8080, use command-line like this: ``-bbackend1,8080 backend2:8080, use command-line like this: ``-bbackend1,8080
-bbackend2,8080``. Please note that HTTP/2 backend only supports 1 -bbackend2,8080``. For HTTP/2 backend, see also
backend address. ``--backend-http2-connections-per-worker`` option.