Postgres proxy

This extension may be referenced by the qualified name


This extension is not hardened and should only be used in deployments where both the downstream and upstream are trusted.


This extension extends and can be used with the following extension category:


This API is work-in-progress and is subject to breaking changes.

Postgres Proxy configuration overview.

[ proto]

  "stat_prefix": "...",
  "enable_sql_parsing": "{...}",
  "terminate_ssl": "..."

(string, REQUIRED) The human readable prefix to use when emitting statistics.


(BoolValue) Controls whether SQL statements received in Frontend Query messages are parsed. Parsing is required to produce Postgres proxy filter metadata. Defaults to true.


(bool) Controls whether to terminate SSL session initiated by a client. If the value is false, the Postgres proxy filter will not try to terminate SSL session, but will pass all the packets to the upstream server. If the value is true, the Postgres proxy filter will try to terminate SSL session. In order to do that, the filter chain must use starttls transport socket. If the filter does not manage to terminate the SSL session, it will close the connection from the client. Refer to official documentation for details SSL Session Encryption Message Flow.