doc/webserver/faq/configuration.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Configuration</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><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"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1"></HEAD
  24 ><BODY
  25 CLASS="SECT1"
  26 BGCOLOR="#EEEEEE"
  27 TEXT="#000000"
  28 LINK="#0000FF"
  29 VLINK="#840084"
  30 ALINK="#0000FF"
  31 ><DIV
  32 CLASS="NAVHEADER"
  33 ><TABLE
  34 SUMMARY="Header navigation table"
  35 WIDTH="100%"
  36 BORDER="0"
  37 CELLPADDING="0"
  38 CELLSPACING="0"
  39 ><TR
  40 ><TH
  41 COLSPAN="3"
  42 ALIGN="center"
  43 >Privoxy Frequently Asked Questions</TH
  44 ></TR
  45 ><TR
  46 ><TD
  47 WIDTH="10%"
  48 ALIGN="left"
  49 VALIGN="bottom"
  50 ><A
  51 HREF="installation.html"
  52 ACCESSKEY="P"
  53 >Prev</A
  54 ></TD
  55 ><TD
  56 WIDTH="80%"
  57 ALIGN="center"
  58 VALIGN="bottom"
  59 ></TD
  60 ><TD
  61 WIDTH="10%"
  62 ALIGN="right"
  63 VALIGN="bottom"
  64 ><A
  65 HREF="misc.html"
  66 ACCESSKEY="N"
  67 >Next</A
  68 ></TD
  69 ></TR
  70 ></TABLE
  71 ><HR
  72 ALIGN="LEFT"
  73 WIDTH="100%"></DIV
  74 ><DIV
  75 CLASS="SECT1"
  76 ><H1
  77 CLASS="SECT1"
  78 ><A
  79 NAME="CONFIGURATION"
  80 >3. Configuration</A
  81 ></H1
  82 ><DIV
  83 CLASS="SECT2"
  84 ><H3
  85 CLASS="SECT2"
  86 ><A
  87 NAME="AEN347"
  88 >3.1. What exactly is an <SPAN
  89 CLASS="QUOTE"
  90 >"actions"</SPAN
  91 > file?</A
  92 ></H3
  93 ><P
  94 > <SPAN
  95 CLASS="APPLICATION"
  96 >Privoxy</SPAN
  97 > utilizes the concept of <SPAN
  98 CLASS="QUOTE"
  99 >" <A
 100 HREF="../user-manual/actions-file.html#ACTIONS"
 101 TARGET="_top"
 102 >actions</A
 103 >"</SPAN
 104 >
 105  that are used to manipulate and control web page data.
 106  <A
 107 HREF="../user-manual/actions-file.html"
 108 TARGET="_top"
 109 >Actions files</A
 110 >
 111  are where these <A
 112 HREF="../user-manual/actions-file.html#ACTIONS"
 113 TARGET="_top"
 114 >actions</A
 115 >
 116  that <SPAN
 117 CLASS="APPLICATION"
 118 >Privoxy</SPAN
 119 > could take while processing a certain
 120  request, are configured. Typically, you would define a set of default actions
 121  that apply globally to all URLs, then add exceptions to these defaults where needed.
 122  There is a wide array of actions available that give the user a high degree
 123  of control and flexibility on how to process each and every web page.</P
 124 ><P
 125 > Actions can be defined on a <A
 126 HREF="../user-manual/actions-file.html#AF-PATTERNS"
 127 TARGET="_top"
 128 >URL pattern</A
 129 > basis, i.e.
 130  for single URLs, whole web sites, groups or parts thereof etc. Actions can also be
 131  grouped together and then applied to requests matching one or more patterns.
 132  There are many possible actions that might apply to any given site. As an example,
 133  if you are blocking <A
 134 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 135 TARGET="_top"
 136 >cookies</A
 137 >
 138  as one of your default actions, but need to accept cookies from a given site,
 139  you would need to define an exception for this site in one of your actions
 140  files, preferably in <TT
 141 CLASS="FILENAME"
 142 >user.action</TT
 143 >.</P
 144 ></DIV
 145 ><DIV
 146 CLASS="SECT2"
 147 ><H3
 148 CLASS="SECT2"
 149 ><A
 150 NAME="ACTIONSS"
 151 >3.2. The <SPAN
 152 CLASS="QUOTE"
 153 >"actions"</SPAN
 154 > concept confuses me. Please list
 155 some of these <SPAN
 156 CLASS="QUOTE"
 157 >"actions"</SPAN
 158 >.</A
 159 ></H3
 160 ><P
 161 > For a comprehensive discussion of the actions concept, please refer
 162  to the <A
 163 HREF="../user-manual/actions-file.html"
 164 TARGET="_top"
 165 >actions file
 166  chapter</A
 167 > in the <A
 168 HREF="../user-manual/index.html"
 169 TARGET="_top"
 170 >User
 171  Manual</A
 172 >. It includes a <A
 173 HREF="../user-manual/actions-file.html#ACTIONS"
 174 TARGET="_top"
 175 >list of all actions</A
 176 >
 177  and an <A
 178 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
 179 TARGET="_top"
 180 >actions
 181  file tutorial</A
 182 > to get you started.</P
 183 ></DIV
 184 ><DIV
 185 CLASS="SECT2"
 186 ><H3
 187 CLASS="SECT2"
 188 ><A
 189 NAME="AEN370"
 190 >3.3. How are actions files configured? What is the easiest
 191 way to do this?</A
 192 ></H3
 193 ><P
 194 > Actions files are just text files in a special syntax and can be edited
 195  with a text editor. But probably the easiest way is to access
 196  <SPAN
 197 CLASS="APPLICATION"
 198 >Privoxy</SPAN
 199 >'s user interface with your web browser
 200  at <A
 201 HREF="http://config.privoxy.org/"
 202 TARGET="_top"
 203 >http://config.privoxy.org/</A
 204 >
 205  (Shortcut: <A
 206 HREF="http://p.p/"
 207 TARGET="_top"
 208 >http://p.p/</A
 209 >) and then select
 210  <SPAN
 211 CLASS="QUOTE"
 212 >"<A
 213 HREF="http://config.privoxy.org/show-status"
 214 TARGET="_top"
 215 >View &#38;
 216  change the current configuration</A
 217 >"</SPAN
 218 > from the menu. Note
 219  that this feature must be explicitly enabled in the main config file
 220  (see <A
 221 HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS"
 222 TARGET="_top"
 223 >enable-edit-actions</A
 224 >).</P
 225 ></DIV
 226 ><DIV
 227 CLASS="SECT2"
 228 ><H3
 229 CLASS="SECT2"
 230 ><A
 231 NAME="AEN379"
 232 >3.4. There are several different <SPAN
 233 CLASS="QUOTE"
 234 >"actions"</SPAN
 235 > files. What are
 236 the differences?</A
 237 ></H3
 238 ><P
 239 > Three actions files
 240  are being included by the developers, to be used for
 241  different purposes: These are
 242  <TT
 243 CLASS="FILENAME"
 244 >default.action</TT
 245 >, the <SPAN
 246 CLASS="QUOTE"
 247 >"main"</SPAN
 248 > actions file
 249  which is actively maintained by the <SPAN
 250 CLASS="APPLICATION"
 251 >Privoxy</SPAN
 252 >
 253  developers and typically sets the default policies, <TT
 254 CLASS="FILENAME"
 255 >user.action</TT
 256 >,
 257  where users are encouraged to make their private customizations.
 258  Please see <A
 259 HREF="../user-manual/actions-file.html"
 260 TARGET="_top"
 261 >the actions chapter</A
 262 >
 263  in the <A
 264 HREF="../user-manual/index.html"
 265 TARGET="_top"
 266 >User Manual</A
 267 > for a more
 268  detailed explanation.</P
 269 ><P
 270 > Earlier versions included three different versions of the
 271  <TT
 272 CLASS="FILENAME"
 273 >default.action</TT
 274 > file. The new scheme allows for
 275  greater flexibility of local configuration, and for browser based
 276  selection of pre-defined <SPAN
 277 CLASS="QUOTE"
 278 >"aggressiveness"</SPAN
 279 > levels.</P
 280 ></DIV
 281 ><DIV
 282 CLASS="SECT2"
 283 ><H3
 284 CLASS="SECT2"
 285 ><A
 286 NAME="GETUPDATES"
 287 >3.5. Where can I get updated Actions Files?</A
 288 ></H3
 289 ><P
 290 >  Based on your feedback and the continuing development, updates of
 291   <TT
 292 CLASS="FILENAME"
 293 >default.action</TT
 294 > will be
 295   made available from time to time on the <A
 296 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
 297 TARGET="_top"
 298 >files section</A
 299 > of
 300   our <A
 301 HREF="http://sf.net/projects/ijbswa/"
 302 TARGET="_top"
 303 >project page</A
 304 >.
 305  </P
 306 ><P
 307 >  If you wish to receive an email notification whenever we release updates of
 308   <SPAN
 309 CLASS="APPLICATION"
 310 >Privoxy</SPAN
 311 > or the actions file, <A
 312 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 313 TARGET="_top"
 314 >subscribe
 315   to our announce mailing list</A
 316 >, ijbswa-announce@lists.sourceforge.net.
 317  </P
 318 ></DIV
 319 ><DIV
 320 CLASS="SECT2"
 321 ><H3
 322 CLASS="SECT2"
 323 ><A
 324 NAME="NEWCONFIG"
 325 >3.6. Can I use my old config files?</A
 326 ></H3
 327 ><P
 328 >  The syntax and purpose of configuration files has remained roughly the
 329   same throughout the 3.x series, but backwards compatibility is not guaranteed.
 330   Also each release contains updated, <SPAN
 331 CLASS="QUOTE"
 332 >"improved"</SPAN
 333 > versions and it is
 334   therefore strongly recommended to install the newer configuration files
 335   and merge back your modifications.
 336  </P
 337 ></DIV
 338 ><DIV
 339 CLASS="SECT2"
 340 ><H3
 341 CLASS="SECT2"
 342 ><A
 343 NAME="DIFFICULT"
 344 >3.7. Why is the configuration so complicated?</A
 345 ></H3
 346 ><P
 347 >  <SPAN
 348 CLASS="QUOTE"
 349 >"Complicated"</SPAN
 350 > is in the eye of the beholder. Those that are
 351   familiar with some of the underlying concepts, such as regular expression
 352   syntax, take to it like a fish takes to water. Also, software that tries
 353   hard to be <SPAN
 354 CLASS="QUOTE"
 355 >"user friendly"</SPAN
 356 >, often lacks sophistication and
 357   flexibility. There is always that trade-off there between power vs.
 358   easy-of-use. Furthermore, anyone is welcome to contribute ideas and
 359   implementations to enhance <SPAN
 360 CLASS="APPLICATION"
 361 >Privoxy</SPAN
 362 >.
 363  </P
 364 ></DIV
 365 ><DIV
 366 CLASS="SECT2"
 367 ><H3
 368 CLASS="SECT2"
 369 ><A
 370 NAME="YAHOO"
 371 >3.8. How can I make my Yahoo/Hotmail/Gmail account work?</A
 372 ></H3
 373 ><P
 374 >  The default configuration shouldn't impact the usability of any of these services.
 375   It may, however, make all <A
 376 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 377 TARGET="_top"
 378 >cookies</A
 379 >
 380   temporary, so that your browser will forget your
 381   login credentials in between browser sessions. If you would like not to have to log
 382   in manually each time you access those websites, simply turn off all cookie handling
 383   for them in the <TT
 384 CLASS="FILENAME"
 385 >user.action</TT
 386 > file. An example for yahoo might
 387   look like:
 388  </P
 389 ><P
 390 >  <TABLE
 391 BORDER="0"
 392 BGCOLOR="#E0E0E0"
 393 WIDTH="100%"
 394 ><TR
 395 ><TD
 396 ><PRE
 397 CLASS="SCREEN"
 398 ># Allow all cookies for Yahoo login:
 399 #
 400 { -<A
 401 HREF="../user-manual/actions-file.html#CRUNCH-INCOMING-COOKIES"
 402 TARGET="_top"
 403 >crunch-incoming-cookies</A
 404 > -<A
 405 HREF="../user-manual/actions-file.html#CRUNCH-OUTGOING-COOKIES"
 406 TARGET="_top"
 407 >crunch-outgoing-cookies</A
 408 > -<A
 409 HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY"
 410 TARGET="_top"
 411 >session-cookies-only</A
 412 > }
 413 .login.yahoo.com</PRE
 414 ></TD
 415 ></TR
 416 ></TABLE
 417 >
 418  </P
 419 ><P
 420 >  These kinds of sites are often quite complex and heavy with
 421   <A
 422 HREF="http://en.wikipedia.org/wiki/Javascript"
 423 TARGET="_top"
 424 >Javascript</A
 425 > and
 426   thus <SPAN
 427 CLASS="QUOTE"
 428 >"fragile"</SPAN
 429 >. So if <SPAN
 430 CLASS="emphasis"
 431 ><I
 432 CLASS="EMPHASIS"
 433 >still</I
 434 ></SPAN
 435 > a problem,
 436   we have an <A
 437 HREF="../user-manual/actions-file.html#ALIASES"
 438 TARGET="_top"
 439 >alias</A
 440 > just for such
 441   sticky situations:
 442  </P
 443 ><P
 444 >  <TABLE
 445 BORDER="0"
 446 BGCOLOR="#E0E0E0"
 447 WIDTH="100%"
 448 ><TR
 449 ><TD
 450 ><PRE
 451 CLASS="SCREEN"
 452 ># Gmail is a _fragile_ site:
 453 #
 454 { <TT
 455 CLASS="LITERAL"
 456 >fragile</TT
 457 > }
 458  # Gmail is ...
 459  mail.google.com</PRE
 460 ></TD
 461 ></TR
 462 ></TABLE
 463 >
 464  </P
 465 ><P
 466 >  Be sure to flush your browser's caches whenever making these kinds of
 467   changes, just to make sure the changes <SPAN
 468 CLASS="QUOTE"
 469 >"take"</SPAN
 470 >.
 471  </P
 472 ><P
 473 >  Make sure the domain, host and path are appropriate as well. Your browser can
 474   tell you where you are specifically and you should use that information for
 475   your configuration settings. Note that above it is not referenced as
 476   <TT
 477 CLASS="LITERAL"
 478 >gmail.com</TT
 479 >, which is a valid domain name.
 480  </P
 481 ></DIV
 482 ><DIV
 483 CLASS="SECT2"
 484 ><H3
 485 CLASS="SECT2"
 486 ><A
 487 NAME="CONFIGFILES"
 488 >3.9. What's the difference between the
 489 <SPAN
 490 CLASS="QUOTE"
 491 >"Cautious"</SPAN
 492 >, <SPAN
 493 CLASS="QUOTE"
 494 >"Medium"</SPAN
 495 > and <SPAN
 496 CLASS="QUOTE"
 497 >"Advanced"</SPAN
 498 > defaults?</A
 499 ></H3
 500 ><P
 501 >  Configuring <SPAN
 502 CLASS="APPLICATION"
 503 >Privoxy</SPAN
 504 > is not entirely trivial. To
 505   help you get started, we provide you with three different default action
 506   <SPAN
 507 CLASS="QUOTE"
 508 >"profiles"</SPAN
 509 > in the web based actions file editor at <A
 510 HREF="http://config.privoxy.org/show-status"
 511 TARGET="_top"
 512 >http://config.privoxy.org/show-status</A
 513 >.
 514   See the <A
 515 HREF="../user-manual/actions-file.html"
 516 TARGET="_top"
 517 ><I
 518 CLASS="CITETITLE"
 519 >User
 520   Manual</I
 521 ></A
 522 > for a list of actions, and how the default
 523   profiles are set.
 524  </P
 525 ><P
 526 > Where the defaults are likely to break some sites, exceptions for
 527  known popular <SPAN
 528 CLASS="QUOTE"
 529 >"problem"</SPAN
 530 > sites are included, but in
 531  general, the more aggressive your default settings are, the more exceptions
 532  you will have to make later. New users are best to start off in
 533  <SPAN
 534 CLASS="QUOTE"
 535 >"Cautious"</SPAN
 536 > setting. This is safest and will have the fewest
 537  problems. See the <A
 538 HREF="../user-manual/index.html"
 539 TARGET="_top"
 540 ><I
 541 CLASS="CITETITLE"
 542 >User Manual</I
 543 ></A
 544 >
 545  for a more detailed discussion.</P
 546 ><P
 547 > It should be noted that the <SPAN
 548 CLASS="QUOTE"
 549 >"Advanced"</SPAN
 550 > profile (formerly known
 551  as the <SPAN
 552 CLASS="QUOTE"
 553 >"Adventuresome"</SPAN
 554 > profile) is more
 555  aggressive, and will make use of some of
 556  <SPAN
 557 CLASS="APPLICATION"
 558 >Privoxy's</SPAN
 559 > advanced features. Use at your own risk!</P
 560 ></DIV
 561 ><DIV
 562 CLASS="SECT2"
 563 ><H3
 564 CLASS="SECT2"
 565 ><A
 566 NAME="BROWSECONFIG"
 567 >3.10. Why can I change the configuration
 568 with a browser? Does that not raise security issues?</A
 569 ></H3
 570 ><P
 571 >  It may seem strange that regular users can edit the config files with their
 572   browsers, although the whole <TT
 573 CLASS="FILENAME"
 574 >/etc/privoxy</TT
 575 > hierarchy
 576   belongs to the user <SPAN
 577 CLASS="QUOTE"
 578 >"privoxy"</SPAN
 579 >, with only 644 permissions.
 580  </P
 581 ><P
 582 >  When you use the browser-based editor, <SPAN
 583 CLASS="APPLICATION"
 584 >Privoxy</SPAN
 585 >
 586   itself is writing to the config files.  Because
 587   <SPAN
 588 CLASS="APPLICATION"
 589 >Privoxy</SPAN
 590 > is running as the user <SPAN
 591 CLASS="QUOTE"
 592 >"privoxy"</SPAN
 593 >,
 594   it can update its own config files.
 595  </P
 596 ><P
 597 >  If you run <SPAN
 598 CLASS="APPLICATION"
 599 >Privoxy</SPAN
 600 > for multiple untrusted users (e.g. in
 601   a LAN) or aren't entirely in control of your own browser, you will probably want
 602   to make sure that the the web-based editor and remote toggle features are
 603   <SPAN
 604 CLASS="QUOTE"
 605 >"off"</SPAN
 606 > by setting <SPAN
 607 CLASS="QUOTE"
 608 >"<TT
 609 CLASS="LITERAL"
 610 ><A
 611 HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS"
 612 TARGET="_top"
 613 >enable-edit-actions</A
 614 >
 615   0</TT
 616 >"</SPAN
 617 > and <SPAN
 618 CLASS="QUOTE"
 619 >"<TT
 620 CLASS="LITERAL"
 621 ><A
 622 HREF="../user-manual/config.html#ENABLE-REMOTE-TOGGLE"
 623 TARGET="_top"
 624 >enable-remote-toggle</A
 625 >
 626   0</TT
 627 >"</SPAN
 628 > in the <A
 629 HREF="../user-manual/config.html"
 630 TARGET="_top"
 631 >main configuration file</A
 632 >.
 633  </P
 634 ><P
 635 >  As of <SPAN
 636 CLASS="APPLICATION"
 637 >Privoxy</SPAN
 638 > 3.0.7 these options are disabled by default.
 639  </P
 640 ></DIV
 641 ><DIV
 642 CLASS="SECT2"
 643 ><H3
 644 CLASS="SECT2"
 645 ><A
 646 NAME="AEN474"
 647 >3.11. What is the <TT
 648 CLASS="FILENAME"
 649 >default.filter</TT
 650 > file? What is a <SPAN
 651 CLASS="QUOTE"
 652 >"filter"</SPAN
 653 >?</A
 654 ></H3
 655 ><P
 656 > The <A
 657 HREF="../user-manual/filter-file.html"
 658 TARGET="_top"
 659 ><TT
 660 CLASS="FILENAME"
 661 >default.filter</TT
 662 ></A
 663 >
 664  file is where <SPAN
 665 CLASS="emphasis"
 666 ><I
 667 CLASS="EMPHASIS"
 668 >filters</I
 669 ></SPAN
 670 > as supplied by the developers are defined.
 671  Filters are a special subset of actions that can be used to modify or
 672  remove web page content or headers on the fly. Content filters can
 673  be applied to <SPAN
 674 CLASS="emphasis"
 675 ><I
 676 CLASS="EMPHASIS"
 677 >anything</I
 678 ></SPAN
 679 > in the page source,
 680  header filters can be applied to either server or client headers.
 681  Regular expressions are used to accomplish this.</P
 682 ><P
 683 > There are a number of pre-defined filters to deal with common annoyances. The
 684  filters are only defined here, to invoke them, you need to use the
 685  <A
 686 HREF="../user-manual/actions-file.html#FILTER"
 687 TARGET="_top"
 688 ><TT
 689 CLASS="LITERAL"
 690 >filter</TT
 691 >
 692  action</A
 693 > in one of the actions files. Content filtering is automatically
 694  disabled for inappropriate MIME types, but if you now better than Privoxy
 695  what should or should not be filtered you can filter any content you like.</P
 696 ><P
 697 > Filters should
 698  <SPAN
 699 CLASS="emphasis"
 700 ><I
 701 CLASS="EMPHASIS"
 702 >not</I
 703 ></SPAN
 704 > be confused with <A
 705 HREF="../user-manual/actions-file.html#BLOCK"
 706 TARGET="_top"
 707 ><TT
 708 CLASS="LITERAL"
 709 >blocks</TT
 710 ></A
 711 >, which
 712  is a completely different action, and is more typically used to block ads and
 713  unwanted sites.</P
 714 ><P
 715 > If you are familiar with regular expressions, and HTML, you can look at
 716  the provided <TT
 717 CLASS="FILENAME"
 718 >default.filter</TT
 719 > with a text editor and define
 720  your own filters.  This is potentially a very powerful feature, but
 721  requires some expertise in both regular expressions and HTML/HTTP.
 722   You should
 723  place any modifications to the default filters, or any new ones you create
 724  in a separate file, such as <TT
 725 CLASS="FILENAME"
 726 >user.filter</TT
 727 >, so they won't
 728  be overwritten during upgrades.
 729  The ability to define multiple filter files
 730  in <TT
 731 CLASS="FILENAME"
 732 >config</TT
 733 > is a new feature as of v. 3.0.5.</P
 734 ><P
 735 > There is no GUI editor option for this part of the configuration,
 736  but you can disable/enable the various pre-defined filters of the included
 737  <TT
 738 CLASS="FILENAME"
 739 >default.filter</TT
 740 > file with the <A
 741 HREF="http://config.privoxy.org/show-status"
 742 TARGET="_top"
 743 >web-based actions file editor</A
 744 >.
 745  Note that the custom actions editor must be explicitly enabled in
 746  the main config file (see <A
 747 HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS"
 748 TARGET="_top"
 749 >enable-edit-actions</A
 750 >).</P
 751 ><P
 752 > If you intend to develop your own filters, you might want to have a look at
 753  <A
 754 HREF="http://www.fabiankeil.de/sourcecode/pft/"
 755 TARGET="_top"
 756 >Privoxy-Filter-Test</A
 757 >.</P
 758 ></DIV
 759 ><DIV
 760 CLASS="SECT2"
 761 ><H3
 762 CLASS="SECT2"
 763 ><A
 764 NAME="LANCONFIG"
 765 >3.12. How can I set up Privoxy to act as a proxy for my
 766  LAN?</A
 767 ></H3
 768 ><P
 769 > By default, <SPAN
 770 CLASS="APPLICATION"
 771 >Privoxy</SPAN
 772 > only responds to requests
 773  from <TT
 774 CLASS="LITERAL"
 775 >127.0.0.1</TT
 776 > (localhost). To have it act as a server for
 777  a network, this needs to be changed in the <A
 778 HREF="../user-manual/config.html"
 779 TARGET="_top"
 780 >main configuration file</A
 781 >. Look for
 782  the <TT
 783 CLASS="LITERAL"
 784 ><A
 785 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 786 TARGET="_top"
 787 >listen-address</A
 788 ></TT
 789 >
 790  option, which may be commented out with a <SPAN
 791 CLASS="QUOTE"
 792 >"#"</SPAN
 793 > symbol. Make sure
 794  it is uncommented, and assign it the address of the LAN gateway interface,
 795  and port number to use. Assuming your LAN address is 192.168.1.1 and you
 796  wish to run <SPAN
 797 CLASS="APPLICATION"
 798 >Privoxy</SPAN
 799 > on port 8118, this line
 800  should look like:</P
 801 ><P
 802 > <TABLE
 803 BORDER="0"
 804 BGCOLOR="#E0E0E0"
 805 WIDTH="100%"
 806 ><TR
 807 ><TD
 808 ><PRE
 809 CLASS="SCREEN"
 810 >  listen-address  192.168.1.1:8118</PRE
 811 ></TD
 812 ></TR
 813 ></TABLE
 814 ></P
 815 ><P
 816 > Save the file, and restart <SPAN
 817 CLASS="APPLICATION"
 818 >Privoxy</SPAN
 819 >. Configure
 820  all browsers on the network then to use this address and port number.</P
 821 ><P
 822 > Alternately, you can have <SPAN
 823 CLASS="APPLICATION"
 824 >Privoxy</SPAN
 825 > listen on
 826  all available interfaces:</P
 827 ><P
 828 > <TABLE
 829 BORDER="0"
 830 BGCOLOR="#E0E0E0"
 831 WIDTH="100%"
 832 ><TR
 833 ><TD
 834 ><PRE
 835 CLASS="SCREEN"
 836 >  listen-address    :8118</PRE
 837 ></TD
 838 ></TR
 839 ></TABLE
 840 ></P
 841 ><P
 842 > And then use <SPAN
 843 CLASS="APPLICATION"
 844 >Privoxy's</SPAN
 845 >
 846  <A
 847 HREF="../user-manual/config.html#PERMIT-ACCESS"
 848 TARGET="_top"
 849 >permit-access</A
 850 >
 851  feature to limit connections. A firewall in this situation is recommended
 852  as well.</P
 853 ><P
 854 > The above steps should be the same for any TCP network, regardless of
 855  operating system.</P
 856 ><P
 857 > If you run <SPAN
 858 CLASS="APPLICATION"
 859 >Privoxy</SPAN
 860 > on a LAN with untrusted users,
 861  we recommend that you double-check the <A
 862 HREF="../user-manual/config.html#ACCESS-CONTROL"
 863 TARGET="_top"
 864 >access control and security</A
 865 >
 866  options!</P
 867 ></DIV
 868 ><DIV
 869 CLASS="SECT2"
 870 ><H3
 871 CLASS="SECT2"
 872 ><A
 873 NAME="AEN525"
 874 >3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
 875 ></H3
 876 ><P
 877 > The replacement for blocked images can be controlled with the <A
 878 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
 879 TARGET="_top"
 880 ><TT
 881 CLASS="LITERAL"
 882 >set-image-blocker</TT
 883 >
 884  action</A
 885 >. You have the choice of a checkerboard pattern, a transparent 1x1 GIF
 886  image (aka <SPAN
 887 CLASS="QUOTE"
 888 >"blank"</SPAN
 889 >), or a redirect to a custom image of your choice.
 890  Note that this choice only has effect for images which are blocked as images, i.e.
 891  whose URLs match both a <TT
 892 CLASS="LITERAL"
 893 ><A
 894 HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
 895 TARGET="_top"
 896 >handle-as-image</A
 897 ></TT
 898 >
 899  <SPAN
 900 CLASS="emphasis"
 901 ><I
 902 CLASS="EMPHASIS"
 903 >and</I
 904 ></SPAN
 905 > <TT
 906 CLASS="LITERAL"
 907 ><A
 908 HREF="../user-manual/actions-file.html#BLOCK"
 909 TARGET="_top"
 910 >block</A
 911 ></TT
 912 > action.</P
 913 ><P
 914 > If you want to see nothing, then change the <A
 915 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
 916 TARGET="_top"
 917 ><TT
 918 CLASS="LITERAL"
 919 >set-image-blocker</TT
 920 >
 921  action</A
 922 > to <SPAN
 923 CLASS="QUOTE"
 924 >"blank"</SPAN
 925 >. This can be done by editing the
 926  <TT
 927 CLASS="FILENAME"
 928 >user.action</TT
 929 > file, or through the <A
 930 HREF="http://config.privoxy.org/show-status"
 931 TARGET="_top"
 932 >web-based actions file editor</A
 933 >.</P
 934 ></DIV
 935 ><DIV
 936 CLASS="SECT2"
 937 ><H3
 938 CLASS="SECT2"
 939 ><A
 940 NAME="AEN542"
 941 >3.14. Why would anybody want to see a checkerboard pattern?</A
 942 ></H3
 943 ><P
 944 > Remember that <A
 945 HREF="general.html#WHATSANAD"
 946 >telling which image is an ad and which
 947  isn't</A
 948 >, is an educated guess. While we hope that the standard configuration
 949  is rather smart, it will make occasional mistakes. The checkerboard image is visually
 950  decent, and it shows you where images have been blocked, which can be very
 951  helpful in case some navigation aid or otherwise innocent image was
 952  erroneously blocked. It is recommended for new users so they can
 953  <SPAN
 954 CLASS="QUOTE"
 955 >"see"</SPAN
 956 > what is happening. Some people might also enjoy seeing how
 957  many banners they <SPAN
 958 CLASS="emphasis"
 959 ><I
 960 CLASS="EMPHASIS"
 961 >don't</I
 962 ></SPAN
 963 > have to see.</P
 964 ></DIV
 965 ><DIV
 966 CLASS="SECT2"
 967 ><H3
 968 CLASS="SECT2"
 969 ><A
 970 NAME="AEN548"
 971 >3.15. I see some images being replaced with text
 972 instead of the checkerboard image. Why and how do I get rid of this?</A
 973 ></H3
 974 ><P
 975 > This happens when the banners are not embedded in the HTML code of the
 976  page itself, but in separate HTML (sub)documents that are loaded into (i)frames
 977  or (i)layers, and these external HTML documents are blocked. Being non-images
 978  they get replaced by a substitute HTML page rather than a substitute image,
 979  which wouldn't work out technically, since the browser expects and accepts
 980  only HTML when it has requested an HTML document. </P
 981 ><P
 982 > The substitute page adapts to the available space and shows itself as a
 983  miniature two-liner if loaded into small frames, or full-blown with a
 984  large red "BLOCKED" banner if space allows.</P
 985 ><P
 986 > If you prefer the banners to be blocked by images, you must see to it that
 987  the HTML documents in which they are embedded are not blocked. Clicking
 988  the <SPAN
 989 CLASS="QUOTE"
 990 >"See why"</SPAN
 991 > link offered in the substitute page will show
 992  you which rule blocked the page. After changing the rule and un-blocking
 993  the HTML documents, the browser will try to load the actual banner images
 994  and the usual image blocking will (hopefully!) kick in.</P
 995 ></DIV
 996 ><DIV
 997 CLASS="SECT2"
 998 ><H3
 999 CLASS="SECT2"
