Chapter 4. URL commands

URL commands can be used to show information about a webpage and to bypass certain features. For proxy requests, URL commands are prefixed onto the hostname of the website; for example, 'bypass..www.somesite.com" would bypass all types of filtering. For regular HTTP requests (such as when the proxy is being used to redirect HTTP requests), an extra path element is added to the front of the requested file with the URL command inside; for example, "http://proxyip:port/bypass../somefile". URL commands are not only taken from the request URL, but from the Referer header sent by your browser as well; this allows them to work for images and files loaded from a website a URL command was used on. Additionally, URL commands are automatically prefixed to the Location: header sent back when a 302 redirect is received or when a redirect rule that sends a 302 redirect matches. Below is a list of all available URL commands and a description of what they do.

Table 4-1. URL commands

bypassBypass some or all features; to specify which features to bypass, add a set of square brackets after the URL command with any of the following letters representing what features to bypass: 'f' (URL filter), 'r' (redirecting), 'w' (rewrite), 'h' (header filter), 'm' (MIME filter), 'c' (cookie filter), 'e' (external parser), 'p' (forwarding), 'k' (keyword filtering), 'd' (DNS blacklist), and 'l' (Limits). A '+' or '-' can be used to alternate between bypassing and un-bypassing a feature, incase it was bypassed already from the access rule. For example, "bypass[f-rw]..website.com" will bypass filtering, and un-bypass redirecting and rewriting.
filterShow which filter rule, if any, matches the requested URL.
mimeShow which mime rule, if any, matches the requested URL.
scoreShow the keyword score for the requested URL.
diffDisplay changes made by rewrite rules to requested URL.
cacheDisplay information about cached file.
offlineSend file only if it's cached, ignoring expiry time.
freshFetch a fresh copy of the file from the server.
headersShow client and server headers for requested URL.
rawShow raw contents of file or FTP directory listing.
proxytestTest a forwarding proxy by having it connect back and display headers.
htmltreeDisplay a parsed HTML tree for the specified URL.
profilesDisplay a list of profiles currently enabled for the requested URL.
mimeprofilesDisplay a list of profiles currently enabled for the requested URL, after matching the MIME-type's
httpsConnect to an SSL server, useful for non-SSL clients and for filtering content from SSL servers.
cookiesDisplay cookies sent by browser and received from website.