Proxy example configuration

Proxy example configuration

We commonly use nginx and/or apache2 for the project, here are the configurations we usually set for development/debugging purposes

Nginx

# Simple http proxy
server {
    listen 8989;
    server_name localhost;	

    # Static grunt server
    location / {
        # Use grunt server (require grunt serve command)
        proxy_pass  http://localhost:9001;

        # OR serve static files directly :
        # charset utf-8;
        # root /path/to/docdoku-web-front/dist;
        # expires 0d;
        # access_log off;
    }

    # Webservices REST
    location /api {
        proxy_pass  http://localhost:8080;
    }    

    # Websocket application
    location /ws {
        proxy_pass http://localhost:8080/ws;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";	
        proxy_read_timeout 7200s;
    }
}

# Simple https proxy
server {
    listen 8787;
    server_name localhost;

    # SSL Configuration
    ssl on;
    ssl_certificate     /path/to/local.crt;
    ssl_certificate_key    /path/to/local.key;

    # Static grunt server or static files
    location / {
        # Use grunt server (require grunt serve command)
        proxy_pass  http://localhost:9001;

        # OR serve static files directly :
        # charset utf-8;
        # root /path/to/docdoku-web-front/dist;
        # expires 0d;
        # access_log off;
    }

    # Webservices REST
    location /api {
    proxy_pass  https://localhost:8181;
    }    

    # Websocket application
    location /ws {
        proxy_pass https://localhost:8181/ws;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";	
        proxy_read_timeout 7200s;
    }
}

Apache2 virtualhost configuration

<VirtualHost *:8889>

    ServerName localhost
    DocumentRoot /path/to/docdoku-web-front/dist

    ProxyPreserveHost On
    ProxyRequests Off
    RewriteEngine On

    RewriteCond %{REQUEST_URI}  ^/ws    [NC]
    RewriteCond %{QUERY_STRING} transport=websocket    [NC]
    RewriteRule /(.*)           ws://localhost:8080/ws/$1 [P,L]

    ProxyPass /ws ws://localhost:8080/ws
    ProxyPassReverse /ws ws://localhost:8080/ws

    ProxyPass /api http://localhost:8080/api
    ProxyPassReverse /api http://localhost:8080/api


    <Directory />
            Options FollowSymLinks
            AllowOverride None
    </Directory>

    <Directory /path/to/docdoku-web-front/dist>
            Require all granted
    </Directory>

</VirtualHost>

You may need to add to /etc/apache2/ports.conf

Listen 8889

Apache required modules :

$ a2enmod proxy proxy_http proxy_wstunnel rewrite