Merged Into MassBrowser
The current CacheBrowser software is a research prototype implementation, and is not yet ready for end-users. If you are a researcher or developer check it out and give us feedback, otherwise please be patient while we work on an end-user version of the code. Thanks for your understanding and support!
pip install cachebrowser
To run the CacheBrowser process simply enter the
You can then use CacheBrowser by using the CacheBrowser plugin for your browser or by setting the HTTP and HTTPS proxy on your browser to
In order to be able to browse a page using CacheBrowser, the page must first be bootstrapped. What this means is that CacheBrowser must first find out what CDN the page is hosted on and also obtain some edge server addresses for that CDN.
CacheBrowser supports local and remote bootstrapping sources. Local bootstrapping sources are files in YAML format which provide bootstrapping information for hosts and CDNs. Remote bootstrapping sources are RESTful services which provide bootstrapping information through HTTP requests.
Configuring Bootstrapping Sources
Any number of local or remote bootstrapping sources may be defined in the CacheBrowser configuration file. When bootstrapping a host or host, CacheBrowser will go through the provided sources in the specified order until the information is found.
Bootstrapping sources can be specified in the configuration file using the
bootstrapper_sources key, for example:
boostrapper_sources: - type: local path: local_bootstrapper.yaml - type: remote url: https://bootstrap.cachebrowser.net/api
Local Boostrapping Files
A local bootstrapping file is a YAML file containing a list of Host or CDN information.
- type: cdn id: akamai name: Akamai edge_servers: - 188.8.131.52 - 184.108.40.206 - type: host name: www.nbc.com ssl: false cdn: akamai - type: host name: www.bloomberg.com ssl: false cdn: akamai
For each CDN provided in the bootstrapping file the following information should be provided:
|id||A unique ID to be used for the CDN|
|name||The CDN Name|
|edge_servers||List of edge server addresses for the CDN|
For each Host provided in the bootstrapping file the following information should be provided:
|cdn||The ID of the CDN which provides this host|
|ssl||Whether the pages supports HTTPS connections or not|
You could also run a command with CacheBrowser:
These are the valid commands you could give:
|host list||Lists the bootstrapped hosts|
|host add||Add host info|
|cdn list||Lists the bootstrapped CDNs|
|cdn add||Add host info|
cachebrowser bootstrap www.nbc.com cachebrowser get http://www.nbc.com cachebrowser get https://www.istockphoto.com 220.127.116.11