doc/webserver/faq/configuration.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Configuration</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy Frequently Asked Questions"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Installation"
  14 HREF="installation.html"><LINK
  15 REL="NEXT"
  16 TITLE="Miscellaneous"
  17 HREF="misc.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="installation.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="misc.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="CONFIGURATION"
  77 >3. Configuration</A
  78 ></H1
  79 ><DIV
  80 CLASS="SECT2"
  81 ><H3
  82 CLASS="SECT2"
  83 ><A
  84 NAME="GETUPDATES"
  85 >3.1. Where can I get updated Actions Files?</A
  86 ></H3
  87 ><P
  88 >   Based on your feedback and the continuing development, updated actions files will be
  89    made available on the <A
  90 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
  91 TARGET="_top"
  92 >files section</A
  93 > of
  94   our <A
  95 HREF="http://sf.net/projects/ijbswa/"
  96 TARGET="_top"
  97 >project page</A
  98 >.
  99  </P
 100 ><P
 101 >  If you wish to receive an email notification whenever we release updates of
 102   <SPAN
 103 CLASS="APPLICATION"
 104 >Privoxy</SPAN
 105 > or the actions file, <A
 106 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 107 TARGET="_top"
 108 >subscribe
 109   to our announce  mailing list</A
 110 >, ijbswa-announce@lists.sourceforge.net.
 111  </P
 112 ></DIV
 113 ><DIV
 114 CLASS="SECT2"
 115 ><H3
 116 CLASS="SECT2"
 117 ><A
 118 NAME="NEWCONFIG"
 119 >3.2. Can I use my old config files?</A
 120 ></H3
 121 ><P
 122 >   The syntax, number, and purpose of configuration files has substantially
 123    changed from <SPAN
 124 CLASS="APPLICATION"
 125 >Junkbuster</SPAN
 126 > and earlier versions
 127    of <SPAN
 128 CLASS="APPLICATION"
 129 >Privoxy</SPAN
 130 >. The old files, like <TT
 131 CLASS="FILENAME"
 132 >blocklist</TT
 133 >
 134    will not work at all. If you are upgrading from a 2.0.x version, you will
 135    need to port your configuration data to the new format. Note that even the
 136    pattern syntax has changed! Even configuration files from the 2.9.x versions
 137    will need to be adapted, as configuration syntax has been very much in flow
 138    in the 2.9.x series.
 139  </P
 140 ></DIV
 141 ><DIV
 142 CLASS="SECT2"
 143 ><H3
 144 CLASS="SECT2"
 145 ><A
 146 NAME="AEN312"
 147 >3.3. What is an <SPAN
 148 CLASS="QUOTE"
 149 >"actions"</SPAN
 150 > file?</A
 151 ></H3
 152 ><P
 153 > <A
 154 HREF="../user-manual/actions-file.html"
 155 TARGET="_top"
 156 >Actions files</A
 157 >
 158  are where various <A
 159 HREF="../user-manual/actions-file.html#ACTIONS"
 160 TARGET="_top"
 161 >actions</A
 162 >
 163  that <SPAN
 164 CLASS="APPLICATION"
 165 >Privoxy</SPAN
 166 > might take while processing a certain
 167  request, are configured. Typically, you would define a set of default actions
 168  that apply to all URLs, then add exceptions to these defaults where needed.</P
 169 ><P
 170 > Actions can be defined on a <A
 171 HREF="../user-manual/actions-file.html#AF-PATTERNS"
 172 TARGET="_top"
 173 >URL pattern</A
 174 > basis, i.e.
 175  for single URLs, whole web sites, groups or parts thereof etc. Actions can also be
 176  grouped together and then applied to requests matching one or more patterns.
 177  There are many possible actions that might apply to any given site. As an example,
 178  if you are blocking cookies as one of your default actions, but need to accept
 179  cookies from a given site, you would need to define an exception for this
 180  site in one of your actions files, preferably in <TT
 181 CLASS="FILENAME"
 182 >user.action</TT
 183 >.</P
 184 ></DIV
 185 ><DIV
 186 CLASS="SECT2"
 187 ><H3
 188 CLASS="SECT2"
 189 ><A
 190 NAME="ACTIONSS"
 191 >3.4. The <SPAN
 192 CLASS="QUOTE"
 193 >"actions"</SPAN
 194 > concept confuses me. Please list
 195 some of these <SPAN
 196 CLASS="QUOTE"
 197 >"actions"</SPAN
 198 >.</A
 199 ></H3
 200 ><P
 201 > For a comprehensive discussion of the actions concept, please refer
 202  to the <A
 203 HREF="../user-manual/actions-file.html"
 204 TARGET="_top"
 205 >actions file
 206  chapter</A
 207 > in the <A
 208 HREF="../user-manual/index.html"
 209 TARGET="_top"
 210 >user
 211  manual</A
 212 >. It includes a <A
 213 HREF="../user-manual/actions-file.html#ACTIONS"
 214 TARGET="_top"
 215 >list of all actions</A
 216 >
 217  and an <A
 218 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
 219 TARGET="_top"
 220 >actions
 221  file tutorial</A
 222 > to get you started.</P
 223 ></DIV
 224 ><DIV
 225 CLASS="SECT2"
 226 ><H3
 227 CLASS="SECT2"
 228 ><A
 229 NAME="AEN331"
 230 >3.5. How are actions files configured? What is the easiest
 231 way to do this?</A
 232 ></H3
 233 ><P
 234 > Actions files are just text files in a special syntax and can be edited
 235  with a text editor. But probably the easiest way is to access
 236  <SPAN
 237 CLASS="APPLICATION"
 238 >Privoxy</SPAN
 239 >'s user interface with your web browser
 240  at <A
 241 HREF="http://config.privoxy.org/"
 242 TARGET="_top"
 243 >http://config.privoxy.org/</A
 244 >
 245  (Shortcut: <A
 246 HREF="http://p.p/"
 247 TARGET="_top"
 248 >http://p.p/</A
 249 >) and then select
 250  <SPAN
 251 CLASS="QUOTE"
 252 >"<A
 253 HREF="http://config.privoxy.org/show-status"
 254 TARGET="_top"
 255 >View &#38;
 256  change the current configuration</A
 257 >"</SPAN
 258 > from the menu.</P
 259 ></DIV
 260 ><DIV
 261 CLASS="SECT2"
 262 ><H3
 263 CLASS="SECT2"
 264 ><A
 265 NAME="AEN339"
 266 >3.6. There are several different <SPAN
 267 CLASS="QUOTE"
 268 >"actions"</SPAN
 269 > files. What are
 270 the differences?</A
 271 ></H3
 272 ><P
 273 > As of <SPAN
 274 CLASS="APPLICATION"
 275 >Privoxy</SPAN
 276 > v2.9.15, three actions files
 277  are being included, to be used for
 278  different purposes: These are
 279  <TT
 280 CLASS="FILENAME"
 281 >default.action</TT
 282 >, the <SPAN
 283 CLASS="QUOTE"
 284 >"main"</SPAN
 285 > actions file
 286  which is actively maintained by the <SPAN
 287 CLASS="APPLICATION"
 288 >Privoxy</SPAN
 289 >
 290  developers, <TT
 291 CLASS="FILENAME"
 292 >user.action</TT
 293 >, where users are encouraged
 294  to make their private customizations, and <TT
 295 CLASS="FILENAME"
 296 >standard.action</TT
 297 >,
 298  which is for internal <SPAN
 299 CLASS="APPLICATION"
 300 >Privoxy</SPAN
 301 > use only.
 302  Please see <A
 303 HREF="../user-manual/actions-file.html"
 304 TARGET="_top"
 305 >the actions chapter</A
 306 >
 307  in the <A
 308 HREF="../user-manual/index.html"
 309 TARGET="_top"
 310 >user manual</A
 311 > for a more
 312  detailed explanation.</P
 313 ><P
 314 > Earlier versions included three different versions of the
 315  <TT
 316 CLASS="FILENAME"
 317 >default.action</TT
 318 > file. The new scheme allows for
 319  greater flexibility of local configuration, and for browser based
 320  selection of pre-defined <SPAN
 321 CLASS="QUOTE"
 322 >"aggressiveness"</SPAN
 323 > levels.</P
 324 ></DIV
 325 ><DIV
 326 CLASS="SECT2"
 327 ><H3
 328 CLASS="SECT2"
 329 ><A
 330 NAME="YAHOO"
 331 >3.7. How can I make my Yahoo/Hotmail/GMX account work?</A
 332 ></H3
 333 ><P
 334 >  The default configuration shouldn't impact the usability of any of these services.
 335   It will, however, make all cookies temporary, so that your browser will forget your
 336   login credentials in between browser sessions. If you would like not to have to log
 337   in manually each time you access those websites, simply turn off all cookie handling
 338   for them in the <TT
 339 CLASS="FILENAME"
 340 >user.action</TT
 341 > file. An example for yahoo might
 342   look like:
 343  </P
 344 ><P
 345 >  <TABLE
 346 BORDER="0"
 347 BGCOLOR="#E0E0E0"
 348 WIDTH="100%"
 349 ><TR
 350 ><TD
 351 ><PRE
 352 CLASS="SCREEN"
 353 ># Allow all cookies for Yahoo login:
 354 #
 355 { -<A
 356 HREF="../user-manual/actions-file.html#CRUNCH-INCOMING-COOKIES"
 357 TARGET="_top"
 358 >crunch-incoming-cookies</A
 359 > -<A
 360 HREF="../user-manual/actions-file.html#CRUNCH-OUTGOING-COOKIES"
 361 TARGET="_top"
 362 >crunch-outgoing-cookies</A
 363 > -<A
 364 HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY"
 365 TARGET="_top"
 366 >session-cookies-only</A
 367 > }
 368 .login.yahoo.com</PRE
 369 ></TD
 370 ></TR
 371 ></TABLE
 372 >
 373  </P
 374 ></DIV
 375 ><DIV
 376 CLASS="SECT2"
 377 ><H3
 378 CLASS="SECT2"
 379 ><A
 380 NAME="CONFIGFILES"
 381 >3.8. What's the difference between the
 382 <SPAN
 383 CLASS="QUOTE"
 384 >"Cautious"</SPAN
 385 >, <SPAN
 386 CLASS="QUOTE"
 387 >"Medium"</SPAN
 388 > and <SPAN
 389 CLASS="QUOTE"
 390 >"Adventuresome"</SPAN
 391 > defaults?</A
 392 ></H3
 393 ><P
 394 >  Configuring <SPAN
 395 CLASS="APPLICATION"
 396 >Privoxy</SPAN
 397 > is not entirely trivial. To
 398   help you get started, we provide you with three different default action
 399   <SPAN
 400 CLASS="QUOTE"
 401 >"profiles"</SPAN
 402 > in the web based actions file editor at <A
 403 HREF="http://config.privoxy.org/show-status"
 404 TARGET="_top"
 405 >http://config.privoxy.org/show-status</A
 406 >.
 407   See the <A
 408 HREF="../user-manual/actions-file.html"
 409 TARGET="_top"
 410 ><I
 411 CLASS="CITETITLE"
 412 >User
 413   Manual</I
 414 ></A
 415 > for a list of actions, and how the default
 416   profiles are set.
 417  </P
 418 ><P
 419 > Where the defaults are likely to break some sites, exceptions for
 420  known popular <SPAN
 421 CLASS="QUOTE"
 422 >"problem"</SPAN
 423 > sites are included, but in
 424  general, the more aggressive your default settings are, the more exceptions
 425  you will have to make later. See the <A
 426 HREF="../user-manual/index.html"
 427 TARGET="_top"
 428 ><I
 429 CLASS="CITETITLE"
 430 >User Manual</I
 431 ></A
 432 >
 433  for a more deatiled discussion.</P
 434 ><P
 435 > It should be noted that the <SPAN
 436 CLASS="QUOTE"
 437 >"Adventuresome"</SPAN
 438 > profile (formerly known
 439  as the <SPAN
 440 CLASS="QUOTE"
 441 >"Advanced"</SPAN
 442 > profile) is not only more
 443  aggressive, but also includes fun and, extreme usage of most of
 444  <SPAN
 445 CLASS="APPLICATION"
 446 >Privoxy's</SPAN
 447 > features. Use at your own risk!</P
 448 ></DIV
 449 ><DIV
 450 CLASS="SECT2"
 451 ><H3
 452 CLASS="SECT2"
 453 ><A
 454 NAME="BROWSECONFIG"
 455 >3.9. Why can I change the configuration
 456 with a browser? Does that not raise security issues?</A
 457 ></H3
 458 ><P
 459 >  It may seem strange that regular users can edit the config files with their
 460   browsers, although the whole <TT
 461 CLASS="FILENAME"
 462 >/etc/privoxy</TT
 463 > hierarchy
 464   belongs to the user <SPAN
 465 CLASS="QUOTE"
 466 >"privoxy"</SPAN
 467 >, with only 644 permissions.
 468  </P
 469 ><P
 470 >  When you use the browser-based editor, <SPAN
 471 CLASS="APPLICATION"
 472 >Privoxy</SPAN
 473 >
 474   itself is writing to the config files.  Because
 475   <SPAN
 476 CLASS="APPLICATION"
 477 >Privoxy</SPAN
 478 > is running as the user <SPAN
 479 CLASS="QUOTE"
 480 >"privoxy"</SPAN
 481 >,
 482   it can update the config files.
 483  </P
 484 ><P
 485 >  If you run <SPAN
 486 CLASS="APPLICATION"
 487 >Privoxy</SPAN
 488 > for multiple untrusted users (e.g. in
 489   a LAN), you will probably want to turn the web-based editor and remote toggle
 490   features off by setting <SPAN
 491 CLASS="QUOTE"
 492 >"<VAR
 493 CLASS="LITERAL"
 494 ><A
 495 HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS"
 496 TARGET="_top"
 497 >enable-edit-actions</A
 498 >
 499   0</VAR
 500 >"</SPAN
 501 > and <SPAN
 502 CLASS="QUOTE"
 503 >"<VAR
 504 CLASS="LITERAL"
 505 ><A
 506 HREF="../user-manual/config.html#ENABLE-REMOTE-TOGGLE"
 507 TARGET="_top"
 508 >enable-remote-toggle</A
 509 >
 510   0</VAR
 511 >"</SPAN
 512 > in the <A
 513 HREF="../user-manual/config.html"
 514 TARGET="_top"
 515 >main configuration file</A
 516 >.
 517  </P
 518 ><P
 519 >  Note that in the default configuration, only local users (i.e. those on
 520   <SPAN
 521 CLASS="QUOTE"
 522 >"localhost"</SPAN
 523 >) can connect to <SPAN
 524 CLASS="APPLICATION"
 525 >Privoxy</SPAN
 526 >,
 527   so this is not (normally) a security problem.
 528  </P
 529 ></DIV
 530 ><DIV
 531 CLASS="SECT2"
 532 ><H3
 533 CLASS="SECT2"
 534 ><A
 535 NAME="AEN404"
 536 >3.10. What is the <TT
 537 CLASS="FILENAME"
 538 >default.filter</TT
 539 > file? What is a <SPAN
 540 CLASS="QUOTE"
 541 >"filter"</SPAN
 542 >?</A
 543 ></H3
 544 ><P
 545 > The <A
 546 HREF="../user-manual/filter-file.html"
 547 TARGET="_top"
 548 ><TT
 549 CLASS="FILENAME"
 550 >default.filter</TT
 551 ></A
 552 >
 553  file is where <SPAN
 554 CLASS="emphasis"
 555 ><I
 556 CLASS="EMPHASIS"
 557 >filters</I
 558 ></SPAN
 559 > are defined, which can be used to modify or
 560  remove, web page content on the fly. Filters apply to <SPAN
 561 CLASS="emphasis"
 562 ><I
 563 CLASS="EMPHASIS"
 564 >anything</I
 565 ></SPAN
 566 >
 567  in the page source, including HTML tags, and JavaScript. Regular expressions are used
 568  to accomplish this. There are a number of pre-defined filters to deal with common
 569  annoyances. The filters are only defined here, to invoke them, you need to use the
 570  <A
 571 HREF="../user-manual/actions-file.html#FILTER"
 572 TARGET="_top"
 573 ><VAR
 574 CLASS="LITERAL"
 575 >filter</VAR
 576 >
 577  action</A
 578 > in one of the actions files. Filtering is automatically
 579  disabled for inappropriate MIME types.</P
 580 ><P
 581 > If you are familiar with regular expressions, and HTML, you can look at
 582  the provided <TT
 583 CLASS="FILENAME"
 584 >default.filter</TT
 585 > with a text editor and define
 586  your own filters.  This is potentially a very powerful feature, but
 587  requires some expertise in both regular expressions and HTML/HTTP. </P
 588 ><P
 589 > Presently, there is no GUI editor option for this part of the configuration,
 590  but you can disable/enable the various pre-defined filters of the included
 591  <TT
 592 CLASS="FILENAME"
 593 >default.filter</TT
 594 > file with the <A
 595 HREF="http://config.privoxy.org/show-status"
 596 TARGET="_top"
 597 >web-based actions file editor</A
 598 >.</P
 599 ></DIV
 600 ><DIV
 601 CLASS="SECT2"
 602 ><H3
 603 CLASS="SECT2"
 604 ><A
 605 NAME="AEN420"
 606 >3.11. How can I set up <SPAN
 607 CLASS="APPLICATION"
 608 >Privoxy</SPAN
 609 > to act as a proxy for my
 610  LAN?</A
 611 ></H3
 612 ><P
 613 > By default, <SPAN
 614 CLASS="APPLICATION"
 615 >Privoxy</SPAN
 616 > only responds to requests
 617  from <VAR
 618 CLASS="LITERAL"
 619 >127.0.0.1</VAR
 620 > (localhost). To have it act as a server for
 621  a network, this needs to be changed in the <A
 622 HREF="../user-manual/config.html"
 623 TARGET="_top"
 624 >main configuration file</A
 625 >. Look for
 626  the <VAR
 627 CLASS="LITERAL"
 628 ><A
 629 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 630 TARGET="_top"
 631 >listen-address</A
 632 ></VAR
 633 >
 634  option, which may be commented out with a <SPAN
 635 CLASS="QUOTE"
 636 >"#"</SPAN
 637 > symbol. Make sure
 638  it is uncommented, and assign it the address of the LAN gateway interface,
 639  and port number to use. Assuming your LAN address is 192.168.1.1 and you
 640  wish to run <SPAN
 641 CLASS="APPLICATION"
 642 >Privoxy</SPAN
 643 > on port 8118, this line
 644  should look like:</P
 645 ><P
 646 > <TABLE
 647 BORDER="0"
 648 BGCOLOR="#E0E0E0"
 649 WIDTH="100%"
 650 ><TR
 651 ><TD
 652 ><PRE
 653 CLASS="SCREEN"
 654 >  listen-address  192.168.1.1:8118</PRE
 655 ></TD
 656 ></TR
 657 ></TABLE
 658 ></P
 659 ><P
 660 > Save the file, and restart <SPAN
 661 CLASS="APPLICATION"
 662 >Privoxy</SPAN
 663 >. Configure
 664  all browsers on the network then to use this address and port number.</P
 665 ><P
 666 > Alternately, you can have <SPAN
 667 CLASS="APPLICATION"
 668 >Privoxy</SPAN
 669 > listen on
 670  all available interfaces:</P
 671 ><P
 672 > <TABLE
 673 BORDER="0"
 674 BGCOLOR="#E0E0E0"
 675 WIDTH="100%"
 676 ><TR
 677 ><TD
 678 ><PRE
 679 CLASS="SCREEN"
 680 >  listen-address    :8118</PRE
 681 ></TD
 682 ></TR
 683 ></TABLE
 684 ></P
 685 ><P
 686 > And then use <SPAN
 687 CLASS="APPLICATION"
 688 >Privoxy's</SPAN
 689 >
 690  <A
 691 HREF="../user-manual/config.html#PERMIT-ACCESS"
 692 TARGET="_top"
 693 >permit-access</A
 694 >
 695  feature to limit connections. A firewall in this situation is recommended
 696  as well.</P
 697 ><P
 698 > The above steps should be the same for any TCP network, regardless of
 699  operating system.</P
 700 ><P
 701 > If you run <SPAN
 702 CLASS="APPLICATION"
 703 >Privoxy</SPAN
 704 > on a LAN with untrusted users,
 705  we recommend that you double-check the <A
 706 HREF="../user-manual/config.html#ACCESS-CONTROL"
 707 TARGET="_top"
 708 >access control and security</A
 709 >
 710  options!</P
 711 ></DIV
 712 ><DIV
 713 CLASS="SECT2"
 714 ><H3
 715 CLASS="SECT2"
 716 ><A
 717 NAME="AEN446"
 718 >3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
 719 ></H3
 720 ><P
 721 > The replacement for blocked images can be controlled with the <A
 722 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
 723 TARGET="_top"
 724 ><VAR
 725 CLASS="LITERAL"
 726 >set-image-blocker</VAR
 727 >
 728  action</A
 729 >. You have the choice of a checkerboard pattern, a transparent 1x1 GIF
 730  image (aka <SPAN
 731 CLASS="QUOTE"
 732 >"blank"</SPAN
 733 >), or a redirect to a custom image of your choice.
 734  Note that this choice only has effect for images which are blocked as images, i.e.
 735  whose URLs match both a <VAR
 736 CLASS="LITERAL"
 737 ><A
 738 HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
 739 TARGET="_top"
 740 >handle-as-image</A
 741 ></VAR
 742 >
 743  <SPAN
 744 CLASS="emphasis"
 745 ><I
 746 CLASS="EMPHASIS"
 747 >and</I
 748 ></SPAN
 749 > <VAR
 750 CLASS="LITERAL"
 751 ><A
 752 HREF="../user-manual/actions-file.html#BLOCK"
 753 TARGET="_top"
 754 >block</A
 755 ></VAR
 756 > action.</P
 757 ><P
 758 > If you want to see nothing, then change the <A
 759 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
 760 TARGET="_top"
 761 ><VAR
 762 CLASS="LITERAL"
 763 >set-image-blocker</VAR
 764 >
 765  action</A
 766 > to <SPAN
 767 CLASS="QUOTE"
 768 >"blank"</SPAN
 769 >. This can be done by editing the
 770  <TT
 771 CLASS="FILENAME"
 772 >default.action</TT
 773 > file, or trough the <A
 774 HREF="http://config.privoxy.org/show-status"
 775 TARGET="_top"
 776 >web-based actions file editor</A
 777 >.</P
 778 ></DIV
 779 ><DIV
 780 CLASS="SECT2"
 781 ><H3
 782 CLASS="SECT2"
 783 ><A
 784 NAME="AEN463"
 785 >3.13. Why would anybody want to see a checkerboard pattern?</A
 786 ></H3
 787 ><P
 788 > Remember that <A
 789 HREF="general.html#WHATSANAD"
 790 >telling which image is an ad and which
 791  isn't</A
 792 >, is mostly guesswork. While we hope that the standard configuration
 793  is rather smart, it can and will make errors. The checkerboard image is visually
 794  decent, but it shows you that and where images were blocked, which can be very
 795  helpful in case some navigation aid or otherwise innocent image was
 796  erraneously blocked. Some people might also enjoy seeing how many banners
 797  they <SPAN
 798 CLASS="emphasis"
 799 ><I
 800 CLASS="EMPHASIS"
 801 >don't</I
 802 ></SPAN
 803 > have to see..</P
 804 ></DIV
 805 ><DIV
 806 CLASS="SECT2"
 807 ><H3
 808 CLASS="SECT2"
 809 ><A
 810 NAME="AEN468"
 811 >3.14. I see some images being replaced by a text
 812 instead of the checkerboard image. Why and how do I get rid of this?</A
 813 ></H3
 814 ><P
 815 > This happens when the banners are not embedded in the HTML code of the
 816  page itself, but in separate HTML (sub)documents that are loaded into (i)frames
 817  or (i)layers, and these external HTML documents are blocked. Being non-images
 818  they get replaced by a substitute HTML page rather than a substitute image,
 819  which wouldn't work out technically, since the browser expects and accepts
 820  only HTML when it has requested an HTML document. </P
 821 ><P
 822 > The substitute page adapts to the available space and shows itself as a
 823  miniature two-liner if loaded into small frames, or full-blown with a
 824  large red "BLOCKED" banner if space allows.</P
 825 ><P
 826 > If you prefer the banners to be blocked by images, you must see to it that
 827  the HTML documents in which they are embedded are not blocked. Clicking
 828  the <SPAN
 829 CLASS="QUOTE"
 830 >"See why"</SPAN
 831 > link offered in the substitute page will show
 832  you which rule blocked the page. After changing the rule and un-blocking
 833  the HTML documents, the browser will try to load the actual banner images
 834  and the usual image blocking will (hopefully!) kick in.</P
 835 ></DIV
 836 ><DIV
 837 CLASS="SECT2"
 838 ><H3
 839 CLASS="SECT2"
 840 ><A
 841 NAME="SRVANY"
 842 >3.15. Can <SPAN
 843 CLASS="APPLICATION"
 844 >Privoxy</SPAN
 845 > run as a service
 846 on Win2K/NT?</A
 847 ></H3
 848 ><P
 849 > Yes, it can run as a system service using <B
 850 CLASS="COMMAND"
 851 >srvany.exe</B
 852 >.
 853  See the discussion at <A
 854 HREF="http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118"
 855 TARGET="_top"
 856 >http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</A
 857 >,
 858  for details, and a sample configuration.</P
 859 ><P
 860 > Version 3.0.1 fixes the problem where the icon and menu where not available
 861  in the taskbar for this usage.</P
 862 ></DIV
 863 ><DIV
 864 CLASS="SECT2"
 865 ><H3
 866 CLASS="SECT2"
 867 ><A
 868 NAME="OTHERPROXY"
 869 >3.16. How can I make <SPAN
 870 CLASS="APPLICATION"
 871 >Privoxy</SPAN
 872 > work with other
 873 proxies like <SPAN
 874 CLASS="APPLICATION"
 875 >Squid</SPAN
 876 >?</A
 877 ></H3
 878 ><P
 879 > This can be done and is often useful to combine the benefits of
 880  <SPAN
 881 CLASS="APPLICATION"
 882 >Privoxy</SPAN
 883 > with those of a caching proxy.
 884  See the <A
 885 HREF="../user-manual/config.html#FORWARDING"
 886 TARGET="_top"
 887 >forwarding chapter</A
 888 >
 889  in the <A
 890 HREF="../user-manual/index.html"
 891 TARGET="_top"
 892 >user manual</A
 893 > which
 894  describes how to do this.</P
 895 ></DIV
 896 ><DIV
 897 CLASS="SECT2"
 898 ><H3
 899 CLASS="SECT2"
 900 ><A
 901 NAME="PORT-80"
 902 >3.17. Can I just set <SPAN
 903 CLASS="APPLICATION"
 904 >Privoxy</SPAN
 905 > to use port 80
 906 and thus avoid individual browser configuration?</A
 907 ></H3
 908 ><P
 909 > No, its more complicated than that. This only works with special kinds
 910  of proxies known as <SPAN
 911 CLASS="QUOTE"
 912 >"transparent"</SPAN
 913 > proxies (see below).</P
 914 ></DIV
 915 ><DIV
 916 CLASS="SECT2"
 917 ><H3
 918 CLASS="SECT2"
 919 ><A
 920 NAME="TRANSPARENT"
 921 >3.18. Can <SPAN
 922 CLASS="APPLICATION"
 923 >Privoxy</SPAN
 924 > run as a <SPAN
 925 CLASS="QUOTE"
 926 >"transparent"</SPAN
 927 > proxy?</A
 928 ></H3
 929 ><P
 930 > No, <SPAN
 931 CLASS="APPLICATION"
 932 >Privoxy</SPAN
 933 > currently does not have this ability,
 934  though it is planned for a future release. Transparent proxies require
 935  special handling of the request headers beyond what
 936  <SPAN
 937 CLASS="APPLICATION"
 938 >Privoxy</SPAN
 939 > is now capable of.</P
 940 ><P
 941 > Chaining <SPAN
 942 CLASS="APPLICATION"
 943 >Privoxy</SPAN
 944 > behind another proxy that has
 945  this ability should work though.
 946  See the <A
 947 HREF="../user-manual/config.html#FORWARDING"
 948 TARGET="_top"
 949 >forwarding chapter</A
 950 >
 951  in the <A
 952 HREF="../user-manual/index.html"
 953 TARGET="_top"
 954 >user manual</A
 955 >. As
 956  a transparent proxy to be used for chaining we recommend Transproxy
 957  (<A
 958 HREF="http://www.transproxy.nlc.net.au/"
 959 TARGET="_top"
 960 >http://www.transproxy.nlc.net.au/</A
 961 >).</P
 962 ></DIV
 963 ><DIV
 964 CLASS="SECT2"
 965 ><H3
 966 CLASS="SECT2"
 967 ><A
 968 NAME="OUTLOOK"
 969 >3.19. How can I configure <SPAN
 970 CLASS="APPLICATION"
 971 >Privoxy</SPAN
 972 > for use with <SPAN
 973 CLASS="APPLICATION"
 974 >Outlook
 975  Express</SPAN
 976 >?</A
 977 ></H3
 978 ><P
 979 > <SPAN
 980 CLASS="APPLICATION"
 981 >Outlook Express</SPAN
 982 > uses <SPAN
 983 CLASS="APPLICATION"
 984 >Internet Explorer</SPAN
 985 >
 986  components to both render HTML, and fetch any HTTP requests that may be embedded in an HTML email.
 987  So however you have <SPAN
 988 CLASS="APPLICATION"
 989 >Privoxy</SPAN
 990 > configured to work
 991  with IE, this configuration should automatically be shared.</P
 992 ></DIV
 993 ><DIV
 994 CLASS="SECT2"
 995 ><H3
 996 CLASS="SECT2"
 997 ><A
 998 NAME="OUTLOOK-MORE"
 999 >3.20. How can I have separate rules just for HTML mail?</A
