doc/webserver/faq/configuration.html

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