fproxy 0.1 -- Freenet web proxy server


INTRODUCTION

This is fproxy, a web proxy which allows you to use a web browser as a
Freenet client.  It differs from FCRC in that it runs as a standalone
server and does not require you to run a webserver or have CGI access.



INSTALLATION

fproxy must be installed in the same tree as your Freenet installation.
It should live in the path Freenet/contrib/fproxy.  Compile fproxy by typing
'make' (Unix) or 'build' (Windows), or by typing 'javac ProxyServer.java'.

(Note: Your classpath must include the directory ABOVE Freenet/, the same
as if you were compiling Freenet itself.)



USAGE

Start the proxy server with 'fproxy [options]', or 'fproxy -help' to
see a list of options.  It will start listening on a local port
(default 80) for HTTP connections, and forward requests on to the
Freenet node specified at startup.  Usually this will be your local
node at tcp/localhost:19114.  Hops-to-live are currently set at
startup time as well.

Now URLs like:

          http://localhost/somekeyinfreenet

should load directly into your web browser.  If any errors are
encountered, they will be shown in your browser window.

Depending on your browser, you may be able to get away with typing:

          localhost/somekeyinfreenet
or even:  somekeyinfreenet

if you configure your proxy settings to point at localhost:80,
although you may have trouble with your browser adding "/" to the end
of keys or looking up www.localhost.com.

You are strongly advised to run a local Freenet node and use that to
connect to.  Like any client, browsing a remote node directly is a
security risk, as any idiosyncratic differences in operation might be
sufficient to identify it as a client, circumventing your anonymity as
a requester.



FURTHER INFORMATION

For updates on fproxy, see http://www.doc.ic.ac.uk/~twh1/fproxy/
For more information on Freenet, see http://freenet.sourceforge.net/



AUTHOR

fproxy was written by Theodore Hong.  Comments should be directed to
t.hong@doc.ic.ac.uk, or see my website: http://www.doc.ic.ac.uk/~twh1/.



LICENSE

Copyright (c) 2000 Theodore Hong.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.

For more details, see the file COPYING.