1000 ></H3
1001 ><P
1002 > The short answer is, you can't. <SPAN
1003 CLASS="APPLICATION"
1004 >Privoxy</SPAN
1005 > has no way
1006  of knowing which particular application makes a request, so there is no way to
1007  distinguish between web pages and HTML mail.
1008  <SPAN
1009 CLASS="APPLICATION"
1010 >Privoxy</SPAN
1011 > just blindly proxies all requests. In the
1012  case of <SPAN
1013 CLASS="APPLICATION"
1014 >Outlook Express</SPAN
1015 > (see above), OE uses
1016  IE anyway, and there is no way for <SPAN
1017 CLASS="APPLICATION"
1018 >Privoxy</SPAN
1019 > to ever
1020  be able to distinguish between them (nor could any other proxy type application for
1021  that matter).</P
1022 ><P
1023 > For a good discussion of some of the issues involved (including privacy and
1024  security issues), see
1025  <A
1026 HREF="http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118"
1027 TARGET="_top"
1028 >http://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118</A
1029 >.</P
1030 ></DIV
1031 ><DIV
1032 CLASS="SECT2"
1033 ><H3
1034 CLASS="SECT2"
1035 ><A
1036 NAME="ALLOW-COOKIES"
1037 >3.21. How can I allow permanent cookies for my trusted sites?</A
1038 ></H3
1039 ><P
1040 >  There are several actions that relate to cookies. The default behavior is to
1041   allow only <SPAN
1042 CLASS="QUOTE"
1043 >"session cookies"</SPAN
1044 >, which means the cookies only last
1045   for the current browser session. This eliminates most kinds of abuse related
1046   to cookies. But there may be cases where we want cookies to last.</P
1047 ><P
1048 >  To disable all cookie actions, so that cookies are allowed unrestricted,
1049   both in and out, for <VAR
1050 CLASS="LITERAL"
1051 >example.com</VAR
1052 >: </P
1053 ><P
1054 > <TABLE
1055 BORDER="0"
1056 BGCOLOR="#E0E0E0"
1057 WIDTH="100%"
1058 ><TR
1059 ><TD
1060 ><PRE
1061 CLASS="SCREEN"
1062 > { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} }
1063   .example.com</PRE
1064 ></TD
1065 ></TR
1066 ></TABLE
1067 ></P
1068 ><P
1069 > Place the above in <TT
1070 CLASS="FILENAME"
1071 >user.action</TT
1072 >. Note some of these may
1073  be off by default anyway, so this might be redundant, but there is no harm
1074  being explicit in what you want to happen. <TT
1075 CLASS="FILENAME"
1076 >user.action</TT
1077 >
1078  includes an alias for this situation, called
1079  <VAR
1080 CLASS="LITERAL"
1081 >allow-cookies</VAR
1082 >.</P
1083 ></DIV
1084 ></DIV
1085 ><DIV
1086 CLASS="NAVFOOTER"
1087 ><HR
1088 ALIGN="LEFT"
1089 WIDTH="100%"><TABLE
1090 SUMMARY="Footer navigation table"
1091 WIDTH="100%"
1092 BORDER="0"
1093 CELLPADDING="0"
1094 CELLSPACING="0"
1095 ><TR
1096 ><TD
1097 WIDTH="33%"
1098 ALIGN="left"
1099 VALIGN="top"
1100 ><A
1101 HREF="installation.html"
1102 ACCESSKEY="P"
1103 >Prev</A
1104 ></TD
1105 ><TD
1106 WIDTH="34%"
1107 ALIGN="center"
1108 VALIGN="top"
1109 ><A
1110 HREF="index.html"
1111 ACCESSKEY="H"
1112 >Home</A
1113 ></TD
1114 ><TD
1115 WIDTH="33%"
1116 ALIGN="right"
1117 VALIGN="top"
1118 ><A
1119 HREF="misc.html"
1120 ACCESSKEY="N"
1121 >Next</A
1122 ></TD
1123 ></TR
1124 ><TR
1125 ><TD
1126 WIDTH="33%"
1127 ALIGN="left"
1128 VALIGN="top"
1129 >Installation</TD
1130 ><TD
1131 WIDTH="34%"
1132 ALIGN="center"
1133 VALIGN="top"
1134 >&nbsp;</TD
1135 ><TD
1136 WIDTH="33%"
1137 ALIGN="right"
1138 VALIGN="top"
1139 >Miscellaneous</TD
1140 ></TR
1141 ></TABLE
1142 ></DIV
1143 ></BODY
1144 ></HTML
1145 >