doc/tips/using_a_proxy.mdwn

   1 Some ikiwiki plugins make outgoing HTTP requests from the web server:
   2
   3 * [[plugins/aggregate]] (to download Atom and RSS feeds)
   4 * [[plugins/blogspam]] (to check whether a comment or edit is spam)
   5 * [[plugins/openid]] (to authenticate users)
   6 * [[plugins/pinger]] (to ping other ikiwiki installations)
   7
   8 If your ikiwiki installation cannot contact the Internet without going
   9 through a proxy, you can configure this in the [[setup file|setup]] by
  10 setting environment variables:
  11
  12     ENV:
  13         http_proxy: "http://proxy.example.com:8080"
  14         https_proxy: "http://proxy.example.com:8080"
  15         # optional
  16         no_proxy: ".example.com,www.example.org"
  17
  18 Note that some plugins will use the configured proxy for all destinations,
  19 even if they are listed in `no_proxy`.
  20
  21 To avoid server-side request forgery attacks, ensure that your proxy does
  22 not allow requests to addresses that are considered to be internal.