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