Regenerate docs for upcoming 3.0.1 release.
[privoxy.git] / doc / webserver / faq / trouble.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >Troubleshooting</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK
9 REL="HOME"
10 TITLE="Privoxy Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Miscellaneous"
14 HREF="misc.html"><LINK
15 REL="NEXT"
16 TITLE="Contacting the developers, Bug Reporting and Feature Requests"
17 HREF="contact.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"></HEAD
21 ><BODY
22 CLASS="SECT1"
23 BGCOLOR="#EEEEEE"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Privoxy Frequently Asked Questions</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="misc.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 ></TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="contact.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECT1"
73 ><H1
74 CLASS="SECT1"
75 ><A
76 NAME="TROUBLE"
77 ></A
78 >5. Troubleshooting</H1
79 ><DIV
80 CLASS="SECT2"
81 ><H3
82 CLASS="SECT2"
83 ><A
84 NAME="AEN741"
85 ></A
86 >5.1. I just upgraded and am getting <SPAN
87 CLASS="QUOTE"
88 >"connection refused"</SPAN
89 >
90 with every web page?</H3
91 ><P
92 > Either <SPAN
93 CLASS="APPLICATION"
94 >Privoxy</SPAN
95 > is not running, or your 
96  browser is configured for a different port than what
97  <SPAN
98 CLASS="APPLICATION"
99 >Privoxy</SPAN
100 > is using.</P
101 ><P
102 > The old <SPAN
103 CLASS="APPLICATION"
104 >Privoxy</SPAN
105 > (and also
106  <SPAN
107 CLASS="APPLICATION"
108 >Junkbuster</SPAN
109 >) used port 8000 by 
110  default. This has been changed to port 8118 now, due to a conflict 
111  with NAS (Network Audio Service), which uses port 8000. If you haven't, 
112  you need to change your browser to the new port number, or alternately 
113  change the <A
114 HREF="../user-manual/config.html#LISTEN-ADDRESS"
115 TARGET="_top"
116 ><TT
117 CLASS="LITERAL"
118 >listen-address</TT
119 >
120  option</A
121 > in <SPAN
122 CLASS="APPLICATION"
123 >Privoxy's</SPAN
124 > <A
125 HREF="../user-manual/config.html"
126 TARGET="_top"
127 >main configuration file</A
128 >.</P
129 ></DIV
130 ><DIV
131 CLASS="SECT2"
132 ><H3
133 CLASS="SECT2"
134 ><A
135 NAME="AEN754"
136 ></A
137 >5.2. I just added a new rule, but the steenkin ad is 
138 still getting through. How?</H3
139 ><P
140 > If the ad had been displayed before you added its URL, it will probably be
141  held in the browser's cache for some time, so it will be displayed without
142  the need for any request to the server, and <SPAN
143 CLASS="APPLICATION"
144 >Privoxy</SPAN
145 >
146  will not be in the picture. The best thing to do is try flushing the browser's
147  caches. And then try again.</P
148 ><P
149 > If this doesn't help, you probably have an error in the rule you
150  applied. Try pasting the full URL of the offending ad into <A
151 HREF="http://config.privoxy.org/show-url-info"
152 TARGET="_top"
153 >http://config.privoxy.org/show-url-info</A
154 >
155  and see if it really matches your new rule.</P
156 ></DIV
157 ><DIV
158 CLASS="SECT2"
159 ><H3
160 CLASS="SECT2"
161 ><A
162 NAME="BADSITE"
163 ></A
164 >5.3. One of my favorite sites does not work with <SPAN
165 CLASS="APPLICATION"
166 >Privoxy</SPAN
167 >.
168 What can I do?</H3
169 ><P
170 > First verify that it is indeed a <SPAN
171 CLASS="APPLICATION"
172 >Privoxy</SPAN
173 > problem, 
174  by toggling off <SPAN
175 CLASS="APPLICATION"
176 >Privoxy</SPAN
177 > through <A
178 HREF="http://config.privoxy.org/toggle"
179 TARGET="_top"
180 >http://config.privoxy.org/toggle</A
181 >,
182  and then shift-reloading the problem page (i.e. holding down the shift key
183  while clicking reload. Alternatively, flush your browser's disk and memory
184  caches).</P
185 ><P
186 > If still a problem, go to <A
187 HREF="http://config.privoxy.org/show-url-info"
188 TARGET="_top"
189 >http://config.privoxy.org/show-url-info</A
190 >
191  and paste the full URL of the page in question into the prompt. See which actions
192  are being applied to the URL, and which matches in which actions files are
193  responsible for that. Now, armed with this information, go to <A
194 HREF="http://config.privoxy.org/show-status"
195 TARGET="_top"
196 >http://config.privoxy.org/show-status</A
197 >
198  and select the appropriate actions files for editing.</P
199 ><P
200 > You can now either look for a section which disables the actions that
201  you suspect to cause the problem and add a pattern for your site there,
202  or make up a completely new section for your site. In any case, the recommended
203  way is to disable only the prime suspect, reload the problem page, and only
204  if the problem persists, disable more and more actions until you have
205  identified the culprit. You may or may not want to turn the other actions
206  on again. Remember to flush your browser's caches in between any such changes!</P
207 ><P
208 > Alternately, if you are comfortable with a text editor, you can accomplish 
209  the same thing by editing the appropriate actions file. Probably the easiest 
210  way to deal with such problems when editing by hand is to add your
211  site to a <TT
212 CLASS="LITERAL"
213 >{ fragile }</TT
214 > section in <TT
215 CLASS="FILENAME"
216 >user.action</TT
217 >,
218  which is an alias that turns off most <SPAN
219 CLASS="QUOTE"
220 >"dangerous"</SPAN
221 >
222  actions, but is also likely to turn off more actions then needed, and thus lower
223  your privacy and protection more than necessary, </P
224 ><P
225 > Troubleshooting actions is discussed in more detail in the <A
226 HREF="../user-manual/appendix.html#ACTIONSANAT"
227 TARGET="_top"
228 >user-manual appendix</A
229 >.
230  There is also an <A
231 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
232 TARGET="_top"
233 >actions tutorial</A
234 >.</P
235 ></DIV
236 ><DIV
237 CLASS="SECT2"
238 ><H3
239 CLASS="SECT2"
240 ><A
241 NAME="DUN"
242 ></A
243 >5.4. After installing <SPAN
244 CLASS="APPLICATION"
245 >Privoxy</SPAN
246 >, I have to log in
247 every time I start IE. What gives?</H3
248 ><P
249 > This is a quirk that effects the installation of
250  <SPAN
251 CLASS="APPLICATION"
252 >Privoxy</SPAN
253 >, in conjunction with Internet Explorer and
254  Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
255  appear to be corrupted or invalid DUN settings, or passwords.</P
256 ><P
257 > When setting up an NT based Windows system with
258  <SPAN
259 CLASS="APPLICATION"
260 >Privoxy</SPAN
261 > you may find that things do not seem to be
262  doing what you expect. When you set your system up you will probably have set
263  up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
264  logged in with administrator privileges. You will probably have made this DUN
265  connection available to other accounts that you may have set-up on your
266  system. E.g. Mum or Dad sets up the system and makes accounts suitably
267  configured for the kids.</P
268 ><P
269 > When setting up <SPAN
270 CLASS="APPLICATION"
271 >Privoxy</SPAN
272 > in this environment you
273  will have to alter the proxy set-up of Internet Explorer (IE) for the
274  specific DUN connection on which you wish to use
275  <SPAN
276 CLASS="APPLICATION"
277 >Privoxy</SPAN
278 >. When you do this the ICS DUN set-up
279  becomes user specific. In this instance you will see no difference if you
280  change the DUN connection under the account used to set-up the connection.
281  However when you do this from another user you will notice that the DUN
282  connection changes to make available to "Me only". You will also find that
283  you have to store the password under each different user!</P
284 ><P
285 > The reason for this is that each user's set-up for IE is user specific. Each
286  set-up DUN connection and each LAN connection in IE store the settings for
287  each user individually. As such this enforces individual configurations
288  rather than common ones. Hence the first time you use a DUN connection after
289  re-booting your system it may not perform as you expect, and prompt you for 
290  the password. Just set and save the password again and all should be OK.</P
291 ><P
292 >[Thanks to Ray Griffith for this submission.]</P
293 ></DIV
294 ><DIV
295 CLASS="SECT2"
296 ><H3
297 CLASS="SECT2"
298 ><A
299 NAME="FTP"
300 ></A
301 >5.5. I cannot connect to any FTP sites. <SPAN
302 CLASS="APPLICATION"
303 >Privoxy</SPAN
304 >
305  seems to be blocking me.</H3
306 ><P
307 >  <SPAN
308 CLASS="APPLICATION"
309 >Privoxy</SPAN
310 > cannot act as a proxy for FTP traffic, 
311   so do not configure your browser to use <SPAN
312 CLASS="APPLICATION"
313 >Privoxy</SPAN
314 >
315   as an FTP proxy. The same is true for any protocol other than HTTP or HTTPS.
316  </P
317 ><P
318 >  Most browsers understand FTP as well as HTTP. If you connect to a site, with
319   a URL like <TT
320 CLASS="LITERAL"
321 >ftp://ftp.example.com</TT
322 >, your browser is making
323   an FTP connection, and not a HTTP connection. So while your browser may 
324   speak FTP, <SPAN
325 CLASS="APPLICATION"
326 >Privoxy</SPAN
327 > does not, and cannot proxy 
328   such traffic.
329  </P
330 ></DIV
331 ><DIV
332 CLASS="SECT2"
333 ><H3
334 CLASS="SECT2"
335 ><A
336 NAME="OSXIE"
337 ></A
338 >5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use 
339  <SPAN
340 CLASS="APPLICATION"
341 >Privoxy</SPAN
342 > as the HTTP proxy.</H3
343 ><P
344 >  Microsoft Internet Explorer (in versions like 5.1) respects system-wide
345   network settings.  In order to change the HTTP proxy, open System
346   Preferences, and click on the Network icon.  In the settings pane that
347   comes up, click on the Proxies tab.  Ensure the "Web Proxy (HTTP)" checkbox 
348   is checked and enter <TT
349 CLASS="LITERAL"
350 >127.0.0.1</TT
351 > in the entry field.  
352   Enter <TT
353 CLASS="LITERAL"
354 >8118</TT
355 > in the Port field.  The next time you start
356   IE, it should reflect these values.
357  </P
358 ></DIV
359 ><DIV
360 CLASS="SECT2"
361 ><H3
362 CLASS="SECT2"
363 ><A
364 NAME="OSXUNINSTALL"
365 ></A
366 >5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to 
367  uninstall it.  Now the finder tells me I don't have sufficient privileges to
368  empty the trash.</H3
369 ><P
370 >  Just dragging the <SPAN
371 CLASS="APPLICATION"
372 >Privoxy</SPAN
373 > folder to the trash is
374   not enough to delete it.  <SPAN
375 CLASS="APPLICATION"
376 >Privoxy</SPAN
377 > supplies an
378   <SPAN
379 CLASS="APPLICATION"
380 >uninstall.command</SPAN
381 > file that takes care of
382   these details.  Open the trash, drag the <SPAN
383 CLASS="APPLICATION"
384 >uninstall.command</SPAN
385 >
386   file out of the trash and double-click on it.  You will be prompted for
387   confirmation and the administration password.
388  </P
389 ><P
390 >  The trash may still appear full after this command; emptying the trash 
391   from the desktop should make it appear empty again.
392  </P
393 ></DIV
394 ><DIV
395 CLASS="SECT2"
396 ><H3
397 CLASS="SECT2"
398 ><A
399 NAME="BLANKPAGE"
400 ></A
401 >5.8. I get a completely blank page at one site. <SPAN
402 CLASS="QUOTE"
403 >"View Source"</SPAN
404 >
405  shows only: <SPAN
406 CLASS="MARKUP"
407 >&#60;html&#62;&#60;body&#62;&#60;/body&#62;&#60;/html&#62;</SPAN
408 >. Without
409  <SPAN
410 CLASS="APPLICATION"
411 >Privoxy</SPAN
412 > the page loads fine.</H3
413 ><P
414 >  Chances are that the site suffers from a bug in
415   <A
416 HREF="http://www.php.net/"
417 TARGET="_top"
418 ><SPAN
419 CLASS="APPLICATION"
420 >PHP</SPAN
421 ></A
422 >,
423   which results in empty pages being sent if the client explicitly requests
424   an uncompressed page, like <SPAN
425 CLASS="APPLICATION"
426 >Privoxy</SPAN
427 > does.
428   This bug has been fixed in PHP 4.2.3.
429  </P
430 ><P
431 >  To find out if this is in fact the source of the problem, try adding
432   the site to a <TT
433 CLASS="LITERAL"
434 >-prevent-compression</TT
435 > section in
436   <TT
437 CLASS="FILENAME"
438 >user.action</TT
439 >:
440  </P
441 ><TABLE
442 BORDER="0"
443 BGCOLOR="#E0E0E0"
444 WIDTH="100%"
445 ><TR
446 ><TD
447 ><PRE
448 CLASS="SCREEN"
449 >   # Make exceptions for ill-behaved sites:                                     
450    #                                                                    
451    {-prevent-compression}                                               
452     .example.com</PRE
453 ></TD
454 ></TR
455 ></TABLE
456 ><P
457 >  If that works, you may also want to report the problem to the
458   site's webmasters, telling them to use zlib.output_compression
459   instead of ob_gzhandler in their PHP applications (workaround)
460   or upgrade to PHP 4.2.3 or later (fix).
461  </P
462 ></DIV
463 ><DIV
464 CLASS="SECT2"
465 ><H3
466 CLASS="SECT2"
467 ><A
468 NAME="ERROR503"
469 ></A
470 >5.9. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</H3
471 ><P
472 >  More than likely this is a problem with the network stack. ZoneAlarm has
473   been reported to cause this symptom -- even if not running. The solution is
474   to either fight the ZA configuration, or uninstall ZoneAlarm, and then find
475   something better behaved in its place. Other firewall type products may
476   cause similar type problems if not configured correctly.
477  </P
478 ></DIV
479 ></DIV
480 ><DIV
481 CLASS="NAVFOOTER"
482 ><HR
483 ALIGN="LEFT"
484 WIDTH="100%"><TABLE
485 SUMMARY="Footer navigation table"
486 WIDTH="100%"
487 BORDER="0"
488 CELLPADDING="0"
489 CELLSPACING="0"
490 ><TR
491 ><TD
492 WIDTH="33%"
493 ALIGN="left"
494 VALIGN="top"
495 ><A
496 HREF="misc.html"
497 ACCESSKEY="P"
498 >Prev</A
499 ></TD
500 ><TD
501 WIDTH="34%"
502 ALIGN="center"
503 VALIGN="top"
504 ><A
505 HREF="index.html"
506 ACCESSKEY="H"
507 >Home</A
508 ></TD
509 ><TD
510 WIDTH="33%"
511 ALIGN="right"
512 VALIGN="top"
513 ><A
514 HREF="contact.html"
515 ACCESSKEY="N"
516 >Next</A
517 ></TD
518 ></TR
519 ><TR
520 ><TD
521 WIDTH="33%"
522 ALIGN="left"
523 VALIGN="top"
524 >Miscellaneous</TD
525 ><TD
526 WIDTH="34%"
527 ALIGN="center"
528 VALIGN="top"
529 >&nbsp;</TD
530 ><TD
531 WIDTH="33%"
532 ALIGN="right"
533 VALIGN="top"
534 >Contacting the developers, Bug Reporting and Feature Requests</TD
535 ></TR
536 ></TABLE
537 ></DIV
538 ></BODY
539 ></HTML
540 >