Go to file

James Hu 4fc6945f69 Explicitly require Addressable		2016-09-13 17:13:24 -07:00
lib	Explicitly require Addressable	2016-09-13 17:13:24 -07:00
.document	Initial commit to rails-reverse-proxy.	2015-06-04 19:22:09 -07:00
.gitignore	Initial commit to rails-reverse-proxy.	2015-06-04 19:22:09 -07:00
Gemfile	Replace the parsing cookie logic instead of cookiejar gem	2015-08-27 18:51:26 +09:00
Gemfile.lock	Replace the parsing cookie logic instead of cookiejar gem	2015-08-27 18:51:26 +09:00
LICENSE.txt	Initial commit to rails-reverse-proxy.	2015-06-04 19:22:09 -07:00
README.md	Add thanks to contributors	2015-08-27 23:27:42 -07:00
Rakefile	We don't use test and rdoc	2015-06-04 20:36:20 -07:00
VERSION	Version bump to 0.5.0	2015-08-27 23:24:44 -07:00
rails-reverse-proxy.gemspec	Regenerate gemspec for version 0.5.0	2015-08-27 23:25:44 -07:00

README.md

rails-reverse-proxy

Gives you the ability to reverse proxy within Rails.

Installation

You know the drill. In your Gemfile, have the line

gem 'rails-reverse-proxy'

Then (you guessed it!)

$ bundle

Usage

An example usage of this gem is hosting a WordPress site on a path within your Rails application, such as /blog. To do this, you'll need something like

class WordpressController < ApplicationController
  include ReverseProxy::Controller

  def index
    # Assuming the WordPress server is being hosted on port 8080
    reverse_proxy "http://localhost:8080" do |config|
      # We got a 404!
      config.on_missing do |code, response|
        redirect_to root_url and return
      end

      # There's also other callbacks:
      # - on_set_cookies
      # - on_response
      # - on_set_cookies
      # - on_success
      # - on_redirect
      # - on_missing
      # - on_error
      # - on_complete
    end
  end
end

Then in your routes.rb file, you should have something like

match 'blog/*path' => 'wordpress#index', via: [:get, :post, :put, :patch, :delete]

You can also pass options into reverse_proxy

reverse_proxy "http://localhost:8000", path: "custom-path", headers: { 'X-Foo' => "Bar" }

Sorry if these instructions are sparse. Feel free to reach out or read the source!

Contributing

All pull requests will become first class citizens.

Thanks

Special thanks to our contributors!

miyukki