1000 ><A
1001 NAME="SRVANY"
1002 >3.16. Can Privoxy run as a service
1003 on Win2K/NT/XP?</A
1004 ></H3
1005 ><P
1006 > Yes. Version 3.0.5 introduces full <SPAN
1007 CLASS="APPLICATION"
1008 >Windows</SPAN
1009 > service
1010  functionality. See <A
1011 HREF="../user-manual/installation.html#installation-pack-win"
1012 TARGET="_top"
1013 > the <I
1014 CLASS="CITETITLE"
1015 >User Manual</I
1016 ></A
1017 > for details on how to install and configure
1018  <SPAN
1019 CLASS="APPLICATION"
1020 >Privoxy</SPAN
1021 > as a service.</P
1022 ><P
1023 > Earlier 3.x versions could run as a system service using <B
1024 CLASS="COMMAND"
1025 >srvany.exe</B
1026 >.
1027  See the discussion at <A
1028 HREF="http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118"
1029 TARGET="_top"
1030 >http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</A
1031 >,
1032  for details, and a sample configuration.</P
1033 ></DIV
1034 ><DIV
1035 CLASS="SECT2"
1036 ><H3
1037 CLASS="SECT2"
1038 ><A
1039 NAME="OTHERPROXY"
1040 >3.17. How can I make Privoxy work with other
1041 proxies like Squid or Tor?</A
1042 ></H3
1043 ><P
1044 > This can be done and is often useful to combine the benefits of
1045  <SPAN
1046 CLASS="APPLICATION"
1047 >Privoxy</SPAN
1048 > with those of a another proxy.
1049  See the <A
1050 HREF="../user-manual/config.html#FORWARDING"
1051 TARGET="_top"
1052 >forwarding chapter</A
1053 >
1054  in the <A
1055 HREF="../user-manual/index.html"
1056 TARGET="_top"
1057 >User Manual</A
1058 > which
1059  describes how to do this, and the <A
1060 HREF="misc.html#TOR"
1061 > How do I use Privoxy together with
1062  Tor</A
1063 > section below.</P
1064 ></DIV
1065 ><DIV
1066 CLASS="SECT2"
1067 ><H3
1068 CLASS="SECT2"
1069 ><A
1070 NAME="PORT-80"
1071 >3.18. Can I just set Privoxy to use port 80
1072 and thus avoid individual browser configuration?</A
1073 ></H3
1074 ><P
1075 > No, its more complicated than that. This only works with special kinds
1076  of proxies known as <SPAN
1077 CLASS="QUOTE"
1078 >"intercepting"</SPAN
1079 > proxies (see below).</P
1080 ></DIV
1081 ><DIV
1082 CLASS="SECT2"
1083 ><H3
1084 CLASS="SECT2"
1085 ><A
1086 NAME="TRANSPARENT"
1087 >3.19. Can Privoxy run as a <SPAN
1088 CLASS="QUOTE"
1089 >"transparent"</SPAN
1090 > proxy?</A
1091 ></H3
1092 ><P
1093 > The whole idea of Privoxy is to modify client requests
1094  and server responses in all sorts of ways and therefore
1095  it's not a transparent proxy as described in
1096  <A
1097 HREF="http://tools.ietf.org/html/rfc2616"
1098 TARGET="_top"
1099 >RFC 2616</A
1100 >.</P
1101 ><P
1102 > However, some people say <SPAN
1103 CLASS="QUOTE"
1104 >"transparent proxy"</SPAN
1105 > when they
1106  mean <SPAN
1107 CLASS="QUOTE"
1108 >"intercepting proxy"</SPAN
1109 >. If you are one of them,
1110  please read the <A
1111 HREF="#intercepting"
1112 TARGET="_top"
1113 >next entry</A
1114 >.</P
1115 ></DIV
1116 ><DIV
1117 CLASS="SECT2"
1118 ><H3
1119 CLASS="SECT2"
1120 ><A
1121 NAME="INTERCEPTING"
1122 >3.20. Can Privoxy run as a <SPAN
1123 CLASS="QUOTE"
1124 >"intercepting"</SPAN
1125 > proxy?</A
1126 ></H3
1127 ><P
1128 > <SPAN
1129 CLASS="APPLICATION"
1130 >Privoxy</SPAN
1131 > can't intercept traffic itself,
1132   but it can handle requests that where intercepted and redirected
1133   with a packet filter (like <SPAN
1134 CLASS="APPLICATION"
1135 >PF</SPAN
1136 > or
1137   <SPAN
1138 CLASS="APPLICATION"
1139 >iptables</SPAN
1140 >), as long as the <TT
1141 CLASS="LITERAL"
1142 >Host</TT
1143 >
1144   header is present.
1145   </P
1146 ><P
1147 >  As the <TT
1148 CLASS="LITERAL"
1149 >Host</TT
1150 > header is required by HTTP/1.1 and as most
1151   web sites rely on it anyway, this limitation shouldn't be a problem.</P
1152 ><P
1153 >  Please refer to your packet filter's documentation to learn how to
1154   intercept and redirect traffic into <SPAN
1155 CLASS="APPLICATION"
1156 >Privoxy</SPAN
1157 >.
1158   Afterward you just have to configure <SPAN
1159 CLASS="APPLICATION"
1160 >Privoxy</SPAN
1161 > to
1162   <A
1163 HREF="../user-manual/config.html#ACCEPT-INTERCEPTED-REQUESTS"
1164 TARGET="_top"
1165 >accept
1166   intercepted requests</A
1167 >.</P
1168 ></DIV
1169 ><DIV
1170 CLASS="SECT2"
1171 ><H3
1172 CLASS="SECT2"
1173 ><A
1174 NAME="OUTLOOK"
1175 >3.21. How can I configure Privoxy for use with Outlook
1176  Express?</A
1177 ></H3
1178 ><P
1179 > <SPAN
1180 CLASS="APPLICATION"
1181 >Outlook Express</SPAN
1182 > uses <SPAN
1183 CLASS="APPLICATION"
1184 >Internet Explorer</SPAN
1185 >
1186  components to both render HTML, and fetch any HTTP requests that may be embedded in an HTML email.
1187  So however you have <SPAN
1188 CLASS="APPLICATION"
1189 >Privoxy</SPAN
1190 > configured to work
1191  with IE, this configuration should automatically be shared.</P
1192 ></DIV
1193 ><DIV
1194 CLASS="SECT2"
1195 ><H3
1196 CLASS="SECT2"
1197 ><A
1198 NAME="OUTLOOK-MORE"
1199 >3.22. How can I have separate rules just for HTML mail?</A
1200 ></H3
1201 ><P
1202 > The short answer is, you can't. <SPAN
1203 CLASS="APPLICATION"
1204 >Privoxy</SPAN
1205 > has no way
1206  of knowing which particular application makes a request, so there is no way to
1207  distinguish between web pages and HTML mail.
1208  <SPAN
1209 CLASS="APPLICATION"
1210 >Privoxy</SPAN
1211 > just blindly proxies all requests. In the
1212  case of <SPAN
1213 CLASS="APPLICATION"
1214 >Outlook Express</SPAN
1215 > (see above), OE uses
1216  IE anyway, and there is no way for <SPAN
1217 CLASS="APPLICATION"
1218 >Privoxy</SPAN
1219 > to ever
1220  be able to distinguish between them (nor could any other proxy type application for
1221  that matter).</P
1222 ><P
1223 > For a good discussion of some of the issues involved (including privacy and
1224  security issues), see
1225  <A
1226 HREF="http://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118"
1227 TARGET="_top"
1228 >http://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118</A
1229 >.</P
1230 ></DIV
1231 ><DIV
1232 CLASS="SECT2"
1233 ><H3
1234 CLASS="SECT2"
1235 ><A
1236 NAME="SNEAKY-COOKIES"
1237 >3.23. I sometimes notice cookies sneaking through. How?</A
1238 ></H3
1239 ><P
1240 > <A
1241 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
1242 TARGET="_top"
1243 >Cookies</A
1244 > can be
1245  set in several ways. The classic method is via the
1246  <TT
1247 CLASS="LITERAL"
1248 >Set-Cookie</TT
1249 > HTTP header. This is straightforward, and an
1250  easy one to manipulate, such as the <SPAN
1251 CLASS="APPLICATION"
1252 >Privoxy</SPAN
1253 > concept of
1254  <A
1255 HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY"
1256 TARGET="_top"
1257 >session-cookies-only</A
1258 >.
1259  There is also the possibility of using
1260   <A
1261 HREF="http://en.wikipedia.org/wiki/Javascript"
1262 TARGET="_top"
1263 >Javascript</A
1264 > to
1265  set cookies (<SPAN
1266 CLASS="APPLICATION"
1267 >Privoxy</SPAN
1268 > calls these <TT
1269 CLASS="LITERAL"
1270 >content-cookies</TT
1271 >). This
1272  is trickier because the syntax can vary widely, and thus requires a certain
1273  amount of guesswork. It is not realistic to catch all of these short of
1274  disabling Javascript, which would break many sites. And lastly, if the
1275  cookies are embedded in a HTTPS/SSL secure session via Javascript, they are beyond
1276  <SPAN
1277 CLASS="APPLICATION"
1278 >Privoxy's</SPAN
1279 > reach.</P
1280 ><P
1281 > All in all, <SPAN
1282 CLASS="APPLICATION"
1283 >Privoxy</SPAN
1284 > can help manage cookies in general, can help minimize
1285  the loss of privacy posed by cookies, but can't realistically stop all
1286  cookies.</P
1287 ></DIV
1288 ><DIV
1289 CLASS="SECT2"
1290 ><H3
1291 CLASS="SECT2"
1292 ><A
1293 NAME="EVIL-COOKIES"
1294 >3.24. Are all cookies bad? Why?</A
1295 ></H3
1296 ><P
1297 > No, in fact there are many beneficial uses of
1298  <A
1299 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
1300 TARGET="_top"
1301 >cookies</A
1302 >. Cookies are just a
1303  method that browsers can use to store data between pages, or between browser
1304  sessions. Sometimes there is a good reason for this, and the user's life is a
1305  bit easier as a result. But there is a long history of some websites taking
1306  advantage of this layer of trust, and using the data they glean from you and
1307  your browsing habits for their own purposes, and maybe to your potential
1308  detriment. Such sites are using you and storing their data on your system.
1309  That is why the privacy conscious watch from whom those cookies come, and why
1310  they really <SPAN
1311 CLASS="emphasis"
1312 ><I
1313 CLASS="EMPHASIS"
1314 >need</I
1315 ></SPAN
1316 > to be there.</P
1317 ><P
1318 >  See the
1319    <A
1320 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
1321 TARGET="_top"
1322 >Wikipedia cookie
1323   definition</A
1324 > for more.</P
1325 ></DIV
1326 ><DIV
1327 CLASS="SECT2"
1328 ><H3
1329 CLASS="SECT2"
1330 ><A
1331 NAME="ALLOW-COOKIES"
1332 >3.25. How can I allow permanent cookies for my trusted sites?</A
1333 ></H3
1334 ><P
1335 >  There are several actions that relate to cookies. The default behavior is to
1336   allow only <SPAN
1337 CLASS="QUOTE"
1338 >"session cookies"</SPAN
1339 >, which means the cookies only last
1340   for the current browser session. This eliminates most kinds of abuse related
1341   to cookies. But there may be cases where you want cookies to last.</P
1342 ><P
1343 >  To disable all cookie actions, so that cookies are allowed unrestricted,
1344   both in and out, for <TT
1345 CLASS="LITERAL"
1346 >example.com</TT
1347 >: </P
1348 ><P
1349 > <TABLE
1350 BORDER="0"
1351 BGCOLOR="#E0E0E0"
1352 WIDTH="100%"
1353 ><TR
1354 ><TD
1355 ><PRE
1356 CLASS="SCREEN"
1357 > { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} }
1358   .example.com</PRE
1359 ></TD
1360 ></TR
1361 ></TABLE
1362 ></P
1363 ><P
1364 > Place the above in <TT
1365 CLASS="FILENAME"
1366 >user.action</TT
1367 >. Note that some of these may
1368  be off by default anyway, so this might be redundant, but there is no harm
1369  being explicit in what you want to happen. <TT
1370 CLASS="FILENAME"
1371 >user.action</TT
1372 >
1373  includes an alias for this situation, called
1374  <TT
1375 CLASS="LITERAL"
1376 >allow-all-cookies</TT
1377 >.</P
1378 ></DIV
1379 ><DIV
1380 CLASS="SECT2"
1381 ><H3
1382 CLASS="SECT2"
1383 ><A
1384 NAME="MULTIPLES"
1385 >3.26. Can I have separate configurations for different users?</A
1386 ></H3
1387 ><P
1388 > Each instance of <SPAN
1389 CLASS="APPLICATION"
1390 >Privoxy</SPAN
1391 > has its own
1392  configuration, including such attributes as the TCP port that it listens on.
1393  What you can do is run multiple instances of <SPAN
1394 CLASS="APPLICATION"
1395 >Privoxy</SPAN
1396 >, each with
1397  a unique
1398  <A
1399 HREF="../user-manual/config.html#LISTEN-ADDRESS"
1400 TARGET="_top"
1401 >listen-address</A
1402 >
1403  configuration setting, and configuration path, and then
1404  each of these can have their own configurations. Think of it as per-port
1405  configuration.</P
1406 ><P
1407 >
1408  Simple enough for a few users, but for large installations, consider having
1409  groups of users that might share like configurations.</P
1410 ></DIV
1411 ><DIV
1412 CLASS="SECT2"
1413 ><H3
1414 CLASS="SECT2"
1415 ><A
1416 NAME="WHITELISTS"
1417 >3.27. Can I set-up Privoxy as a whitelist of
1418 <SPAN
1419 CLASS="QUOTE"
1420 >"good"</SPAN
1421 > sites?</A
1422 ></H3
1423 ><P
1424 > Sure. There are a couple of things you can do for simple white-listing.
1425  Here's one real easy one:</P
1426 ><TABLE
1427 BORDER="0"
1428 BGCOLOR="#E0E0E0"
1429 WIDTH="100%"
1430 ><TR
1431 ><TD
1432 ><PRE
1433 CLASS="SCREEN"
1434 > ############################################################
1435  # Blacklist
1436  ############################################################
1437  { <A
1438 HREF="../user-manual/actions-file.html#BLOCK"
1439 TARGET="_top"
1440 >+block</A
1441 > }
1442  / # Block *all* URLs
1443
1444  ############################################################
1445  # Whitelist
1446  ############################################################
1447  { <A
1448 HREF="../user-manual/actions-file.html#BLOCK"
1449 TARGET="_top"
1450 >-block</A
1451 > }
1452   kids.example.com
1453   toys.example.com
1454   games.example.com</PRE
1455 ></TD
1456 ></TR
1457 ></TABLE
1458 ><P
1459 > This allows access to only those three sites by first blocking all URLs, and
1460  then subsequently allowing three specific exceptions.</P
1461 ><P
1462 > Another approach is <SPAN
1463 CLASS="APPLICATION"
1464 >Privoxy's</SPAN
1465 >
1466  <TT
1467 CLASS="LITERAL"
1468 >trustfile</TT
1469 > concept, which incorporates the notion of
1470  <SPAN
1471 CLASS="QUOTE"
1472 >"trusted referrers"</SPAN
1473 >. See the <A
1474 HREF="../user-manual/config.html#TRUSTFILE"
1475 TARGET="_top"
1476 >Trust documentation</A
1477 >
1478  for details.</P
1479 ><P
1480 > These are fairly simple approaches and are not completely foolproof. There
1481  are various other configuration options that should be disabled (described
1482  elsewhere here and in <A
1483 HREF="../user-manual/"
1484 TARGET="_top"
1485 >the User Manual</A
1486 >)
1487  so that users can't modify their own configuration and easily circumvent the
1488  whitelist.</P
1489 ></DIV
1490 ><DIV
1491 CLASS="SECT2"
1492 ><H3
1493 CLASS="SECT2"
1494 ><A
1495 NAME="NO-ADBLOCK"
1496 >3.28. How can I turn off ad-blocking?</A
1497 ></H3
1498 ><P
1499 > Ad blocking is achieved through a complex application of various <SPAN
1500 CLASS="APPLICATION"
1501 >Privoxy</SPAN
1502 >
1503  <A
1504 HREF="../user-manual/actions-file.html"
1505 TARGET="_top"
1506 >actions</A
1507 >. These
1508  actions are deployed against simple images, banners, flash animations,
1509  text pages, JavaScript, pop-ups and pop-unders, etc., so its not as simple as
1510  just turning one or two actions off. The various actions that make up
1511  <SPAN
1512 CLASS="APPLICATION"
1513 >Privoxy</SPAN
1514 > ad blocking are hard-coded into the default configuration files. It
1515  has been assumed that everyone using <SPAN
1516 CLASS="APPLICATION"
1517 >Privoxy</SPAN
1518 > is interested in this
1519  particular feature.
1520  </P
1521 ><P
1522 > If you want to do without this, there are several approaches you can take:
1523  You can manually undo the many block rules in
1524  <TT
1525 CLASS="FILENAME"
1526 >default.action</TT
1527 >. Or even easier, just create your own
1528  <TT
1529 CLASS="FILENAME"
1530 >default.action</TT
1531 > file from scratch without the many ad
1532  blocking rules, and corresponding exceptions. Or lastly, if you are not
1533  concerned about the additional blocks that are done for privacy reasons, you
1534  can very easily over-ride <SPAN
1535 CLASS="emphasis"
1536 ><I
1537 CLASS="EMPHASIS"
1538 >all</I
1539 ></SPAN
1540 > blocking with the
1541  following very simple rule in your <TT
1542 CLASS="FILENAME"
1543 >user.action</TT
1544 >:
1545  </P
1546 ><P
1547 > <TABLE
1548 BORDER="0"
1549 BGCOLOR="#E0E0E0"
1550 WIDTH="100%"
1551 ><TR
1552 ><TD
1553 ><PRE
1554 CLASS="SCREEN"
1555 > # Unblock everybody, everywhere
1556  { <A
1557 HREF="../user-manual/actions-file.html#BLOCK"
1558 TARGET="_top"
1559 >-block</A
1560 > }
1561  / # UN-Block *all* URLs</PRE
1562 ></TD
1563 ></TR
1564 ></TABLE
1565 ></P
1566 ><P
1567 >
1568  Or even a more comprehensive reversing of various ad related actions:</P
1569 ><P
1570 > <TABLE
1571 BORDER="0"
1572 BGCOLOR="#E0E0E0"
1573 WIDTH="100%"
1574 ><TR
1575 ><TD
1576 ><PRE
1577 CLASS="SCREEN"
1578 > # Unblock everybody, everywhere, and turn off appropriate filtering, etc
1579  { <A
1580 HREF="../user-manual/actions-file.html#BLOCK"
1581 TARGET="_top"
1582 >-block</A
1583 > \
1584   <A
1585 HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-SIZE"
1586 TARGET="_top"
1587 >-filter{banners-by-size}</A
1588 > \
1589   <A
1590 HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-LINK"
1591 TARGET="_top"
1592 >-filter{banners-by-link}</A
1593 > \
1594   <TT
1595 CLASS="LITERAL"
1596 >allow-popups</TT
1597 > \
1598  }
1599  / # UN-Block *all* URLs and allow ads</PRE
1600 ></TD
1601 ></TR
1602 ></TABLE
1603 ></P
1604 ><P
1605 > This last <SPAN
1606 CLASS="QUOTE"
1607 >"action"</SPAN
1608 > in this compound statement,
1609  <TT
1610 CLASS="LITERAL"
1611 >allow-popups</TT
1612 >, is an <A
1613 HREF="../user-manual/actions-file.html#ALIASES"
1614 TARGET="_top"
1615 >alias</A
1616 > that disables
1617  various pop-up blocking features.</P
1618 ></DIV
1619 ><DIV
1620 CLASS="SECT2"
1621 ><H3
1622 CLASS="SECT2"
1623 ><A
1624 NAME="TEMPLATES"
1625 >3.29. How can I have custom template pages, like the
1626 <SPAN
1627 CLASS="emphasis"
1628 ><I
1629 CLASS="EMPHASIS"
1630 >BLOCKED</I
1631 ></SPAN
1632 > page?</A
1633 ></H3
1634 ><P
1635 > <SPAN
1636 CLASS="APPLICATION"
1637 >Privoxy</SPAN
1638 > <SPAN
1639 CLASS="QUOTE"
1640 >"templates"</SPAN
1641 > are specialized text files utilized by
1642  <SPAN
1643 CLASS="APPLICATION"
1644 >Privoxy</SPAN
1645 > for various purposes and can easily be modified using any text
1646  editor. All the template pages are installed in a sub-directory appropriately
1647  named: <TT
1648 CLASS="FILENAME"
1649 >templates</TT
1650 >.  Knowing something about HTML syntax
1651  will of course be helpful.</P
1652 ><P
1653 > Be forewarned that the default templates are subject to being overwritten
1654  during upgrades. You can, however, create completely new templates,
1655  place them in another directory and specify the alternate path in the main
1656  <TT
1657 CLASS="FILENAME"
1658 >config</TT
1659 >. For details, have a look at the <A
1660 HREF="../user-manual/config.html#templdir"
1661 TARGET="_top"
1662 >templdir</A
1663 > option. </P
1664 ></DIV
1665 ><DIV
1666 CLASS="SECT2"
1667 ><H3
1668 CLASS="SECT2"
1669 ><A
1670 NAME="BLOCKALL"
1671 >3.30. How can I remove the <SPAN
1672 CLASS="QUOTE"
1673 >"Go There Anyway"</SPAN
1674 > link from
1675 the <SPAN
1676 CLASS="emphasis"
1677 ><I
1678 CLASS="EMPHASIS"
1679 >BLOCKED</I
1680 ></SPAN
1681 > page?</A
1682 ></H3
1683 ><P
1684 > There is more than one way to do it (although Perl is not involved).</P
1685 ><P
1686 > Editing the BLOCKED template page (see above) may dissuade some users, but
1687  this method is easily circumvented. Where you need this level of control, you
1688  might want to build <SPAN
1689 CLASS="APPLICATION"
1690 >Privoxy</SPAN
1691 > from source, and disable various features that are
1692  available as compile-time options. You should
1693  <B
1694 CLASS="COMMAND"
1695 >configure</B
1696 > the sources as follows:</P
1697 ><P
1698 > <TABLE
1699 BORDER="0"
1700 BGCOLOR="#E0E0E0"
1701 WIDTH="100%"
1702 ><TR
1703 ><TD
1704 ><PRE
1705 CLASS="SCREEN"
1706 > ./configure  --disable-toggle  --disable-editor  --disable-force</PRE
1707 ></TD
1708 ></TR
1709 ></TABLE
1710 ></P
1711 ><P
1712 > This will create an executable with hard-coded security features so that
1713  <SPAN
1714 CLASS="APPLICATION"
1715 >Privoxy</SPAN
1716 > does not allow easy bypassing of blocked sites, or changing the
1717  current configuration via any connected user's web browser.</P
1718 ><P
1719 > Finally, all of these features can also be toggled on/off via options in
1720  <SPAN
1721 CLASS="APPLICATION"
1722 >Privoxy's</SPAN
1723 > main  <A
1724 HREF="../user-manual/config.html#ACCESS-CONTROL"
1725 TARGET="_top"
1726 >config</A
1727 > file which
1728  means you don't have to recompile anything.</P
1729 ></DIV
1730 ></DIV
1731 ><DIV
1732 CLASS="NAVFOOTER"
1733 ><HR
1734 ALIGN="LEFT"
1735 WIDTH="100%"><TABLE
1736 SUMMARY="Footer navigation table"
1737 WIDTH="100%"
1738 BORDER="0"
1739 CELLPADDING="0"
1740 CELLSPACING="0"
1741 ><TR
1742 ><TD
1743 WIDTH="33%"
1744 ALIGN="left"
1745 VALIGN="top"
1746 ><A
1747 HREF="installation.html"
1748 ACCESSKEY="P"
1749 >Prev</A
1750 ></TD
1751 ><TD
1752 WIDTH="34%"
1753 ALIGN="center"
1754 VALIGN="top"
1755 ><A
1756 HREF="index.html"
1757 ACCESSKEY="H"
1758 >Home</A
1759 ></TD
1760 ><TD
1761 WIDTH="33%"
1762 ALIGN="right"
1763 VALIGN="top"
1764 ><A
1765 HREF="misc.html"
1766 ACCESSKEY="N"
1767 >Next</A
1768 ></TD
1769 ></TR
1770 ><TR
1771 ><TD
1772 WIDTH="33%"
1773 ALIGN="left"
1774 VALIGN="top"
1775 >Installation</TD
1776 ><TD
1777 WIDTH="34%"
1778 ALIGN="center"
1779 VALIGN="top"
1780 >&nbsp;</TD
1781 ><TD
1782 WIDTH="33%"
1783 ALIGN="right"
1784 VALIGN="top"
1785 >Miscellaneous</TD
1786 ></TR
1787 ></TABLE
1788 ></DIV
1789 ></BODY
1790 ></HTML
1791 >