https://github.com/sternenseemann/gopher-proxy

relay http requests to a gopher server
https://github.com/sternenseemann/gopher-proxy

gopher haskell http proxy

Last synced: 26 days ago
JSON representation

relay http requests to a gopher server

• Host: GitHub
• URL: https://github.com/sternenseemann/gopher-proxy
• Owner: sternenseemann
• License: gpl-3.0
• Created: 2016-12-27T17:43:13.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-10-25T21:49:02.000Z (about 3 years ago)
• Last Synced: 2024-04-26T05:31:45.832Z (7 months ago)
• Topics: gopher, haskell, http, proxy
• Language: Haskell
• Homepage: https://hackage.haskell.org/package/gopher-proxy
• Size: 34.2 KB
• Stars: 11
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gopher-proxy

gopher-proxy is a tiny [wai](https://hackage.haskell.org/package/wai) application running on top of [warp](https://hackage.haskell.org/package/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`).

These are all optional flags which allow to change default behavior:

* `--port`: The port of the gopher server, defaults to `70`

* `--css-path`: 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 gopher-proxy can't guess it, defaults to "application/octet-stream"

* `--timeout`: connection timeout in milliseconds, defaults to 10 seconds.

* `--server-name`: The server name of the server to proxy, defaults to the host name. This value is used to detect wether a menu item is pointing to another gopher server than the proxied one. This is particularly useful, if you use e. g. `127.0.0.1` instead of the public host name.

* `--title`: Sets the first part of the HTML title-tag, defaults to `gopher-proxy`.

## Things to keep in mind

* Your gopher server must send UTF-8-encoded gopher responses

* gopher-proxy might misinterpret certain content, because of the context-sensitive nature of gopher

* gopher-proxy does not support Gopher+

## Roadmap

- [ ] Add Logging