generated new files.
[privoxy.git] / doc / text / faq.txt
1
2 Junkbuster Frequently Asked Questions
3
4    By: Junkbuster Developers
5    
6    $Id: faq.sgml,v 1.12 2002/03/11 20:13:21 swa Exp $
7    
8    The FAQ document gives users and developers alike answers to
9    frequently asked questions about the Internet Junkbuster. Internet
10    Junkbuster is a web proxy with advanced filtering capabilities for
11    protecting privacy, filtering web page content, managing cookies,
12    controlling access, and removing ads, banners, pop-ups and other
13    obnoxious Internet Junk. Junkbuster has a very flexible configuration
14    and can be customized to suit individual needs and tastes. Internet
15    Junkbuster has application for both stand-alone systems and multi-user
16    networks.
17    
18    You can find the latest version of the document at
19    [1]http://ijbswa.sourceforge.net/faq/. Please see the Contact section
20    in the user-manual if you want to contact the developers.
21      _________________________________________________________________
22    
23    Table of Contents
24    1. [2]Introduction
25    2. [3]Frequently Asked Questions
26           
27         2.1. [4]Installation
28         2.2. [5]Configuration
29                 
30               2.2.1. [6]How can I make my Yahoo account work?
31               2.2.2. [7]How can I make my Hotmail account work?
32               2.2.3. [8]How can I make my GMX account work?
33               2.2.4. [9]What are the differences between
34                       ijb-intermediate.action, ijb-basic.action, etc.?
35                       
36               2.2.5. [10]Why can I change the configuration with a
37                       browser? Does that not raise security issues?
38                       
39         2.3. [11]Misc
40                 
41               2.3.1. [12]I noticed considerable delays in page requests
42                       compared to the old IJB. What's wrong?
43                       
44               2.3.2. [13]What is the "http://i.j.b/"?
45               2.3.3. [14]I get the message 'Bad File Descriptor', why?
46               2.3.4. [15]How do I chain Junkbuster with other proxies
47                       (e.g. squid)?
48                       
49               2.3.5. [16]I would like to help you, what do I do?
50               2.3.6. [17]Do you still maintain the blocklists?
51               2.3.7. [18]How can I submit new ads?
52               2.3.8. [19]How can I hide my IP address?
53                       
54    3. [20]Known Issues
55    4. [21]Contact the developers
56    5. [22]Copyright and History
57    6. [23]See also
58           
59 1. Introduction
60
61    Fillme.
62      _________________________________________________________________
63    
64 2. Frequently Asked Questions
65
66 2.1. Installation
67
68    Fillme.
69      _________________________________________________________________
70    
71 2.2. Configuration
72
73 2.2.1. How can I make my Yahoo account work?
74
75    Fillme.
76      _________________________________________________________________
77    
78 2.2.2. How can I make my Hotmail account work?
79
80    Fillme.
81      _________________________________________________________________
82    
83 2.2.3. How can I make my GMX account work?
84
85    Fillme.
86      _________________________________________________________________
87    
88 2.2.4. What are the differences between ijb-intermediate.action,
89 ijb-basic.action, etc.?
90
91    Configuring the Internet Junkbuster is not easy. To help you get
92    started, we provide you with three different default configurations.
93    The following table shows you, which features are enabled in each
94    configuration.
95    
96    Table 1. Default Configurations
97    Feature ijb.action ijb-basic.action ijb-intermediate.action
98    ijb-advanced.action
99    ad-filtering ? x x x
100    blank image ? x x x
101    de-animate GIFs ? x x x
102    referer forging ? x x x
103    jon's +no-cookies-keep (i.e. session cookies only) ? x x x
104    no-popup windows ?   x x
105    fast redirects ?   x x
106    hide-referrer ?   x x
107    hide-useragent ?   x x
108    content-modification ?     x
109    feature-x ?
110    feature-y ?
111    feature-z ?
112      _________________________________________________________________
113    
114 2.2.5. Why can I change the configuration with a browser? Does that not
115 raise security issues?
116
117    What I don't understand, is how I can browser edit the config file as
118    a regular user, while the whole /etc/junkbuster hierarchy belongs to
119    the user "junkbuster", with only 644 perms.
120    
121    When you use the browser-based editor, JunkBuster itself is writing to
122    the config files. Because JunkBuster is running as the user
123    "junkbuster", it can update the config files.
124    
125    If you don't like this, setting "enable-edit-actions 0" in the config
126    file will disable the browser-based editor. If you're that paranoid,
127    you should also consider setting "enable-remote-toggle 0" to prevent
128    browser-based enabling/disabling of JunkBuster.
129    
130    Note that normally only local users can connect to JunkBuster, so this
131    is not (normally) a security problem.
132      _________________________________________________________________
133    
134 2.3. Misc
135
136 2.3.1. I noticed considerable delays in page requests compared to the old
137 IJB. What's wrong?
138
139    Using the default filtering configuration, I noticed considerable
140    delays in page requests compared to the old IJB. Loading pages with
141    large contents seemed to take forever, then suddenly delivering all
142    the content at once.
143    
144    The whole content must be loaded in order to filter, and nothing is is
145    sent to the browser during this time. The loading time does not really
146    change in real numbers, but the feeling is different, because most
147    browsers are able to start rendering incomplete content, giving the
148    user a feeling of "it works".
149    
150    To modify the content of a page (i.e. make frames resizeable again,
151    etc.) and not just replace ads, the Internet Junkbuster needs to
152    download the entire page first, do its content magic and then send the
153    page to the browser.
154      _________________________________________________________________
155    
156 2.3.2. What is the "http://i.j.b/"?
157
158    Since JunkBuster sits between your web browser and the Internet, it
159    can be programmed to handle certain pages specially.
160    
161    With recent versions of JunkBuster (version 2.9.x), you can get some
162    information about JunkBuster and change some settings by going to
163    http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
164    (Note that i.j.b is far easier to type but may not work in some
165    configurations).
166    
167    These pages are *not* forwarded to a server on the internet - instead
168    they are handled by a special web server which is built in to
169    JunkBuster.
170    
171    If you are not running JunkBuster, then http://i.j.b/ will fail, and
172    http://ijbswa.sourceforge.net/config/ will return a web page telling
173    you you're not running JunkBuster.
174    
175    If you have version 2.0.2, then the equivalent is
176    http://example.com/show-proxy-args (but you get far less information,
177    and you should really consider upgrading to 2.9.x).
178      _________________________________________________________________
179    
180 2.3.3. I get the message 'Bad File Descriptor', why?
181
182    Fillme.
183      _________________________________________________________________
184    
185 2.3.4. How do I chain Junkbuster with other proxies (e.g. squid)?
186
187    Fillme.
188      _________________________________________________________________
189    
190 2.3.5. I would like to help you, what do I do?
191
192    Well, helping the team is always a good idea. We welcome new
193    developers, RPM gurus or documentation makers. Simply get an account
194    on sourceforge.net and mail your id to the developer mailing list.
195    Once we have added you to the team, you'll have write access to the
196    CVS repository, and together we'll find a suitable task for you.
197      _________________________________________________________________
198    
199 2.3.6. Do you still maintain the blocklists?
200
201    No. The format of the blocklists has changed significantly in the
202    versions 2.9.x. Once we have released the new version, there will
203    again be blocklists that you can update automatically.
204      _________________________________________________________________
205    
206 2.3.7. How can I submit new ads?
207
208    As of now, please discontinue to submit new ad blocking infos. Once we
209    have released the new version, there will again be a form on the
210    website, which you can use to contribute new ads.
211      _________________________________________________________________
212    
213 2.3.8. How can I hide my IP address?
214
215    You cannot hide your IP address with Junkbuster or any other software,
216    since the server needs to know your IP address to send the answer to
217    you.
218    
219    Fortunately there are many publicly usable anonymous proxies out
220    there, which solve the problem by providing a further level of
221    indirection between you and the web server, shared by many people and
222    thus letting your requests "drown" in white noise of unrelated
223    requests as far as user tracking is concerned.
224    
225    Most of them will, however, log your IP address and make it available
226    to the authorities in case you abuse that anonymity for criminal
227    purposes. In fact you can't even rule out that some of them only exist
228    to *collect* information on (those suspicious) people with a more than
229    average preference for privacy.
230    
231    You can find a list of anonymous public proxies at [24]multiproxy.org
232    and many more through Google.
233      _________________________________________________________________
234    
235 3. Known Issues
236
237    Fillme.
238      _________________________________________________________________
239    
240 4. Contact the developers
241
242    Please see the user manual for information on how to contact the
243    developers.
244      _________________________________________________________________
245    
246 5. Copyright and History
247
248    Please see the user manual for information on Copyright and History.
249      _________________________________________________________________
250    
251 6. See also
252
253    Please see the user manual for information on references.
254
255 References
256
257    1. http://ijbswa.sourceforge.net/faq/
258    2. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#INTRODUCTION
259    3. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#QUESTIONS
260    4. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#INSTALLATION
261    5. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#CONFIGURATION
262    6. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#YAHOO
263    7. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#HOTMAIL
264    8. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#GMX
265    9. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#CONFIGFILES
266   10. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#BROWSECONFIG
267   11. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#MISC
268   12. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#LOADINGTIMES
269   13. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#CONFIGURL
270   14. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#BADFILEDESC
271   15. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#PROXY-CHAINING
272   16. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#JOINTEAM
273   17. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#BLOCKLIST
274   18. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#NEWADS
275   19. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#IP
276   20. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#KNOWNISSUES
277   21. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#CONTACT
278   22. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#COPYRIGHT
279   23. file://localhost/home/swa/sf/current-org/doc/source/tmp.html#SEEALSO
280   24. http://www.multiproxy.org/anon_list.htm