📄 ijbman.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"><html><head><!-- Copyright 1996-8 Junkbusters Corporation --><!-- This work comes with NO WARRANTY --><!-- It may be redistributed and modified under the GNU GPL--><!-- See the body of http://www.junkbusters.com/ht/en/gpl.html for details--><!-- Junkbusters is a registered trade mark of Junkbusters Corporation --><!-- Generated 1998/10/31 03:58:25 UTC --><meta name="Generator" content="Junkbusters Ebira $Revision: 1.276 $ $Date: 1998/09/25 23:54:00 $"><!-- Document ID: $Revision: 2.732 $ $Date: 1998/10/31 03:58:20 $ --><title>Internet Junkbuster Technical Information</title><base href="http://www.junkbusters.com/ht/en/ijbman.html"><meta name="description" content="The manual page for the Internet Junkbuster, free software to removes banner ads, cookies, and other stuff you don't want from your web browser."><meta name="keywords" content="stop, junk, busters, junkbusters, junkbuster, mail, email, e-mail, direct, spam, spamoff, declare, telemarketing, telemarketers, privacy, sharing, names, renting, direct, marketing, database, databases, junk mail, lists, environment, conservation, recycling, catalogs, consumer, sending, opt out "><link rel="next" href="cookies.html"><link rel="previous" href="ijbfaq.html"><link rel="contents" href="toc.html"></head><body bgcolor="#f8f8f0" link="#000078" alink="#ff0022" vlink="#787878"><center><h1><a name="top_of_page">Internet J<small>UNK<i><font color=red>BUSTER</font></i></small> Technical Information</a></h1></center><font face="arial, helvetica"><p align="center"><a href="#description">Options</a><font color="#ff0000"><b> · </b></font><a href="#show">Checking Options</a><font color="#ff0000"><b> · </b></font><a href="#install">Installation</a><font color="#ff0000"><b> · </b></font><a href="#copyright">Copyright</a><font color="#ff0000"><b> · </b></font><a href="ijbfaq.html#top_of_page">(FAQ)</a></p></font><br><center><h2><a name="man"><font face="arial, helvetica">Manual Page</font></a></h2></center><br>A copy of this pagein standard<big><kbd>man</kbd></big>macro formatis included in the<a href="ijbfaq.html#tar">tar archive</a>.<h3><a name="name" href="/cgi-bin/gp?pg=ijbman&pr=name"><img border=0 width=14 height=14 src="/images/fb.gif" alt="<Feedback>"></a> Name</h3><p><b><kbd>junkbuster</kbd></b>- TheInternet JunkbusterProxy<a href="legal.html#marks"><small><sup>TM</sup></small></a></p><h3><a name="synopsis" href="/cgi-bin/gp?pg=ijbman&pr=synopsis"><img border=0 width=14 height=14 src="/images/fb.gif" alt="<Feedback>"></a> Synopsis</h3><p><b><kbd>junkbuster</kbd></b><i>configfile</i>(Version 2.0 onwards)<br><b><kbd>junkbstr.exe</kbd></b><i>configfile</i>(Windows)<br><b><kbd>junkbuster</kbd></b><a href="#o_a">[-a]</a><a href="#o_y">[-y]</a><a href="#o_s">[-s]</a><a href="#o_c">[-c]</a><a href="#o_v">[-v]</a><br><a href="#o_u">[-u user_agent]</a><a href="#o_r">[-r referer]</a><a href="#o_t">[-t from]</a><br><a href="#o_b">[-b blockfile]</a><a href="#o_j">[-j jarfile]</a><a href="#o_l">[-l logfile]</a><br><a href="#o_w">[-w NAME=VALUE]</a><a href="#o_x">[-x Header_text]</a><br><a href="#o_h">[-h [bind_host_address][:bind_port]]</a><br><a href="#o_f">[-f forward_host[:port]]</a><a href="#o_d">[-d N]</a><br><a href="#o_g">[-g gw_protocol[:[gw_host][:gw_port]]]</a><br>(Version 1.4 and earlier)</p><h3><a name="description" href="/cgi-bin/gp?pg=ijbman&pr=description"><img border=0 width=14 height=14 src="/images/fb.gif" alt="<Feedback>"></a> Description</h3><p><b><kbd>junkbuster</kbd></b>is an instrumentable proxy that filters the <small>HTTP</small>stream betweenweb servers and browsers.Its main purpose is to enhance privacy.<p><a name="dual">Versions before 2.0 used command-line options;</a>Versions from 2.0 onward use a configuration file.The following descriptions of the options first give the oldercommand-line usage, then the new configfile line.<p><a name="won">In Versions 2.0.1 upwards on Windows,</a>a start-up message is printed and the configuration is read from the file<big><kbd>junkbstr.ini</kbd></big>if it exists and no argument was given.<p><a name="reread">All files except the configfile</a>are checked for changes before each page is fetched,so they may edited without restarting the proxy.<h4>Options</h4><dl><p><dt><i><a name="o_b">-b blockfile</a></i><br><a name="blockfile"><tt>blockfile</tt>  <i>blockfile</i></a><dd><a href="ijbfaq.html#blocking">Block</a>requests to<small>URL</small>smatching any pattern given in the lines of the<i>blockfile</i>.The<b><kbd>junkbuster</kbd></b>instead returns status 202, indicating that the request has been accepted(though not completed),and a<a href="ijbfaq.html#show">message identifying itself</a>(though the browser maydisplay only a broken image icon).(Versions before 2.0 returned an error 403 (Forbidden).)The syntax of a pattern is<big><kbd>[domain][:port][/path]</kbd></big>(the<big><kbd>http://</kbd></big>or<big><kbd>https://</kbd></big>protocol part is omitted).To decide if a pattern matches a target, the domains are compared first,then the paths. <p><a name="compare">To compare the domains,</a>the pattern domain and the targetdomain specified in the<small>URL</small>are each broken into their components.(Components are separated by the<big><kbd>.</kbd></big>(period) character.)Next each of the target componentsis compared with the corresponding pattern component: last with last,next-to-last with next-to-last, and so on.(This is called<i><dfn>right-anchored</dfn></i>matching.)If all of the pattern components find their match in the target,then the domains are considered a match.Case is irrelevant when comparing domain components.<p><a name="substring">A successfully</a>matching pattern can be an anchored substring of a target, butnot vice versa.Thus if a pattern doesn't specify a domain,it matches all domains.<a name="wildcard">Furthermore, when comparing two components,</a>the components must either match in their entirety or up to a wildcard<big><kbd>* </kbd></big>(star character) in the pattern. The wildcard featureimplements only a "prefix" match capability ("abc*" vs. "abcdefg"),not suffix matching ("*efg" vs. "abcdefg") orinfix matching ("abc*efg" vs. "abcdefg").The feature is restricted to the domain component;it is unrelated to the optionalregular expressionfeature in the path<a href="ijbman.html#regex">(described below).</a><p><a name="numeric">If a numeric port</a>is specified in the pattern domain, then the target port mustmatch as well. The default port in a target is port 80.<p><a name="onward">If the domain and port match,</a>then the target<small>URL</small>path is checked fora match against the path in the pattern.Paths are compared with a simple case-sensitiveleft-anchored substring comparison.Once again, the pattern can be ananchored substring of the target, but not vice versa.A path of<big><kbd>/</kbd></big>(slash) would match all paths. Wildcards are not considered inpath comparisons.<p><a name="example">For example, the target</a><small>URL</small><br>   <big><kbd>the.yellow-brick-road.com/TinMan/has_no_brain</kbd></big><br>would be matched (and blocked) by the following patterns<br>   <big><kbd>yellow-brick-road.com</kbd></big><br>and<br>   <big><kbd>Yellow*.COM</kbd></big><br>and<br>   <big><kbd>/TinM</kbd></big><br>but not<br>   <big><kbd>follow.the.yellow-brick-road.com</kbd></big><br>or<br>   <big><kbd>/tinman</kbd></big><br><p><a name="comments">Comments in a blockfile start with a</a><big><kbd>#</kbd></big>(hash) character and end at a new line.Blank lines are also ignored.<p><a name="except">Lines beginning with a</a><big><kbd>~</kbd></big>(tilde) character are taken to be<a href="ijbfaq.html#exceptions">exceptions:</a>a<small>URL</small>blocked by previous patterns that matches the rest ofthe line is let through. (The last match wins.)<p><a name="regex">Patterns</a>may contain<small>POSIX</small><a href="ijbfaq.html#regex">regular expressions</a>provided the<b><kbd>junkbuster</kbd></b>was compiled with this option(the default in Version 2.0 on).The idiom<big><kbd>/*.*/ad</kbd></big>can then be usedto match any<small>URL</small>containing<big><kbd>/ad</kbd></big>(such as<big><kbd>http://nomatterwhere.com/images/advert/g3487.gif</kbd></big>for example).These expressions<a href="ijbman.html#substring">don't work</a>in the domain part.<p><a name="rereads">In version 1.3 and later</a>the blockfile and cookiefile are checked for changes before each request.<p><dt><i><a name="o_w">-w NAME=VALUE</a></i><br><a name="wafer"><tt>wafer</tt>  <i>NAME=VALUE</i></a><dd>Specifies a pair to be sent as a cookie with every request<a href="ijbfaq.html#wafers">to the server.</a>(Such boring cookies are called<i>wafers</i>.)This option may be called more than once to generate multiple wafers.The originalNetscape specificationprohibitedsemi-colons, commas and white space;these characters will be<small>URL</small>-encodedif used in wafers.<!-- Aside: genuine cookies are not encoded --><!-- Aside: we could use quoted string as specified in the new RFC -->The Path and Domain attributes are not currently supported.<p><dt><i><a name="o_c">-c cookiefile</a></i><br><a name="cookiefile"><tt>cookiefile</tt>  <i>cookiefile</i></a><dd>Enforce the cookie management policy specified in the<i>cookiefile.</i><a name="java">If this option is not used all cookies are silently crunched,</a>so that users who never want cookies aren't bothered by browsersasking whether each cookie should be accepted.However, cookies can<a href="ijbfaq.html#breakthrough">still get through</a>via<a href="links.html#javascript">JavaScript</a>and<small>SSL</small>,so alerts should be left on.<p><a name="dropping">In Version 1.2 and later</a>this option must be followed by a<a href="ijbfaq.html#crumble">filename</a>containing instructions on which sites are allowed toreceive and set cookies.<a name="drop">By default cookies are dropped in both the browser's request</a>and the server's response, unless the<small>URL</small>requested matches an entry in the<i>cookiefile</i>.The matching algorithm is the same as for the blockfile.A leading<big><kbd>></kbd></big>character allows<a href="ijbfaq.html#directional">server-bound</a>cookies only;a<big><kbd><</kbd></big>allows only browser-bound cookies;a<big><kbd>~</kbd></big>character stops cookies in<a href="ijbfaq.html#crumble">both directions.</a>Thus a cookiefile containing a single line with the two characters<big><kbd>>*</kbd></big>will pass on all cookies to servers but not give any new ones to the browser.<p><dt><i><a name="o_j">-j jarfile</a></i><br><a name="jarfile"><tt>jarfile</tt>  <i>jarfile</i></a><dd>All Set-cookie attempts by the server are<a href="ijbfaq.html#jar">logged</a>to<i>jarfile</i>.If no wafer is specified,one containing a<a href="ijbfaq.html#notice">canned notice</a>(the <i>vanilla wafer</i>)is added as an alert to the serverunless the<a href="ijbman.html#suppress-vanilla-wafer">suppress-vanilla-wafer</a><!-- Aside: (no vanilla~wafer) -->option is invoked.<p><dt><i><a name="o_v">-v</a></i><br><a name="suppress-vanilla-wafer"><tt>suppress-vanilla-wafer</tt></a><dd>Suppress the vanilla wafer.<p><dt><i><a name="o_t">-t from</a></i><br><a name="from"><tt>from</tt>  <i>from</i></a><dd>If the browser<a href="ijbfaq.html#from">discloses an email address</a>in the<big><kbd>FROM</kbd></big>header (most don't),replace it with<i>from.</i>If<i>from</i>is set to<b>.</b>(the period character)the<big><kbd>FROM</kbd></big>is passed to the server unchanged.The default is to delete the<big><kbd>FROM</kbd></big>header.<p><dt><i><a name="o_r">-r referer</a></i><br><a name="referer"><tt>referer</tt>  <i>referer</i></a><dd>Whenever the browser discloses the<small>URL</small>that<a href="ijbfaq.html#referer">led to</a>the current request,replace it with<i>referer.</i>If<i>referer</i>is set to<b>.</b>(period)the <small>URL</small>is passed to the server unchanged.In Version <a href="ijbdist.html#c4">1.4</a>and later, if referer is set to <b>@</b>(at) the<small>URL</small>is sent in cases where the cookiefilespecifies that a cookie would be sent.(No way to send bogus referers selectively is provided.)The default is to delete Referer.<p><a name="referrer">Version 2.0 also accepts the spelling</a><big><kbd>referrer</kbd></big>,which most dictionaries consider correct.<p><dt><i><a name="o_u">-u user-agent</a></i><br><a name="user-agent"><tt>user-agent</tt>  <i>user-agent</i></a><dd>Information disclosed by the browser<a href="ijbfaq.html#agent">about itself</a>is replaced with the value<i>user-agent.</i>If<i>user-agent</i>is set to<b>.</b>(period)the<big><kbd>User-Agent</kbd></big>header is passed to the server unchanged,along with any<big><kbd>UA</kbd></big>headers produced by<small>MS-IE</small>(which would otherwise be deleted).In Version <a href="ijbdist.html#c4">1.4</a>and later, if<i>user-agent</i>is set to<b>@</b>(at) these headers are sent unchanged in cases where the cookiefilespecifies that a cookie would be sent,otherwise only default<big><kbd>User-Agent</kbd></big>header is sent.That defaultis Mozilla/3.0 (Netscape)with an unremarkable<a href="ijbfaq.html#infer">Macintosh</a>configuration.If used with a browser less advanced than Mozilla/3.0 or IE-3, the defaultmay encourage pages containing extensions that confuse the browser.<!-- Aside: Some servers use extensions to everyone anyway. But in that case it's probably ignoring cookies anyway. Some servers attempt to send cookies only to browsers identifying themselves as Mozilla. --><p><dt><i><a name="o_h">-h [host][:port]</a></i><br><a name="listen-address"><tt>listen-address</tt>  <i>[host][:port]</i></a><dd>If<i>host</i>is specified,bind the<b><kbd>junkbuster</kbd></b>to that<small>IP</small>address.If a<i>port</i>is specified, use it.The defaultportis 8000;the default host is<big><kbd>localhost</kbd></big>.Before Version 2.0.2,the default was to bind to all <small>IP</small>addresses(<big><kbd>INADDR_ANY</kbd></big>);but this has been restricted to<big><kbd>localhost</kbd></big>to avoid unintended security breaches.(To open the proxy to all, use the line<br>   <big><kbd>listen-address :8000</kbd></big><br>in the configuration file.)⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -