doc/webserver/faq/configuration.html

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