Home | MacFreenet | ZeeProxy | Java libs
ZeeProxy
I wanted a way to store a web site in a compressed archive in my computer and browse it just as if I were browsing the on-line version of the site.
I could simply decompress the archive inside a folder and browse the folder, but then why did I compress it in the first place? To save space, of course. Besides, if the pages use absolute URLs, like
a link
the browser would have to connect to the internet in order to get the URL.
I developed ZeeProxy to solve this problem. It's a HTTP proxy that serves web sites stored inside archives, decompressing things on-the-fly, as needed.
ZeeProxy currently can serve sites stored inside the following types of archives:
- TAR files;
- TAR files compressed with RAZip;
- TAR files compressed with GZIP (things go really slow if the GZIP file is large);
INSTALLING
ZeeProxy uses some Java classes which can be found here.
If you use a Mac, just put the file elifarley_pkg.jar inside "System Folder:Extensions:MRJ Libraries:MRJClasses"
If you are not using MacOS, you should include the above file in your class path.RUNNING
To run ZeeProxy on a Macintosh, double click the "ZeeProxy app" icon. It will automatically detect and serve any supported archive named "default-arc" you put on the same folder as zeeproxy.jar. Instead of putting the file, you can use an alias to it.
To run ZeeProxy under an OS which has a command line interface, cd to the folder containing zeeproxy,jar, and type "java -cp zeeproxy.jar ZeeProxy [archive-name]", without quotes. If you ommit the optional archive-name parameter, it will try to use "default-arc" as the archive to serve.
After launching ZeeProxy, all you have to do is to configure your browser to use a HTTP proxy. Set appropriately the IP (try 127.0.0.1 to use the same machine you are on) and the port to 443.
Then you will be ready to browse the contents of the archive.
Let's suppose you downloaded the example file default-arc.tgz to the same folder zeeproxy.jar is located, renamed "default-arc.tgz" to "default-arc", launched ZeeProxy and configured your browser.
Now just type http://www.oocities.org/elifarley/index.html in your browser to see ZeeProxy working.
CHANGES FROM LAST VERSION:
ZeeProxy alpha 2 has been completely rewritten to take advantage of some new technologies, like:
- VersaStreamFactory (automatically detects compression format used in archive);
- RAZip format (improved random access performance);
- VersaFSFactory (automatically detects and mounts TAR and ZIP file systems; other file systems are planned in the future);
- Jandy web application framework (allows you to easily create web clients and servers);
For further information regarding these technologies, please visit
http://www.oocities.org/elifarley/javalibs/
CONVERTING FILES TO RAZIP FORMAT:
To create RAZip files or to convert your GZIP files to RAZip format (in order to get faster performance, for example), please take a look at the
RAZip home page
If you have any comments, please let me know.
ZeeProxy at SourceForge - You can download ZeeProxy from there too.
ZeeProxy source code ( 8k)
zeeproxy alpha 2 r2 ( 16k) - more convenient for Mac users.
zeeproxy alpha 2 r2 ( 13k) - more convenient for PC users.
default-arc compressed in GZIP format ( 78k) - Save this file in the same folder as zeeproxy.jar, and then rename it from default-arc.tgz to "default-arc"
default-arc compressed in RAZip format ( 78k) - Save this file in the same folder as zeeproxy.jar, and then rename it from "default-arc.pdf" to "default-arc"