Skip to content

Proxying

makeworld edited this page Dec 16, 2020 · 7 revisions

Make sure that you've read the configuration wiki page first.

Proxies are Gemini servers that allow you to request a different URL scheme, but return back data using the Gemini protocol. For example, a Gopher proxy would allow you to request a gopher:// URL, but would maybe return back gemtext.

In Amfora you can specify these proxies so that certain types of URLs will not require opening another application.

Config

[proxies]
# Allows setting a Gemini proxy for different schemes.
# The settings are similar to the url-handlers section above.
# E.g. to open a gopher page by connecting to a Gemini proxy server:
#   gopher = "example.com:123"
#
# Port 1965 is assumed if no port is specified.
#
# NOTE: These settings override any external handlers specified in
# the url-handlers section.
#
# Note that HTTP and HTTPS are treated as separate protocols here.

Note that Amfora also allows specifying external handlers for different URL schemes in the [url-handlers] section of the config file. More information regarding them can be found in the Handling Other URL Schemes. The proxy settings override these settings.

Known Proxies

The following are some of the X-to-Gemini proxies that exist. Feel free to make an issue or contact me to get more added to this list.

  • Duckling: A HTTP/HTTPS to Gemini proxy
  • Agena: A Gopher to Gemini proxy