Configuring reverse proxy by Nginx

Start Nginx

1. Unzip nginx to the specified directory
2. In the root directory of nginx, start nginx by the following command:

start nginx

Exit nginx:

nginx –s quit

3. check whether to start nginx normally with two ways:

• Open Task Manager to see whether the nginx process is started.
• Access http://127.0.0.1 or http://localhost, if it shows “Welcome to nginx!”, it means nginx is started normally.

Configure Nginx

Open 【nginx installation directory】\conf\nginx.conf file, modify the server node under http node:

server {

listen 192.168.120.42:8000;

server_name www.myiserver.com;

location / iserver{

proxy_pass http://192.168.112.217:8090/iserver;

#proxy_set_header Host $host:8000;

proxy_set_header ProxyHost $host:8000; }

}

• Listen: proxy service listening port, 80 by default, it is recommended not to use the default one.
• server_name: proxy server name, usually uses the domain of the proxy server.
• proxy_pass: GIS service address to be forwarded, can be IP or domain.
• proxy_set_header: forward request head, only needed to set the service address. If not set, when accessing reverse proxy service, the page will be linked to the original GIS server not the current one. Set it by Host or ProxyHost:
• Host: parameter provided by nginx, such as: proxy_set_header Host $host:8000. This setting may cause other services in the current reverse proxy server unavailable.
• ProxyHost: SuperMap customized parameter, such as: proxy_set_header ProxyHost $host:8000. It's recommended to use ProxyHost to set the service address in the request head.

If the iServer service after nginx proxy is registered in the iPortal, and the service passes through the iPortal proxy, in order to ensure that the iServer service can be accessed normally after two proxies, it is recommended to set the Host parameter and ProxyHost parameter as: Host $http_host and ProxyHost $http_host.

Save above settings, restart nginx to enable it. Restart command:

nginx -s reload

If needed to configure multiple iServer reverse proxies, you can configure multiple server nodes in nginx.conf file.

Access service

Accessing the service address after reverse (http://192.168.120.42:8000/iserver) proxy can obtain the same content as accessing the original server

You also can map 192.168.120.42 for the domain name, just add the followings in C:\Windows\System32\drivers\etc\hosts:

192.168.120.42 www.myiserver.com

Then you can use this address: http://www.myiserver.com:8000/iserver.