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">5. Troubleshooting</H1
  77 ><DIV
  78 CLASS="SECT2"
  79 ><H3
  80 CLASS="SECT2"
  81 ><A
  82 NAME="AEN755">5.1. I just upgraded and am getting <SPAN
  83 CLASS="QUOTE"
  84 >"connection refused"</SPAN
  85 >
  86 with every web page?</H3
  87 ><P
  88 > Either <SPAN
  89 CLASS="APPLICATION"
  90 >Privoxy</SPAN
  91 > is not running, or your
  92  browser is configured for a different port than what
  93  <SPAN
  94 CLASS="APPLICATION"
  95 >Privoxy</SPAN
  96 > is using.</P
  97 ><P
  98 > The old <SPAN
  99 CLASS="APPLICATION"
 100 >Privoxy</SPAN
 101 > (and also
 102  <SPAN
 103 CLASS="APPLICATION"
 104 >Junkbuster</SPAN
 105 >) used port 8000 by
 106  default. This has been changed to port 8118 now, due to a conflict
 107  with NAS (Network Audio Service), which uses port 8000. If you haven't,
 108  you need to change your browser to the new port number, or alternately
 109  change the <A
 110 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 111 TARGET="_top"
 112 ><TT
 113 CLASS="LITERAL"
 114 >listen-address</TT
 115 >
 116  option</A
 117 > in <SPAN
 118 CLASS="APPLICATION"
 119 >Privoxy's</SPAN
 120 > <A
 121 HREF="../user-manual/config.html"
 122 TARGET="_top"
 123 >main configuration file</A
 124 >.</P
 125 ></DIV
 126 ><DIV
 127 CLASS="SECT2"
 128 ><H3
 129 CLASS="SECT2"
 130 ><A
 131 NAME="AEN768">5.2. I just added a new rule, but the steenkin ad is
 132 still getting through. How?</H3
 133 ><P
 134 > If the ad had been displayed before you added its URL, it will probably be
 135  held in the browser's cache for some time, so it will be displayed without
 136  the need for any request to the server, and <SPAN
 137 CLASS="APPLICATION"
 138 >Privoxy</SPAN
 139 >
 140  will not be in the picture. The best thing to do is try flushing the browser's
 141  caches. And then try again.</P
 142 ><P
 143 > If this doesn't help, you probably have an error in the rule you
 144  applied. Try pasting the full URL of the offending ad into <A
 145 HREF="http://config.privoxy.org/show-url-info"
 146 TARGET="_top"
 147 >http://config.privoxy.org/show-url-info</A
 148 >
 149  and see if it really matches your new rule.</P
 150 ></DIV
 151 ><DIV
 152 CLASS="SECT2"
 153 ><H3
 154 CLASS="SECT2"
 155 ><A
 156 NAME="BADSITE">5.3. One of my favorite sites does not work with <SPAN
 157 CLASS="APPLICATION"
 158 >Privoxy</SPAN
 159 >.
 160 What can I do?</H3
 161 ><P
 162 > First verify that it is indeed a <SPAN
 163 CLASS="APPLICATION"
 164 >Privoxy</SPAN
 165 > problem,
 166  by toggling off <SPAN
 167 CLASS="APPLICATION"
 168 >Privoxy</SPAN
 169 > through <A
 170 HREF="http://config.privoxy.org/toggle"
 171 TARGET="_top"
 172 >http://config.privoxy.org/toggle</A
 173 >,
 174  and then shift-reloading the problem page (i.e. holding down the shift key
 175  while clicking reload. Alternatively, flush your browser's disk and memory
 176  caches).</P
 177 ><P
 178 > If still a problem, go to <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 paste the full URL of the page in question into the prompt. See which actions
 184  are being applied to the URL, and which matches in which actions files are
 185  responsible for that. Now, armed with this information, go to <A
 186 HREF="http://config.privoxy.org/show-status"
 187 TARGET="_top"
 188 >http://config.privoxy.org/show-status</A
 189 >
 190  and select the appropriate actions files for editing.</P
 191 ><P
 192 > You can now either look for a section which disables the actions that
 193  you suspect to cause the problem and add a pattern for your site there,
 194  or make up a completely new section for your site. In any case, the recommended
 195  way is to disable only the prime suspect, reload the problem page, and only
 196  if the problem persists, disable more and more actions until you have
 197  identified the culprit. You may or may not want to turn the other actions
 198  on again. Remember to flush your browser's caches in between any such changes!</P
 199 ><P
 200 > Alternately, if you are comfortable with a text editor, you can accomplish
 201  the same thing by editing the appropriate actions file. Probably the easiest
 202  way to deal with such problems when editing by hand is to add your
 203  site to a <TT
 204 CLASS="LITERAL"
 205 >{ fragile }</TT
 206 > section in <TT
 207 CLASS="FILENAME"
 208 >user.action</TT
 209 >,
 210  which is an alias that turns off most <SPAN
 211 CLASS="QUOTE"
 212 >"dangerous"</SPAN
 213 >
 214  actions, but is also likely to turn off more actions then needed, and thus lower
 215  your privacy and protection more than necessary, </P
 216 ><P
 217 > Troubleshooting actions is discussed in more detail in the <A
 218 HREF="../user-manual/appendix.html#ACTIONSANAT"
 219 TARGET="_top"
 220 >user-manual appendix</A
 221 >.
 222  There is also an <A
 223 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
 224 TARGET="_top"
 225 >actions tutorial</A
 226 >.</P
 227 ></DIV
 228 ><DIV
 229 CLASS="SECT2"
 230 ><H3
 231 CLASS="SECT2"
 232 ><A
 233 NAME="DUN">5.4. After installing <SPAN
 234 CLASS="APPLICATION"
 235 >Privoxy</SPAN
 236 >, I have to log in
 237 every time I start IE. What gives?</H3
 238 ><P
 239 > This is a quirk that effects the installation of
 240  <SPAN
 241 CLASS="APPLICATION"
 242 >Privoxy</SPAN
 243 >, in conjunction with Internet Explorer and
 244  Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
 245  appear to be corrupted or invalid DUN settings, or passwords.</P
 246 ><P
 247 > When setting up an NT based Windows system with
 248  <SPAN
 249 CLASS="APPLICATION"
 250 >Privoxy</SPAN
 251 > you may find that things do not seem to be
 252  doing what you expect. When you set your system up you will probably have set
 253  up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
 254  logged in with administrator privileges. You will probably have made this DUN
 255  connection available to other accounts that you may have set-up on your
 256  system. E.g. Mum or Dad sets up the system and makes accounts suitably
 257  configured for the kids.</P
 258 ><P
 259 > When setting up <SPAN
 260 CLASS="APPLICATION"
 261 >Privoxy</SPAN
 262 > in this environment you
 263  will have to alter the proxy set-up of Internet Explorer (IE) for the
 264  specific DUN connection on which you wish to use
 265  <SPAN
 266 CLASS="APPLICATION"
 267 >Privoxy</SPAN
 268 >. When you do this the ICS DUN set-up
 269  becomes user specific. In this instance you will see no difference if you
 270  change the DUN connection under the account used to set-up the connection.
 271  However when you do this from another user you will notice that the DUN
 272  connection changes to make available to "Me only". You will also find that
 273  you have to store the password under each different user!</P
 274 ><P
 275 > The reason for this is that each user's set-up for IE is user specific. Each
 276  set-up DUN connection and each LAN connection in IE store the settings for
 277  each user individually. As such this enforces individual configurations
 278  rather than common ones. Hence the first time you use a DUN connection after
 279  re-booting your system it may not perform as you expect, and prompt you for
 280  the password. Just set and save the password again and all should be OK.</P
 281 ><P
 282 >[Thanks to Ray Griffith for this submission.]</P
 283 ></DIV
 284 ><DIV
 285 CLASS="SECT2"
 286 ><H3
 287 CLASS="SECT2"
 288 ><A
 289 NAME="FTP">5.5. I cannot connect to any FTP sites. <SPAN
 290 CLASS="APPLICATION"
 291 >Privoxy</SPAN
 292 >
 293  seems to be blocking me.</H3
 294 ><P
 295 >  <SPAN
 296 CLASS="APPLICATION"
 297 >Privoxy</SPAN
 298 > cannot act as a proxy for FTP traffic,
 299   so do not configure your browser to use <SPAN
 300 CLASS="APPLICATION"
 301 >Privoxy</SPAN
 302 >
 303   as an FTP proxy. The same is true for any protocol other than HTTP or HTTPS.
 304  </P
 305 ></DIV
 306 ><DIV
 307 CLASS="SECT2"
 308 ><H3
 309 CLASS="SECT2"
 310 ><A
 311 NAME="OSXIE">5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use
 312  <SPAN
 313 CLASS="APPLICATION"
 314 >Privoxy</SPAN
 315 > as the HTTP proxy.</H3
 316 ><P
 317 >  Microsoft Internet Explorer (in versions like 5.1) respects system-wide
 318   network settings.  In order to change the HTTP proxy, open System
 319   Preferences, and click on the Network icon.  In the settings pane that
 320   comes up, click on the Proxies tab.  Ensure the "Web Proxy (HTTP)" checkbox
 321   is checked and enter <TT
 322 CLASS="LITERAL"
 323 >127.0.0.1</TT
 324 > in the entry field.
 325   Enter <TT
 326 CLASS="LITERAL"
 327 >8118</TT
 328 > in the Port field.  The next time you start
 329   IE, it should reflect these values.
 330  </P
 331 ></DIV
 332 ><DIV
 333 CLASS="SECT2"
 334 ><H3
 335 CLASS="SECT2"
 336 ><A
 337 NAME="OSXUNINSTALL">5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to
 338  uninstall it.  Now the finder tells me I don't have sufficient privileges to
 339  empty the trash.</H3
 340 ><P
 341 >  Just dragging the <SPAN
 342 CLASS="APPLICATION"
 343 >Privoxy</SPAN
 344 > folder to the trash is
 345   not enough to delete it.  <SPAN
 346 CLASS="APPLICATION"
 347 >Privoxy</SPAN
 348 > supplies an
 349   <SPAN
 350 CLASS="APPLICATION"
 351 >uninstall.command</SPAN
 352 > file that takes care of
 353   these details.  Open the trash, drag the <SPAN
 354 CLASS="APPLICATION"
 355 >uninstall.command</SPAN
 356 >
 357   file out of the trash and double-click on it.  You will be prompted for
 358   confirmation and the administration password.
 359  </P
 360 ><P
 361 >  The trash may still appear full after this command; emptying the trash
 362   from the desktop should make it appear empty again.
 363  </P
 364 ></DIV
 365 ><DIV
 366 CLASS="SECT2"
 367 ><H3
 368 CLASS="SECT2"
 369 ><A
 370 NAME="BLANKPAGE">5.8. I get a completely blank page at one site. <SPAN
 371 CLASS="QUOTE"
 372 >"View Source"</SPAN
 373 >
 374  shows only: <SPAN
 375 CLASS="MARKUP"
 376 >&#60;html&#62;&#60;body&#62;&#60;/body&#62;&#60;/html&#62;</SPAN
 377 >.</H3
 378 ><P
 379 >  This is often the result of a webserver using
 380   <SPAN
 381 CLASS="APPLICATION"
 382 >PHP</SPAN
 383 > that mishandles the request
 384   <SPAN
 385 CLASS="APPLICATION"
 386 >Privoxy</SPAN
 387 > sends to not compress the content
 388   (a <SPAN
 389 CLASS="APPLICATION"
 390 >PHP</SPAN
 391 > bug).
 392  </P
 393 ><P
 394 >  In a default configuration, <SPAN
 395 CLASS="APPLICATION"
 396 >Privoxy</SPAN
 397 > requests all
 398   data be sent <SPAN
 399 CLASS="QUOTE"
 400 >"uncompressed"</SPAN
 401 >. This is required for the page
 402   filtering and other magic to work. In some rare cases, the browser and
 403   webserver miscommunicate and the result is a totally blank page. The
 404   suggested work around is to selectively turn off this feature for sites
 405   that exhibit such behavior. Example section for <TT
 406 CLASS="FILENAME"
 407 >user.action</TT
 408 >:
 409  </P
 410 ><TABLE
 411 BORDER="0"
 412 BGCOLOR="#E0E0E0"
 413 WIDTH="100%"
 414 ><TR
 415 ><TD
 416 ><PRE
 417 CLASS="SCREEN"
 418 >   # Make exceptions for ill-behaved sites:
 419    #
 420    {-prevent-compression}
 421     .example.com</PRE
 422 ></TD
 423 ></TR
 424 ></TABLE
 425 ></DIV
 426 ></DIV
 427 ><DIV
 428 CLASS="NAVFOOTER"
 429 ><HR
 430 ALIGN="LEFT"
 431 WIDTH="100%"><TABLE
 432 SUMMARY="Footer navigation table"
 433 WIDTH="100%"
 434 BORDER="0"
 435 CELLPADDING="0"
 436 CELLSPACING="0"
 437 ><TR
 438 ><TD
 439 WIDTH="33%"
 440 ALIGN="left"
 441 VALIGN="top"
 442 ><A
 443 HREF="misc.html"
 444 ACCESSKEY="P"
 445 >Prev</A
 446 ></TD
 447 ><TD
 448 WIDTH="34%"
 449 ALIGN="center"
 450 VALIGN="top"
 451 ><A
 452 HREF="index.html"
 453 ACCESSKEY="H"
 454 >Home</A
 455 ></TD
 456 ><TD
 457 WIDTH="33%"
 458 ALIGN="right"
 459 VALIGN="top"
 460 ><A
 461 HREF="contact.html"
 462 ACCESSKEY="N"
 463 >Next</A
 464 ></TD
 465 ></TR
 466 ><TR
 467 ><TD
 468 WIDTH="33%"
 469 ALIGN="left"
 470 VALIGN="top"
 471 >Miscellaneous</TD
 472 ><TD
 473 WIDTH="34%"
 474 ALIGN="center"
 475 VALIGN="top"
 476 >&nbsp;</TD
 477 ><TD
 478 WIDTH="33%"
 479 ALIGN="right"
 480 VALIGN="top"
 481 >Contacting the developers, Bug Reporting and Feature Requests</TD
 482 ></TR
 483 ></TABLE
 484 ></DIV
 485 ></BODY
 486 ></HTML
 487 >