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