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