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