Reverse Proxy Recipe

How to use Echo as a reverse proxy server?

This recipe demonstrates how you can use Echo as a reverse proxy server and load balancer in front of your favorite applications like WordPress, Node.js, Java, Python, Ruby or even Go. For simplicity, I will use Go upstream servers with WebSocket.

Step 1: Identify upstream target URLs

  1. url1, err := url.Parse("http://localhost:8081")
  2. if err != nil {
  3.   e.Logger.Fatal(err)
  4. }
  5. url2, err := url.Parse("http://localhost:8082")
  6. if err != nil {
  7.   e.Logger.Fatal(err)
  8. }
  9. targets := []*middleware.ProxyTarget{
  10.   {
  11.     URL: url1,
  12.   },
  13.   {
  14.     URL: url2,
  15.   },
  16. }

Step 2: Setup proxy middleware with upstream targets

In the following code snippet we are using round-robin load balancing technique. You may also use middleware.NewRandomBalancer().

  1. e.Use(middleware.Proxy(middleware.NewRoundRobinBalancer(targets)))

To setup proxy for a sub-route use Echo#Group().

  1. g := e.Group("/blog")
  2. g.Use(middleware.Proxy(...))

Step 3: Start upstream servers

  • cd upstream
  • go run server.go server1 :8081
  • go run server.go server2 :8082

Step 3: Start the proxy server

  1. go run server.go

Step 4: Browse to http://localhost:1323

You should see a webpage with HTTP request being served from “server 1” and WebSocket request from “server 2”.

  1. HTTP
  3. Hello from upstream server server1
  5. WebSocket
  7. Hello from upstream server server2!
  8. Hello from upstream server server2!
  9. Hello from upstream server server2!

Source Code

upstream/server.go

  1.  

server.go

  1.  

Maintainers