@hackage gopher-proxy0.1.0.1

proxy gopher over http

gopher-proxy

gopher-proxy is a tiny wai application running on top of warp. It acts as a gopher-over-http proxy for a specific server, e. g. to http-ify a gopher space.

Usage

Example usage:

gopher-proxy --host foo.org --http-port 8080

In this particular example, gopher-proxy would proxy the foo.org gopher server and bind its http service on 127.0.0.1:8080 (to be proxied to by another web server like nginx).

There are these additional flags which allow tweaking of exact behavior as well:

option meaning
--port The port of the gopher server, defaults to 70
--css-url Use some specific css file instead of the default one.
--css-url The http path of the css file, defaults to /gopher-proxy.css (should be changed, if your gopher server has a file with the same name
--base-url The path of the directory which will appear as root directory of gopher-proxy to the user, defaults to /. Should be changed if you configured your proxying web server to expose gopher-proxy as, say /gopher-space/.
--listen-public If this flag is set, gopher-proxy will accept connections on its public IP address(es).
--default-mime-type Mime type to use if spacecookie can't guess it, defaults to "application/octet-stream"
--timeout Timeout when connecting in milliseconds, defaults to 10 seconds.

Things to keep in mind

  • Your gopher server must send UTF-8-encoded gopher menus
  • gopher-proxy might misinterpret certain content, because of the context-sensitive nature of gopher
  • gopher-proxy does not support Gopher+

Roadmap

[ ] Add Logging