Use APISix as Reverse Proxy

[felipemesturini]

How can I enable APISIX to work with a ReverseProxy?

I am using relative paths in HTML, for assets like JS and CSS

Example:

<VirtualHost *:80>
    ServerName pix.docs.local
    ServerAlias pix.docs.local
    
    ProxyRequests Off
    ProxyPreserveHost On
    
    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteCond %{REQUEST_URI} /+[^.]+$
        RewriteCond %{REQUEST_URI} !^(.*)/$
        RewriteRule ^(.*)$ %{REQUEST_URI}/ [R=301,L]
    </IfModule>
    
    ProxyPass /docs/ http://pix.docs.internal:8001/swagger/
    ProxyPassReverse /docs/ http://pix.docs.internal:8001/swagger/
    
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

[dosubot[bot]]

Hello @felipemesturini! I'm Dosu, your friendly bot here to help you tackle bugs, answer questions, and guide you in becoming a contributor. I'm looking forward to assisting you while we wait for a human maintainer.

To configure APISIX as a reverse proxy similar to your Apache setup, you can use the proxy-rewrite plugin to handle URI rewriting and host preservation. Here's how you can achieve this:

1. Proxy URI Rewriting: Use the proxy-rewrite plugin to rewrite the URI path. This is similar to the ProxyPass and ProxyPassReverse directives in Apache.

2. Preserve Host Header: To preserve the host header, similar to ProxyPreserveHost On, ensure that the Host header is set correctly in the request to the upstream server.

Here's an example configuration for APISIX:

{
    "uri": "/docs/*",
    "plugins": {
        "proxy-rewrite": {
            "uri": "/swagger/$1",
            "host": "pix.docs.internal"
        }
    },
    "upstream": {
        "nodes": {
            "pix.docs.internal:8001": 1
        },
        "type": "roundrobin"
    }
}

• URI Rewriting: The proxy-rewrite plugin rewrites the incoming /docs/ path to /swagger/, similar to your Apache configuration.
• Host Preservation: The host field in the proxy-rewrite plugin ensures that the host header is preserved when forwarding requests to the upstream server.

This setup should help you use APISIX as a reverse proxy while handling relative paths for static assets like JS and CSS. If you encounter issues with relative paths, consider ensuring that your application generates absolute paths or uses a base tag in HTML to resolve them correctly.

To continue talking to Dosu, mention @dosu.

---

^{Help Dosu learn! Give it feedback: Great Response | Irrelevant Answer | Incorrect Sources | Too Verbose | Hallucination | Bug Report | Other}