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