rebuild docs
[privoxy.git] / doc / webserver / faq / trouble.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Troubleshooting</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><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"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1"></HEAD
24 ><BODY
25 CLASS="SECT1"
26 BGCOLOR="#EEEEEE"
27 TEXT="#000000"
28 LINK="#0000FF"
29 VLINK="#840084"
30 ALINK="#0000FF"
31 ><DIV
32 CLASS="NAVHEADER"
33 ><TABLE
34 SUMMARY="Header navigation table"
35 WIDTH="100%"
36 BORDER="0"
37 CELLPADDING="0"
38 CELLSPACING="0"
39 ><TR
40 ><TH
41 COLSPAN="3"
42 ALIGN="center"
43 >Privoxy Frequently Asked Questions</TH
44 ></TR
45 ><TR
46 ><TD
47 WIDTH="10%"
48 ALIGN="left"
49 VALIGN="bottom"
50 ><A
51 HREF="misc.html"
52 ACCESSKEY="P"
53 >Prev</A
54 ></TD
55 ><TD
56 WIDTH="80%"
57 ALIGN="center"
58 VALIGN="bottom"
59 ></TD
60 ><TD
61 WIDTH="10%"
62 ALIGN="right"
63 VALIGN="bottom"
64 ><A
65 HREF="contact.html"
66 ACCESSKEY="N"
67 >Next</A
68 ></TD
69 ></TR
70 ></TABLE
71 ><HR
72 ALIGN="LEFT"
73 WIDTH="100%"></DIV
74 ><DIV
75 CLASS="SECT1"
76 ><H1
77 CLASS="SECT1"
78 ><A
79 NAME="TROUBLE"
80 >5. Troubleshooting</A
81 ></H1
82 ><DIV
83 CLASS="SECT2"
84 ><H3
85 CLASS="SECT2"
86 ><A
87 NAME="REFUSED"
88 >5.1. I cannot connect to any websites. Or, I am getting
89 <SPAN
90 CLASS="QUOTE"
91 >"connection refused"</SPAN
92 > message with every web page. Why?</A
93 ></H3
94 ><P
95 > There are several possibilities:</P
96 ><P
97 ></P
98 ><UL
99 ><LI
100 ><P
101 ><SPAN
102 CLASS="APPLICATION"
103 >Privoxy</SPAN
104 > is not running. Solution: verify
105  that <SPAN
106 CLASS="APPLICATION"
107 >Privoxy</SPAN
108 > is installed correctly, has not crashed, and is indeed running.
109  Turn on <SPAN
110 CLASS="APPLICATION"
111 >Privoxy's</SPAN
112 > logging, and look at the logs to see what they say.</P
113 ></LI
114 ><LI
115 ><P
116 >Or your browser is configured for a different port than what
117  <SPAN
118 CLASS="APPLICATION"
119 >Privoxy</SPAN
120 > is using. Solution: verify that <SPAN
121 CLASS="APPLICATION"
122 >Privoxy</SPAN
123 >
124  and your browser are set to the same port (<TT
125 CLASS="LITERAL"
126 >listen-address</TT
127 >).</P
128 ></LI
129 ><LI
130 ><P
131 >Or if using a forwarding rule, you have a configuration problem or a
132  problem with a host in the forwarding chain. Solution: temporarily alter your
133  configuration and take the forwarders out of the equation.</P
134 ></LI
135 ><LI
136 ><P
137 >  Or you have a firewall that is interfering and blocking you. Solution:
138   try disabling or removing the firewall as a simple test.
139  </P
140 ></LI
141 ></UL
142 ></DIV
143 ><DIV
144 CLASS="SECT2"
145 ><H3
146 CLASS="SECT2"
147 ><A
148 NAME="ERROR503"
149 >5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A
150 ></H3
151 ><P
152 >  More than likely this is a problem with your TCP/IP networking. ZoneAlarm has
153   been reported to cause this symptom -- even if not running! The solution is
154   to either fight the ZA configuration, or uninstall ZoneAlarm, and then find
155   something better behaved in its place. Other personal firewall type products
156   may cause similar type problems if not configured correctly.
157  </P
158 ></DIV
159 ><DIV
160 CLASS="SECT2"
161 ><H3
162 CLASS="SECT2"
163 ><A
164 NAME="FLUSHIT"
165 >5.3. I just added a new rule, but the steenkin ad is
166 still getting through. How?</A
167 ></H3
168 ><P
169 > If the ad had been displayed before you added its URL, it will probably be
170  held in the browser's cache for some time, so it will be displayed without
171  the need for any request to the server, and <SPAN
172 CLASS="APPLICATION"
173 >Privoxy</SPAN
174 >
175  will not be involved. Flush the browser's caches, and then try again.</P
176 ><P
177 > If this doesn't help, you probably have an error in the rule you
178  applied. Try pasting the full URL of the offending ad into <A
179 HREF="http://config.privoxy.org/show-url-info"
180 TARGET="_top"
181 >http://config.privoxy.org/show-url-info</A
182 >
183  and see if it really matches your new rule. Blocking ads is like blocking
184  spam: a lot of tinkering is required to stay ahead of the game. And
185  remember you need to block the URL of the ad in question, which may be
186  entirely different from the site URL itself. Most ads are hosted on different
187  servers than the main site itself. If you right-click on the ad, you should
188  be able to get all the relevant information you need. Alternately, you can
189  find the correct URL by looking at <SPAN
190 CLASS="APPLICATION"
191 >Privoxy's</SPAN
192 > logs
193  (you may need to enable logging in the main config file if its disabled).</P
194 ><P
195 > Below is a slightly modified real-life log snippet that originates with one
196  requested URL: <TT
197 CLASS="LITERAL"
198 >www.example.com</TT
199 > (name of site was changed
200  for this example, the number of requests is real). You can see in this the
201  complexity of what goes into making up this one <SPAN
202 CLASS="QUOTE"
203 >"page"</SPAN
204 >. There
205  are eight different domains involved here, with thirty two separate URLs
206  requested in all, making up all manner of images, Shockwave Flash,
207  JavaScript, CSS stylesheets, scripts, and other related content. Some of this
208  content is obviously <SPAN
209 CLASS="QUOTE"
210 >"good"</SPAN
211 > or <SPAN
212 CLASS="QUOTE"
213 >"bad"</SPAN
214 >, but not all.
215  Many of the more questionable looking requests, are going to outside domains
216  that seem to be identifying themselves with suspicious looking names, making
217  our job a little easier. <SPAN
218 CLASS="APPLICATION"
219 >Privoxy</SPAN
220 > has <SPAN
221 CLASS="QUOTE"
222 >"crunched"</SPAN
223 > (meaning caught
224  and BLOCKED) quite a few items in this example, but perhaps missed a few as well.</P
225 ><TABLE
226 BORDER="0"
227 BGCOLOR="#E0E0E0"
228 WIDTH="100%"
229 ><TR
230 ><TD
231 ><PRE
232 CLASS="SCREEN"
233 >Request: www.example.com/
234 Request: www.example.com/favicon.ico
235 Request: img.example.com/main.css
236 Request: img.example.com/sr.js
237 Request: example.betamarker.com/example.html
238 Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
239 Request: img.example.com/pb.png
240 Request: www.google-analytics.com/urchin.js crunch! (Blocked)
241 Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked)
242 Request: img.example.com/p.gif
243 Request: www.popuptraffic.com/assign.php?l=example&#38;mode=behind crunch! (Blocked)
244 Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&#38;tmpl=PBa.tmpl crunch! (Blocked)
245 Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked)
246 Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
247 Request: www.adtrak.net/adx.js crunch! (Blocked)
248 Request: img.example.com/hbg.gif
249 Request: img.example.com/example.jpg
250 Request: img.example.com/mt.png
251 Request: img.example.com/mm.png
252 Request: img.example.com/mb.png
253 Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&#38;tmpl=Ua.tmp crunch! (Blocked)
254 Request: www.example.com/tracker.js
255 Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
256 Request: www.adtrak.net/adjs.php?n=020548130&#38;what=zone:61 crunch! (Blocked)
257 Request: www.adtrak.net/adjs.php?n=463594413&#38;what=zone:58&#38;source=Ua crunch! (Blocked)
258 Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
259 Request: mmm.elitemediagroup.net/install.php?allowpop=no&#38;popupmincook=0&#38;allowsp2=1 crunch! (Blocked)
260 Request: www.example.com/tracker.js?screen=1400x1050&#38;win=962x693
261 Request: www.adtrak.net/adlog.php?bannerid=1309&#38;clientid=439&#38;zoneid=61 crunch! (Blocked)
262 Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&#38;si
263 Request: 66.70.21.80/img/pixel.gif
264 Request: www.adtrak.net/adlog.php?bannerid=1309&#38;clientid=439&#38;zoneid=58&#38;source=Ua&#38;block=86400 crunch! (Blocked)
265 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&#38;si=Ua</PRE
266 ></TD
267 ></TR
268 ></TABLE
269 ><P
270 > Despite 12 out of 32 requests being blocked, the page looked, and seemed to
271  behave perfectly <SPAN
272 CLASS="QUOTE"
273 >"normal"</SPAN
274 > (minus some ads, of course).</P
275 ></DIV
276 ><DIV
277 CLASS="SECT2"
278 ><H3
279 CLASS="SECT2"
280 ><A
281 NAME="BADSITE"
282 >5.4. One of my favorite sites does not work with Privoxy.
283 What can I do?</A
284 ></H3
285 ><P
286 > First verify that it is indeed a <SPAN
287 CLASS="APPLICATION"
288 >Privoxy</SPAN
289 > problem,
290  by toggling off <SPAN
291 CLASS="APPLICATION"
292 >Privoxy</SPAN
293 > through <A
294 HREF="http://config.privoxy.org/toggle"
295 TARGET="_top"
296 >http://config.privoxy.org/toggle</A
297 >
298  (the toggle feature may need to be enabled in the main
299  <TT
300 CLASS="FILENAME"
301 >config</TT
302 >),
303  and then shift-reloading the problem page (i.e. holding down the shift key
304  while clicking reload. Alternatively, flush your browser's disk and memory
305  caches).</P
306 ><P
307 > If the problem went away, we know we have a configuration related problem.
308  Now go to <A
309 HREF="http://config.privoxy.org/show-url-info"
310 TARGET="_top"
311 >http://config.privoxy.org/show-url-info</A
312 >
313  and paste the full URL of the page in question into the prompt. See which
314  actions are being applied to the URL, and which matches in which actions
315  files are responsible for that. It might be helpful also to look at your logs
316  for this site too, to see what else might be happening (note: logging may need
317  to be enabled in the main config file). Many sites are
318  complex and require a number of related pages to help present their content.
319  Look at what else might be used by the page in question, and what of that
320  might be <SPAN
321 CLASS="emphasis"
322 ><I
323 CLASS="EMPHASIS"
324 >required</I
325 ></SPAN
326 >.
327  Now, armed with this information, go to
328  <A
329 HREF="http://config.privoxy.org/show-status"
330 TARGET="_top"
331 >http://config.privoxy.org/show-status</A
332 >
333  and select the appropriate actions files for editing. </P
334 ><P
335 > You can now either look for a section which disables the actions that
336  you suspect to cause the problem and add a pattern for your site there,
337  or make up a completely new section for your site. In any case, the recommended
338  way is to disable only the prime suspect, reload the problem page, and only
339  if the problem persists, disable more and more actions until you have
340  identified the culprit. You may or may not want to turn the other actions
341  on again. Remember to flush your browser's caches in between any such changes!</P
342 ><P
343 > Alternately, if you are comfortable with a text editor, you can accomplish
344  the same thing by editing the appropriate actions file. Probably the easiest
345  way to deal with such problems when editing by hand is to add your
346  site to a <TT
347 CLASS="LITERAL"
348 >{ fragile }</TT
349 > section in <TT
350 CLASS="FILENAME"
351 >user.action</TT
352 >,
353  which is an alias that turns off most <SPAN
354 CLASS="QUOTE"
355 >"dangerous"</SPAN
356 >
357  actions, but is also likely to turn off more actions then needed, and thus lower
358  your privacy and protection more than necessary,</P
359 ><P
360 > Troubleshooting actions is discussed in more detail in the <A
361 HREF="../user-manual/appendix.html#ACTIONSANAT"
362 TARGET="_top"
363 >User Manual appendix,
364  Troubleshooting: the Anatomy of an Action</A
365 >.
366  There is also an <A
367 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
368 TARGET="_top"
369 >actions tutorial</A
370 >
371  with general configuration information and examples.</P
372 ><P
373 > As a last resort, you can always see if your browser has a setting that will
374  bypass the proxy setting for selective sites. Modern browsers can do this.</P
375 ></DIV
376 ><DIV
377 CLASS="SECT2"
378 ><H3
379 CLASS="SECT2"
380 ><A
381 NAME="DUN"
382 >5.5. After installing Privoxy, I have to log in
383 every time I start IE. What gives?</A
384 ></H3
385 ><P
386 > This is a quirk that affects the installation of
387  <SPAN
388 CLASS="APPLICATION"
389 >Privoxy</SPAN
390 >, in conjunction with Internet Explorer and
391  Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
392  appear to be corrupted or invalid DUN settings, or passwords.</P
393 ><P
394 > When setting up an NT based Windows system with
395  <SPAN
396 CLASS="APPLICATION"
397 >Privoxy</SPAN
398 > you may find that things do not seem to be
399  doing what you expect. When you set your system up you will probably have set
400  up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
401  logged in with administrator privileges. You will probably have made this DUN
402  connection available to other accounts that you may have set-up on your
403  system. E.g. Mum or Dad sets up the system and makes accounts suitably
404  configured for the kids.</P
405 ><P
406 > When setting up <SPAN
407 CLASS="APPLICATION"
408 >Privoxy</SPAN
409 > in this environment you
410  will have to alter the proxy set-up of Internet Explorer (IE) for the
411  specific DUN connection on which you wish to use
412  <SPAN
413 CLASS="APPLICATION"
414 >Privoxy</SPAN
415 >. When you do this the ICS DUN set-up
416  becomes user specific. In this instance you will see no difference if you
417  change the DUN connection under the account used to set-up the connection.
418  However when you do this from another user you will notice that the DUN
419  connection changes to make available to "Me only". You will also find that
420  you have to store the password under each different user!</P
421 ><P
422 > The reason for this is that each user's set-up for IE is user specific. Each
423  set-up DUN connection and each LAN connection in IE store the settings for
424  each user individually. As such this enforces individual configurations
425  rather than common ones. Hence the first time you use a DUN connection after
426  re-booting your system it may not perform as you expect, and prompt you for
427  the password. Just set and save the password again and all should be OK.</P
428 ><P
429 >[Thanks to Ray Griffith for this submission.]</P
430 ></DIV
431 ><DIV
432 CLASS="SECT2"
433 ><H3
434 CLASS="SECT2"
435 ><A
436 NAME="FTP"
437 >5.6. I cannot connect to any FTP sites. Privoxy
438  is blocking me.</A
439 ></H3
440 ><P
441 >  <SPAN
442 CLASS="APPLICATION"
443 >Privoxy</SPAN
444 > cannot act as a proxy for FTP traffic,
445   so do not configure your browser to use <SPAN
446 CLASS="APPLICATION"
447 >Privoxy</SPAN
448 >
449   as an FTP proxy. The same is true for <SPAN
450 CLASS="emphasis"
451 ><I
452 CLASS="EMPHASIS"
453 >any protocol other than HTTP
454   or HTTPS (SSL)</I
455 ></SPAN
456 >.
457  </P
458 ><P
459 >  Most browsers understand FTP as well as HTTP. If you connect to a site, with
460   a URL like <TT
461 CLASS="LITERAL"
462 >ftp://ftp.example.com</TT
463 >, your browser is making
464   an FTP connection, and not a HTTP connection. So while your browser may
465   speak FTP, <SPAN
466 CLASS="APPLICATION"
467 >Privoxy</SPAN
468 > does not, and cannot proxy
469   such traffic.
470  </P
471 ><P
472 >  To complicate matters, some systems may have a generic <SPAN
473 CLASS="QUOTE"
474 >"proxy"</SPAN
475 >
476   setting, which will enable various protocols, including
477   <SPAN
478 CLASS="emphasis"
479 ><I
480 CLASS="EMPHASIS"
481 >both</I
482 ></SPAN
483 > HTTP and FTP proxying! So it is possible to
484   accidentally enable FTP proxying in these cases. And of course, if this
485   happens, <SPAN
486 CLASS="APPLICATION"
487 >Privoxy</SPAN
488 > will indeed cause problems since
489   it does not know FTP. Newer version will give a sane error
490   message if a FTP connection is attempted. Just disable the FTP setting
491   and all will be well again.
492  </P
493 ><P
494 >  Will <SPAN
495 CLASS="APPLICATION"
496 >Privoxy</SPAN
497 > ever proxy FTP traffic? Unlikely.
498   There just is not much reason, and the work to make this happen is more than
499   it may seem.
500  </P
501 ></DIV
502 ><DIV
503 CLASS="SECT2"
504 ><H3
505 CLASS="SECT2"
506 ><A
507 NAME="MACOSXIE"
508 >5.7. In Mac OS X, I can't configure Microsoft Internet Explorer to use
509  Privoxy as the HTTP proxy.</A
510 ></H3
511 ><P
512 >  Microsoft Internet Explorer (in versions like 5.1) respects system-wide
513   network settings.  In order to change the HTTP proxy, open System
514   Preferences, and click on the Network icon.  In the settings pane that
515   comes up, click on the Proxies tab.  Ensure the "Web Proxy (HTTP)" checkbox
516   is checked and enter <TT
517 CLASS="LITERAL"
518 >127.0.0.1</TT
519 > in the entry field.
520   Enter <TT
521 CLASS="LITERAL"
522 >8118</TT
523 > in the Port field.  The next time you start
524   IE, it should reflect these values.
525  </P
526 ></DIV
527 ><DIV
528 CLASS="SECT2"
529 ><H3
530 CLASS="SECT2"
531 ><A
532 NAME="MACOSXUNINSTALL"
533 >5.8. In Mac OS X, I dragged the Privoxy folder to the trash in order to
534  uninstall it. Now the finder tells me I don't have sufficient privileges to
535  empty the trash.</A
536 ></H3
537 ><P
538 > Note: This ONLY applies to privoxy 3.0.6 and earlier.
539  </P
540 ><P
541 >  Just dragging the <SPAN
542 CLASS="APPLICATION"
543 >Privoxy</SPAN
544 > folder to the trash is
545   not enough to delete it. <SPAN
546 CLASS="APPLICATION"
547 >Privoxy</SPAN
548 > supplies an
549   <SPAN
550 CLASS="APPLICATION"
551 >uninstall.command</SPAN
552 > file that takes care of
553   these details. Open the trash, drag the <SPAN
554 CLASS="APPLICATION"
555 >uninstall.command</SPAN
556 >
557   file out of the trash and double-click on it. You will be prompted for
558   confirmation and the administration password.
559  </P
560 ><P
561 >  The trash may still appear full after this command; emptying the trash
562   from the desktop should make it appear empty again.
563  </P
564 ></DIV
565 ><DIV
566 CLASS="SECT2"
567 ><H3
568 CLASS="SECT2"
569 ><A
570 NAME="MACOSXIMAGES"
571 >5.9. In Mac OS X Panther (10.3), images often fail to load and/or I
572  experience random delays in page loading. I'm using
573  <TT
574 CLASS="LITERAL"
575 >localhost</TT
576 > as my browser's proxy setting.</A
577 ></H3
578 ><P
579 >  We believe this is due to an IPv6-related bug in Mac OS X, but don't fully
580   understand the issue yet. In any case, changing the proxy setting to
581   <TT
582 CLASS="LITERAL"
583 >127.0.0.1</TT
584 > instead of <TT
585 CLASS="LITERAL"
586 >localhost</TT
587 >
588   works around the problem.
589  </P
590 ></DIV
591 ><DIV
592 CLASS="SECT2"
593 ><H3
594 CLASS="SECT2"
595 ><A
596 NAME="MACOSXACCOUNTDELETION"
597 >5.10. I just upgraded to Mac OS X 10.9 (Mavericks) and now <SPAN
598 CLASS="APPLICATION"
599 >Privoxy</SPAN
600 > has stopped
601  working.</A
602 ></H3
603 ><P
604 >  The upgrade process to Mac OS X Mavericks (10.9) from an earlier version of OS
605   X deletes all user accounts that are either not part of OS X itself or are
606   not interactive user accounts (ones you log in with). Since, for the sake of
607   security, <SPAN
608 CLASS="APPLICATION"
609 >Privoxy</SPAN
610 > runs as a non-privileged user that is created by its
611   installer (_privoxy), it can no longer start up once that account gets deleted.
612   The solution is to perform a complete uninstall using the supplied
613   <SPAN
614 CLASS="APPLICATION"
615 >uninstall.command</SPAN
616 > script (either back up your
617   configuration files or select to not have the uninstaller remove them when it
618   prompts you) and then reinstall <SPAN
619 CLASS="APPLICATION"
620 >Privoxy</SPAN
621 > using the installer package and merge
622   in your configuration.
623  </P
624 ></DIV
625 ><DIV
626 CLASS="SECT2"
627 ><H3
628 CLASS="SECT2"
629 ><A
630 NAME="NOHOSTNAME"
631 >5.11. My logs show many <SPAN
632 CLASS="QUOTE"
633 >"Unable to get my own hostname"</SPAN
634 > lines.
635 Why?</A
636 ></H3
637 ><P
638 > <SPAN
639 CLASS="APPLICATION"
640 >Privoxy</SPAN
641 > tries to get the hostname of the system
642  its running on from the IP address of the system interface it is bound to
643  (from the <TT
644 CLASS="FILENAME"
645 >config</TT
646 > file
647  <SPAN
648 CLASS="emphasis"
649 ><I
650 CLASS="EMPHASIS"
651 >listen-address</I
652 ></SPAN
653 > setting). If the system cannot supply
654  this information, <SPAN
655 CLASS="APPLICATION"
656 >Privoxy</SPAN
657 > logs this condition.</P
658 ><P
659 > Typically, this would be considered a minor system configuration error. It is
660  not a fatal error to <SPAN
661 CLASS="APPLICATION"
662 >Privoxy</SPAN
663 > however, but may
664  result in a much slower response from <SPAN
665 CLASS="APPLICATION"
666 >Privoxy</SPAN
667 > on
668  some platforms due to DNS timeouts.</P
669 ><P
670 > This can be caused by a problem with the local <TT
671 CLASS="FILENAME"
672 >hosts</TT
673 >
674  file. If this file has been changed from the original, try reverting it to
675  see if that helps. Make sure whatever name(s) are used for the local system,
676  that they resolve both ways.</P
677 ><P
678 > You should also be able to work around the problem with the
679  <A
680 HREF="../user-manual/config.html#HOSTNAME"
681 TARGET="_top"
682 >hostname option</A
683 >.</P
684 ></DIV
685 ><DIV
686 CLASS="SECT2"
687 ><H3
688 CLASS="SECT2"
689 ><A
690 NAME="INUSE"
691 >5.12. When I try to launch Privoxy, I get an
692 error message <SPAN
693 CLASS="QUOTE"
694 >"port 8118 is already in use"</SPAN
695 > (or similar wording).
696 Why?</A
697 ></H3
698 ><P
699 > Port 8118 is <SPAN
700 CLASS="APPLICATION"
701 >Privoxy's</SPAN
702 > default TCP
703  <SPAN
704 CLASS="QUOTE"
705 >"listening"</SPAN
706 > port. Typically this message would mean that there
707  is already one instance of <SPAN
708 CLASS="APPLICATION"
709 >Privoxy</SPAN
710 > running, and
711  your system is actually trying to start a second
712  <SPAN
713 CLASS="APPLICATION"
714 >Privoxy</SPAN
715 > on the same port, which will not work.
716  (You can have multiple instances but they must be assigned different ports.)
717  How and why this might happen varies from platform to platform, but you need
718  to check your installation and start-up procedures.</P
719 ></DIV
720 ><DIV
721 CLASS="SECT2"
722 ><H3
723 CLASS="SECT2"
724 ><A
725 NAME="DEMORONIZER"
726 >5.13. Pages with UTF-8 fonts are garbled.</A
727 ></H3
728 ><P
729 > This may be the result of an overly aggressive filter. The filters that
730  are enabled in the default configuration aren't expected to cause problems
731  like this. If you enabled the <SPAN
732 CLASS="QUOTE"
733 >"demoronizer"</SPAN
734 > filter, please
735  try temporarily disabling it.</P
736 ><P
737 > If that doesn't help, temporarily disable all filters to see if another
738  filter could be the culprit. If the problem disappears, enable the filters
739  one by one, until the problem reappears and the offending filter is found.</P
740 ><P
741 > Once the problem-causing filter is known, it can be fixed or disabled.</P
742 ><P
743 > Upgrading <SPAN
744 CLASS="APPLICATION"
745 >Privoxy</SPAN
746 >, or going to the most recent
747  <TT
748 CLASS="FILENAME"
749 >default.action</TT
750 > file available from <A
751 HREF="https://sourceforge.net/project/showfiles.php?group_id=11118"
752 TARGET="_top"
753 >SourceForge</A
754 >
755  might be worth a try, too.</P
756 ></DIV
757 ><DIV
758 CLASS="SECT2"
759 ><H3
760 CLASS="SECT2"
761 ><A
762 NAME="DEMORONIZER2"
763 >5.14. Why are binary files (such as images) corrupted when Privoxy
764  is used?</A
765 ></H3
766 ><P
767 > This may also be caused by an (<A
768 HREF="trouble.html#DEMORONIZER"
769 >overly aggressive
770  filter</A
771 > in conjunction with a web server that is misreporting the content
772  type. By default binary files are exempted from
773  <SPAN
774 CLASS="APPLICATION"
775 >Privoxy's</SPAN
776 > filtering
777  (unless the web server by mistake says the file is something else).</P
778 ></DIV
779 ><DIV
780 CLASS="SECT2"
781 ><H3
782 CLASS="SECT2"
783 ><A
784 NAME="DEMORONIZER3"
785 >5.15. What is the <SPAN
786 CLASS="QUOTE"
787 >"demoronizer"</SPAN
788 > and why is it there?</A
789 ></H3
790 ><P
791 > The original demoronizer was a Perl script that cleaned up HTML pages which
792  were created with certain Microsoft products. MS has used proprietary extensions
793  to standardized font encodings (ISO 8859-1), which has caused problems for pages
794  that are viewed with non-Microsoft products (and are expecting to see a
795  standard set of fonts). The demoronizer corrected these errors so the pages
796  displayed correctly. <SPAN
797 CLASS="APPLICATION"
798 >Privoxy</SPAN
799 > borrowed from this
800  script, introducing a filter based on the original demoronizer, which in turn could
801  correct these errors on the fly.</P
802 ><P
803 > But this is only needed in some situations, and will cause serious problems in some
804  other situations.</P
805 ><P
806 > If you are using Microsoft products, you do not need it. If you need to view
807  pages with UTF-8 characters (such as Cyrillic or Chinese), then it will
808  cause corruption of the fonts, and thus <SPAN
809 CLASS="emphasis"
810 ><I
811 CLASS="EMPHASIS"
812 >should not be on</I
813 ></SPAN
814 >.</P
815 ><P
816 > On the other hand, if you use non-Microsoft products, and you occasionally
817  notice weird characters on pages, you might want to try it.</P
818 ></DIV
819 ><DIV
820 CLASS="SECT2"
821 ><H3
822 CLASS="SECT2"
823 ><A
824 NAME="WINDOWOPEN"
825 >5.16. Why do I keep seeing <SPAN
826 CLASS="QUOTE"
827 >"PrivoxyWindowOpen()"</SPAN
828 > in raw source code?</A
829 ></H3
830 ><P
831 > <SPAN
832 CLASS="APPLICATION"
833 >Privoxy</SPAN
834 > is attempting to disable malicious
835   <A
836 HREF="http://en.wikipedia.org/wiki/Javascript"
837 TARGET="_top"
838 >Javascript</A
839 >
840   in this case, with the <TT
841 CLASS="LITERAL"
842 >unsolicited-popups</TT
843 >
844  filter. <SPAN
845 CLASS="APPLICATION"
846 >Privoxy</SPAN
847 > cannot tell very well
848  <SPAN
849 CLASS="QUOTE"
850 >"good"</SPAN
851 > code snippets from <SPAN
852 CLASS="QUOTE"
853 >"bad"</SPAN
854 > code snippets.</P
855 ><P
856 > If you see this in HTML source, and the page displays without problems, then
857  this is good, and likely some pop-up window was disabled. If you see this
858  where it is causing a problem, such as a downloaded program source code file,
859  then you should set an exception for this site or page such that the
860  integrity of the page stays in tact by disabling all filtering.</P
861 ></DIV
862 ><DIV
863 CLASS="SECT2"
864 ><H3
865 CLASS="SECT2"
866 ><A
867 NAME="DNSERRORS"
868 >5.17. I am getting too many DNS errors like <SPAN
869 CLASS="QUOTE"
870 >"404 No Such Domain"</SPAN
871 >. Why
872  can't Privoxy do this better?</A
873 ></H3
874 ><P
875 > There are potentially several factors here. First of all, the DNS resolution
876  is done by the underlying operating system -- not
877  <SPAN
878 CLASS="APPLICATION"
879 >Privoxy</SPAN
880 > itself. <SPAN
881 CLASS="APPLICATION"
882 >Privoxy</SPAN
883 >
884  merely initiates the process and hands it off, and then later reports
885  whatever the outcome was and tries to give a coherent message if there seems
886  to be a problem. In some cases, this might otherwise be mitigated by the
887  browser itself which might try some work-arounds and alternate approaches (e.g
888  adding <SPAN
889 CLASS="QUOTE"
890 >"www."</SPAN
891 > to the URL).</P
892 ><P
893 > In other cases, if <SPAN
894 CLASS="APPLICATION"
895 >Privoxy</SPAN
896 > is being chained
897  with another proxy, this could complicate the issue, and cause undue
898  delays and timeouts. In the case of a <SPAN
899 CLASS="QUOTE"
900 >"socks4a"</SPAN
901 > proxy, the socks
902  server handles all the DNS.  <SPAN
903 CLASS="APPLICATION"
904 >Privoxy</SPAN
905 > would just be
906  the <SPAN
907 CLASS="QUOTE"
908 >"messenger"</SPAN
909 > which is reporting whatever problem occurred
910  downstream, and not the root cause of the error.</P
911 ><P
912 > In any case, versions newer than 3.0.3 include various improvements to help
913  <SPAN
914 CLASS="APPLICATION"
915 >Privoxy</SPAN
916 > better handle these cases.</P
917 ></DIV
918 ><DIV
919 CLASS="SECT2"
920 ><H3
921 CLASS="SECT2"
922 ><A
923 NAME="ALLCPU"
924 >5.18. At one site Privoxy just hangs, and starts taking
925  all CPU. Why is this?</A
926 ></H3
927 ><P
928 > This is probably a manifestation of the <SPAN
929 CLASS="QUOTE"
930 >"100% cpu"</SPAN
931 > problem that
932  occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines
933  are in the raw HTML source of the page, and the browser just ignores them. But the
934  pattern matching in <SPAN
935 CLASS="APPLICATION"
936 >Privoxy's</SPAN
937 > page filtering
938  mechanism is trying to match against absurdly long strings and this becomes
939  very CPU-intensive, taking a long, long time to complete.</P
940 ><P
941 > Until a better solution comes along, disable filtering on these pages,
942  particularly the <TT
943 CLASS="LITERAL"
944 >js-annoyances</TT
945 > and
946  <TT
947 CLASS="LITERAL"
948 >unsolicited-popups</TT
949 > filters. If you run into this problem
950  with a recent <SPAN
951 CLASS="APPLICATION"
952 >Privoxy</SPAN
953 > version, please send a problem report.</P
954 ></DIV
955 ><DIV
956 CLASS="SECT2"
957 ><H3
958 CLASS="SECT2"
959 ><A
960 NAME="SLOWCRAWL"
961 >5.19. I just installed Privoxy, and all my
962 browsing has slowed to a crawl. What gives?</A
963 ></H3
964 ><P
965 > This should not happen, and for the overwhelming number of users world-wide,
966  it does not happen. I would suspect some inadvertent interaction of software
967  components such as anti-virus software, spyware protectors, personal
968  firewalls or similar components. Try disabling (or uninstalling) these one
969  at a time and see if that helps. Either way, if you are using a
970  recent <SPAN
971 CLASS="APPLICATION"
972 >Privoxy</SPAN
973 > version, please report the problem.</P
974 ></DIV
975 ><DIV
976 CLASS="SECT2"
977 ><H3
978 CLASS="SECT2"
979 ><A
980 NAME="PREVENTCOMP"
981 >5.20. Why do my filters work on some sites but not on others?</A
982 ></H3
983 ><P
984 > It's probably due to compression. It is a common practice for web servers to
985  send their content <SPAN
986 CLASS="QUOTE"
987 >"compressed"</SPAN
988 > in order to speed things up, and
989  then let the browser <SPAN
990 CLASS="QUOTE"
991 >"uncompress"</SPAN
992 > them. When compiled with zlib support
993  <SPAN
994 CLASS="APPLICATION"
995 >Privoxy</SPAN
996 > can decompress content before filtering, otherwise you may want to enable
997 <A
998 HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION"
999 TARGET="_top"
1000 >prevent-compression</A
1001 >.</P
1002 ><P
1003 > As of <SPAN
1004 CLASS="APPLICATION"
1005 >Privoxy</SPAN
1006 > 3.0.9, zlib support is enabled in the default builds.</P
1007 ></DIV
1008 ><DIV
1009 CLASS="SECT2"
1010 ><H3
1011 CLASS="SECT2"
1012 ><A
1013 NAME="SSL-WARNINGS"
1014 >5.21. On some HTTPS sites my browser warns me about unauthenticated content,
1015  the URL bar doesn't get highlighted and the lock symbol appears to be broken.
1016  What's going on?</A
1017 ></H3
1018 ><P
1019 > Probably the browser is requesting ads through HTTPS and <SPAN
1020 CLASS="APPLICATION"
1021 >Privoxy</SPAN
1022 >
1023  is blocking the requests. Privoxy's error messages are delivered
1024  unencrypted and while it's obvious for the browser that the HTTPS
1025  request is already blocked by the proxy, some warn about unauthenticated
1026  content anyway.</P
1027 ><P
1028 > To work around the problem you can redirect those requests to an invalid
1029  local address instead of blocking them. While the redirects aren't
1030  encrypted either, many browsers don't care. They simply follow the
1031  redirect, fail to reach a server and display an error message instead
1032  of the ad.</P
1033 ><P
1034 > To do that, enable logging to figure out which requests get blocked by
1035  <SPAN
1036 CLASS="APPLICATION"
1037 >Privoxy</SPAN
1038 > and add the hosts (no path patterns) to a section like this:</P
1039 ><TABLE
1040 BORDER="0"
1041 BGCOLOR="#E0E0E0"
1042 WIDTH="100%"
1043 ><TR
1044 ><TD
1045 ><PRE
1046 CLASS="SCREEN"
1047 >{+redirect{http://127.0.0.1:0/} -block -limit-connect}
1048 .ivwbox.de:443/</PRE
1049 ></TD
1050 ></TR
1051 ></TABLE
1052 ><P
1053 > Additionally you have to configure your browser to contact
1054  <SPAN
1055 CLASS="QUOTE"
1056 >"127.0.0.1:0"</SPAN
1057 > directly (instead of through <SPAN
1058 CLASS="APPLICATION"
1059 >Privoxy</SPAN
1060 >).</P
1061 ><P
1062 > To add a proxy exception in <SPAN
1063 CLASS="APPLICATION"
1064 >Mozilla Firefox</SPAN
1065 >
1066  open the <SPAN
1067 CLASS="QUOTE"
1068 >"Preferences"</SPAN
1069 >, click the <SPAN
1070 CLASS="QUOTE"
1071 >"Settings"</SPAN
1072 >
1073  button located on the <SPAN
1074 CLASS="QUOTE"
1075 >"Network"</SPAN
1076 > tab in the <SPAN
1077 CLASS="QUOTE"
1078 >"Advanced"</SPAN
1079 >
1080  section, and add <SPAN
1081 CLASS="QUOTE"
1082 >"127.0.0.1:0"</SPAN
1083 > in the <SPAN
1084 CLASS="QUOTE"
1085 >"No Proxy for:"</SPAN
1086 >
1087  field.</P
1088 ></DIV
1089 ><DIV
1090 CLASS="SECT2"
1091 ><H3
1092 CLASS="SECT2"
1093 ><A
1094 NAME="SE-LINUX"
1095 >5.22. I get selinux error messages. How can I fix this?</A
1096 ></H3
1097 ><P
1098 > Please report the problem to the creator of your selinux policies.</P
1099 ><P
1100 > The problem is that some selinux policy writers aren't familiar
1101  with the application they are trying to <SPAN
1102 CLASS="QUOTE"
1103 >"secure"</SPAN
1104 > and
1105  thus create policies that make no sense.</P
1106 ><P
1107 > In <SPAN
1108 CLASS="APPLICATION"
1109 >Privoxy's</SPAN
1110 > case the problem usually
1111  is that the policy only allows outgoing connections for certain
1112  destination ports (e.g. 80 and 443). While this may cover the
1113  standard ports, websites occasionally use other ports as well.
1114  This isn't a security problem and therefore <SPAN
1115 CLASS="APPLICATION"
1116 >Privoxy's</SPAN
1117 >
1118  default configuration doesn't block these requests.</P
1119 ><P
1120 > If you really want to block these ports (and don't be able
1121  to load websites that don't use standard ports), you should
1122  configure Privoxy to block these ports as well, so it doesn't
1123  trigger the selinux warnings.</P
1124 ></DIV
1125 ><DIV
1126 CLASS="SECT2"
1127 ><H3
1128 CLASS="SECT2"
1129 ><A
1130 NAME="GENTOO-RICERS"
1131 >5.23. I compiled <SPAN
1132 CLASS="APPLICATION"
1133 >Privoxy</SPAN
1134 > with Gentoo's portage and it appears to be very slow. Why?</A
1135 ></H3
1136 ><P
1137 > Probably you unintentionally compiled <SPAN
1138 CLASS="APPLICATION"
1139 >Privoxy</SPAN
1140 > without threading support
1141  in which case requests have to be serialized and only one can be served
1142  at the same time.</P
1143 ><P
1144 > Check your <SPAN
1145 CLASS="QUOTE"
1146 >"USE"</SPAN
1147 > flags and make sure they include
1148  <SPAN
1149 CLASS="QUOTE"
1150 >"threads"</SPAN
1151 >. If they don't, add the flag and rebuild <SPAN
1152 CLASS="APPLICATION"
1153 >Privoxy</SPAN
1154 >.</P
1155 ><P
1156 > If you compiled <SPAN
1157 CLASS="APPLICATION"
1158 >Privoxy</SPAN
1159 > with threading support (on POSIX-based systems),
1160  the <SPAN
1161 CLASS="QUOTE"
1162 >"Conditional #defines"</SPAN
1163 > section on <A
1164 HREF="http://config.privoxy.org/show-status"
1165 TARGET="_top"
1166 >http://config.privoxy.org/show-status</A
1167 >
1168  will list <SPAN
1169 CLASS="QUOTE"
1170 >"FEATURE_PTHREAD"</SPAN
1171 > as <SPAN
1172 CLASS="QUOTE"
1173 >"enabled"</SPAN
1174 >.</P
1175 ></DIV
1176 ><DIV
1177 CLASS="SECT2"
1178 ><H3
1179 CLASS="SECT2"
1180 ><A
1181 NAME="TAINTED-SOCKETS"
1182 >5.24. What are tainted sockets and how do I prevent them?</A
1183 ></H3
1184 ><P
1185 > <SPAN
1186 CLASS="APPLICATION"
1187 >Privoxy</SPAN
1188 > marks sockets as tainted when it can't use them to
1189  serve additional requests.
1190  This does not necessarily mean that something went wrong and
1191  information about tainted sockets is only logged if connection
1192  debugging is enabled (debug 2).</P
1193 ><P
1194 > For example server sockets that were used for CONNECT requests
1195  (which are used to tunnel https:// requests) are considered tainted
1196  once the client closed its connection to <SPAN
1197 CLASS="APPLICATION"
1198 >Privoxy</SPAN
1199 >.
1200  Technically <SPAN
1201 CLASS="APPLICATION"
1202 >Privoxy</SPAN
1203 > could keep the connection to the server open,
1204  but the server would not accept requests that do not belong to the
1205  previous TLS/SSL session (and the client may even have terminated
1206  the session).</P
1207 ><P
1208 > Server sockets are also marked tainted when a client requests a
1209  resource, but closes the connection before <SPAN
1210 CLASS="APPLICATION"
1211 >Privoxy</SPAN
1212 > has completely
1213  received (and forwarded) the resource to the client.
1214  In this case the server would (probably) accept additional requests,
1215  but <SPAN
1216 CLASS="APPLICATION"
1217 >Privoxy</SPAN
1218 > could not get the response without completely reading
1219  the leftovers from the previous response.</P
1220 ><P
1221 > These are just two examples, there are currently a bit more than
1222  25 scenarios in which a socket is considered tainted.</P
1223 ><P
1224 > While sockets can also be marked tainted as a result of a technical
1225  problem that may be worth fixing, the problem will be explicitly
1226  logged as error.</P
1227 ></DIV
1228 ><DIV
1229 CLASS="SECT2"
1230 ><H3
1231 CLASS="SECT2"
1232 ><A
1233 NAME="PCRE-STACK-LIMIT"
1234 >5.25. After adding my custom filters, <SPAN
1235 CLASS="APPLICATION"
1236 >Privoxy</SPAN
1237 > crashes when visitting certain websites</A
1238 ></H3
1239 ><P
1240 > This can happen if your custom filters require more memory than <SPAN
1241 CLASS="APPLICATION"
1242 >Privoxy</SPAN
1243 >
1244  is allowed to use.
1245  Usually the problem is that the operating system enforces a stack size limit
1246  that isn't sufficient.</P
1247 ><P
1248 > Unless the problem occurs with the filters available in the default configuration,
1249  this is not considered a Privoxy bug.</P
1250 ><P
1251 > To prevent the crashes you can rewrite your filter to use less ressources,
1252  increase the relevant memory limit or recompile pcre to use less stack space.
1253  For details please see the
1254  <A
1255 HREF="http://pcre.org/original/doc/html/pcrestack.html"
1256 TARGET="_top"
1257 >pcrestack man page</A
1258 >
1259  and the documentation of your operating system.</P
1260 ></DIV
1261 ><DIV
1262 CLASS="SECT2"
1263 ><H3
1264 CLASS="SECT2"
1265 ><A
1266 NAME="FILE-PERMISSIONS"
1267 >5.26. What to do if editing the config file of privoxy is access denied?</A
1268 ></H3
1269 ><P
1270 > Your userid probably isn't allowed to edit the file.
1271  
1272  On Windows you can use the windows equivalent of sudo:</P
1273 ><TABLE
1274 BORDER="0"
1275 BGCOLOR="#E0E0E0"
1276 WIDTH="100%"
1277 ><TR
1278 ><TD
1279 ><PRE
1280 CLASS="SCREEN"
1281 >runas /user:administrator "notepad \privoxy\config.txt"</PRE
1282 ></TD
1283 ></TR
1284 ></TABLE
1285 ><P
1286 > or fix the file permissions:</P
1287 ><TABLE
1288 BORDER="0"
1289 BGCOLOR="#E0E0E0"
1290 WIDTH="100%"
1291 ><TR
1292 ><TD
1293 ><PRE
1294 CLASS="SCREEN"
1295 >C:\Privoxy&#62;icacls config.txt
1296 config.txt BUILTIN\Administrators:(I)(F)
1297            NT AUTHORITY\SYSTEM:(I)(F)
1298            BUILTIN\Users:(I)(RX)
1299            NT AUTHORITY\Authenticated Users:(I)(M)
1300
1301 Successfully processed 1 files; Failed processing 0 files
1302
1303 C:\Privoxy&#62;icacls config.txt /grant Lee:F
1304 processed file: config.txt
1305 Successfully processed 1 files; Failed processing 0 files
1306
1307 C:\Privoxy&#62;icacls config.txt
1308 config.txt I3668\Lee:(F)
1309            BUILTIN\Administrators:(I)(F)
1310            NT AUTHORITY\SYSTEM:(I)(F)
1311            BUILTIN\Users:(I)(RX)
1312            NT AUTHORITY\Authenticated Users:(I)(M)
1313
1314 Successfully processed 1 files; Failed processing 0 files
1315
1316 C:\Privoxy&#62;</PRE
1317 ></TD
1318 ></TR
1319 ></TABLE
1320 ><P
1321 > or try to point-n-click your way through adjusting the file
1322  permissions in windows explorer.</P
1323 ></DIV
1324 ></DIV
1325 ><DIV
1326 CLASS="NAVFOOTER"
1327 ><HR
1328 ALIGN="LEFT"
1329 WIDTH="100%"><TABLE
1330 SUMMARY="Footer navigation table"
1331 WIDTH="100%"
1332 BORDER="0"
1333 CELLPADDING="0"
1334 CELLSPACING="0"
1335 ><TR
1336 ><TD
1337 WIDTH="33%"
1338 ALIGN="left"
1339 VALIGN="top"
1340 ><A
1341 HREF="misc.html"
1342 ACCESSKEY="P"
1343 >Prev</A
1344 ></TD
1345 ><TD
1346 WIDTH="34%"
1347 ALIGN="center"
1348 VALIGN="top"
1349 ><A
1350 HREF="index.html"
1351 ACCESSKEY="H"
1352 >Home</A
1353 ></TD
1354 ><TD
1355 WIDTH="33%"
1356 ALIGN="right"
1357 VALIGN="top"
1358 ><A
1359 HREF="contact.html"
1360 ACCESSKEY="N"
1361 >Next</A
1362 ></TD
1363 ></TR
1364 ><TR
1365 ><TD
1366 WIDTH="33%"
1367 ALIGN="left"
1368 VALIGN="top"
1369 >Miscellaneous</TD
1370 ><TD
1371 WIDTH="34%"
1372 ALIGN="center"
1373 VALIGN="top"
1374 >&nbsp;</TD
1375 ><TD
1376 WIDTH="33%"
1377 ALIGN="right"
1378 VALIGN="top"
1379 >Contacting the developers, Bug Reporting and Feature Requests</TD
1380 ></TR
1381 ></TABLE
1382 ></DIV
1383 ></BODY
1384 ></HTML
1385 >