2703bd328e8cbc5f15237e40fa3032879c82a2a0
[privoxy.git] / 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">3. Configuration</H1
77 ><DIV
78 CLASS="SECT2"
79 ><H3
80 CLASS="SECT2"
81 ><A
82 NAME="GETUPDATES">3.1. Where can I get updated Actions Files?</H3
83 ><P
84 >   Based on your feedback and the continuing development, updated actions files will be
85    made available on the <A
86 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
87 TARGET="_top"
88 >files section</A
89 > of
90   our <A
91 HREF="http://sf.net/projects/ijbswa/"
92 TARGET="_top"
93 >project page</A
94 >.
95  </P
96 ><P
97 >  If you wish to receive an email notification whenever we release updates of
98   <SPAN
99 CLASS="APPLICATION"
100 >Privoxy</SPAN
101 > or the actions file, <A
102 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
103 TARGET="_top"
104 >subscribe
105   to our announce  mailing list</A
106 >, ijbswa-announce@lists.sourceforge.net.
107  </P
108 ></DIV
109 ><DIV
110 CLASS="SECT2"
111 ><H3
112 CLASS="SECT2"
113 ><A
114 NAME="NEWCONFIG">3.2. Can I use my old config files?</H3
115 ><P
116 >   The syntax, number, and purpose of configuration files has substantially
117    changed from <SPAN
118 CLASS="APPLICATION"
119 >Junkbuster</SPAN
120 > and earlier versions
121    of <SPAN
122 CLASS="APPLICATION"
123 >Privoxy</SPAN
124 >. The old files, like <TT
125 CLASS="FILENAME"
126 >blocklist</TT
127 >
128    will not work at all. If you are upgrading from a 2.0.x version, you will
129    need to port your configuration data to the new format. Note that even the
130    pattern syntax has changed! Even configuration files from the 2.9.x versions
131    will need to be adapted, as configuration syntax has been very much in flow
132    in the 2.9.x series.
133  </P
134 ></DIV
135 ><DIV
136 CLASS="SECT2"
137 ><H3
138 CLASS="SECT2"
139 ><A
140 NAME="AEN266">3.3. What is an <SPAN
141 CLASS="QUOTE"
142 >"actions"</SPAN
143 > file?</H3
144 ><P
145 > <A
146 HREF="../user-manual/actions-file.html"
147 TARGET="_top"
148 >Actions files</A
149 >
150  are where various <A
151 HREF="../user-manual/actions-file.html#ACTIONS"
152 TARGET="_top"
153 >actions</A
154 >
155  that <SPAN
156 CLASS="APPLICATION"
157 >Privoxy</SPAN
158 > might take while processing a certain
159  request, are configured. Typically, you would define a set of default actions
160  that apply to all URLs, then add exceptions to these defaults where needed.</P
161 ><P
162 > Actions can be defined on a <A
163 HREF="../user-manual/actions-file.html#AF-PATTERNS"
164 TARGET="_top"
165 >URL pattern</A
166 > basis, i.e.
167  for single URLs, whole web sites, groups or parts thereof etc. Actions can also be
168  grouped together and then applied to requests matching one or more patterns.
169  There are many possible actions that might apply to any given site. As an example,
170  if you are blocking cookies as one of your default actions, but need to accept
171  cookies from a given site, you would need to define an exception for this
172  site in one of your actions files, preferably in <TT
173 CLASS="FILENAME"
174 >user.action</TT
175 ></P
176 ></DIV
177 ><DIV
178 CLASS="SECT2"
179 ><H3
180 CLASS="SECT2"
181 ><A
182 NAME="ACTIONSS">3.4. The <SPAN
183 CLASS="QUOTE"
184 >"actions"</SPAN
185 > concept confuses me. Please list 
186 some of these <SPAN
187 CLASS="QUOTE"
188 >"actions"</SPAN
189 >.</H3
190 ><P
191 > For a comprehensive discussion of the actions concept, please refer
192  to the <A
193 HREF="../user-manual/actions-file.html"
194 TARGET="_top"
195 >actions file
196  chapter</A
197 > in the <A
198 HREF="../user-manual/index.html"
199 TARGET="_top"
200 >user
201  manual</A
202 >. It includes a <A
203 HREF="../user-manual/actions-file.html#ACTIONS"
204 TARGET="_top"
205 >list of all actions</A
206 >
207  and an <A
208 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
209 TARGET="_top"
210 >actions
211  file tutorial</A
212 > to get you started.</P
213 ></DIV
214 ><DIV
215 CLASS="SECT2"
216 ><H3
217 CLASS="SECT2"
218 ><A
219 NAME="AEN285">3.5. How are actions files configured? What is the easiest
220 way to do this?</H3
221 ><P
222 > Actions files are just text files in a special syntax and can be edited
223  with a text editor. But probably the easiest way is to access
224  <SPAN
225 CLASS="APPLICATION"
226 >Privoxy</SPAN
227 >'s user interface with your web browser
228  at <A
229 HREF="http://config.privoxy.org/"
230 TARGET="_top"
231 >http://config.privoxy.org/</A
232 >
233  (Shortcut: <A
234 HREF="http://p.p/"
235 TARGET="_top"
236 >http://p.p/</A
237 >) and then select
238  <SPAN
239 CLASS="QUOTE"
240 >"<A
241 HREF="http://config.privoxy.org/show-status"
242 TARGET="_top"
243 >View &#38;
244  change the current configuration</A
245 >"</SPAN
246 > from the menu.</P
247 ></DIV
248 ><DIV
249 CLASS="SECT2"
250 ><H3
251 CLASS="SECT2"
252 ><A
253 NAME="AEN293">3.6. There are several different <SPAN
254 CLASS="QUOTE"
255 >"actions"</SPAN
256 > files. What are
257 the differences?</H3
258 ><P
259 > As of <SPAN
260 CLASS="APPLICATION"
261 >Privoxy</SPAN
262 > v2.9.15, three actions files 
263  are being included, to be used for 
264  different purposes: These are 
265  <TT
266 CLASS="FILENAME"
267 >default.action</TT
268 >, the <SPAN
269 CLASS="QUOTE"
270 >"main"</SPAN
271 > actions file
272  which is actively maintained by the <SPAN
273 CLASS="APPLICATION"
274 >Privoxy</SPAN
275 >
276  developers, <TT
277 CLASS="FILENAME"
278 >user.action</TT
279 >, where users are encouraged
280  to make their private customizations, and <TT
281 CLASS="FILENAME"
282 >standard.action</TT
283 >, 
284  which is for internal <SPAN
285 CLASS="APPLICATION"
286 >Privoxy</SPAN
287 > use only.
288  Please see <A
289 HREF="../user-manual/actions-file.html"
290 TARGET="_top"
291 >the actions chapter</A
292 >
293  in the <A
294 HREF="../user-manual/index.html"
295 TARGET="_top"
296 >user manual</A
297 > for a more
298  detailed explanation.</P
299 ><P
300 > Earlier versions included three different versions of the 
301  <TT
302 CLASS="FILENAME"
303 >default.action</TT
304 > file. The new scheme allows for 
305  greater flexibility of local configuration, and for browser based 
306  selection of pre-defined <SPAN
307 CLASS="QUOTE"
308 >"aggressiveness"</SPAN
309 > levels.</P
310 ></DIV
311 ><DIV
312 CLASS="SECT2"
313 ><H3
314 CLASS="SECT2"
315 ><A
316 NAME="YAHOO">3.7. How can I make my Yahoo/Hotmail/GMX account work?</H3
317 ><P
318 >  The default configuration shouldn't impact the usability of any of these services.
319   It will, however, make all cookies temporary, so that your browser will forget your
320   login credentials in between browser sessions. If you would like not to have to log
321   in manually each time you access those websites, simply turn off all cookie handling
322   for them in the <TT
323 CLASS="FILENAME"
324 >user.action</TT
325 > file. An example for yahoo might
326   look like:
327  </P
328 ><P
329 >  <TABLE
330 BORDER="0"
331 BGCOLOR="#E0E0E0"
332 WIDTH="100%"
333 ><TR
334 ><TD
335 ><PRE
336 CLASS="SCREEN"
337 ># Allow all cookies for Yahoo login:
338 #
339 { -<A
340 HREF="../user-manual/actions-file.html#CRUNCH-INCOMING-COOKIES"
341 TARGET="_top"
342 >crunch-incoming-cookies</A
343 > -<A
344 HREF="../user-manual/actions-file.html#CRUNCH-OUTGOING-COOKIES"
345 TARGET="_top"
346 >crunch-outgoing-cookies</A
347 > -<A
348 HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY"
349 TARGET="_top"
350 >session-cookies-only</A
351 > }
352 .login.yahoo.com</PRE
353 ></TD
354 ></TR
355 ></TABLE
356 >
357  </P
358 ></DIV
359 ><DIV
360 CLASS="SECT2"
361 ><H3
362 CLASS="SECT2"
363 ><A
364 NAME="CONFIGFILES">3.8. What's the difference between the
365 <SPAN
366 CLASS="QUOTE"
367 >"Cautious"</SPAN
368 >, <SPAN
369 CLASS="QUOTE"
370 >"Medium"</SPAN
371 > and <SPAN
372 CLASS="QUOTE"
373 >"Advanced"</SPAN
374 > defaults?</H3
375 ><P
376 >  Configuring <SPAN
377 CLASS="APPLICATION"
378 >Privoxy</SPAN
379 > is not entirely trivial. To help you get
380   started, we provide you with three different default action <SPAN
381 CLASS="QUOTE"
382 >"packages"</SPAN
383 > in
384   the web based actions file editor at <A
385 HREF="http://config.privoxy.org/show-status"
386 TARGET="_top"
387 >http://config.privoxy.org/show-status</A
388 >.
389   The following table shows you, which of the most important features are enabled in each
390   configuration:
391  </P
392 ><P
393 ><DIV
394 CLASS="TABLE"
395 ><A
396 NAME="AEN328"><P
397 ><B
398 >Table 1. Default Configurations</B
399 ></P
400 ><TABLE
401 BORDER="1"
402 CLASS="CALSTABLE"
403 ><THEAD
404 ><TR
405 ><TH
406 WIDTH="25%"
407 ALIGN="LEFT"
408 VALIGN="TOP"
409 >Feature</TH
410 ><TH
411 WIDTH="25%"
412 ALIGN="LEFT"
413 VALIGN="TOP"
414 >Cautious</TH
415 ><TH
416 WIDTH="25%"
417 ALIGN="LEFT"
418 VALIGN="TOP"
419 >Intermadiate</TH
420 ><TH
421 WIDTH="25%"
422 ALIGN="LEFT"
423 VALIGN="TOP"
424 >Advanced</TH
425 ></TR
426 ></THEAD
427 ><TBODY
428 ><TR
429 ><TD
430 WIDTH="25%"
431 ALIGN="LEFT"
432 VALIGN="TOP"
433 >Ad-blocking by URL</TD
434 ><TD
435 WIDTH="25%"
436 ALIGN="LEFT"
437 VALIGN="TOP"
438 >yes</TD
439 ><TD
440 WIDTH="25%"
441 ALIGN="LEFT"
442 VALIGN="TOP"
443 >yes</TD
444 ><TD
445 WIDTH="25%"
446 ALIGN="LEFT"
447 VALIGN="TOP"
448 >yes</TD
449 ></TR
450 ><TR
451 ><TD
452 WIDTH="25%"
453 ALIGN="LEFT"
454 VALIGN="TOP"
455 >Ad-filtering by size</TD
456 ><TD
457 WIDTH="25%"
458 ALIGN="LEFT"
459 VALIGN="TOP"
460 >yes</TD
461 ><TD
462 WIDTH="25%"
463 ALIGN="LEFT"
464 VALIGN="TOP"
465 >yes</TD
466 ><TD
467 WIDTH="25%"
468 ALIGN="LEFT"
469 VALIGN="TOP"
470 >yes</TD
471 ></TR
472 ><TR
473 ><TD
474 WIDTH="25%"
475 ALIGN="LEFT"
476 VALIGN="TOP"
477 >GIF de-animation</TD
478 ><TD
479 WIDTH="25%"
480 ALIGN="LEFT"
481 VALIGN="TOP"
482 >no</TD
483 ><TD
484 WIDTH="25%"
485 ALIGN="LEFT"
486 VALIGN="TOP"
487 >yes</TD
488 ><TD
489 WIDTH="25%"
490 ALIGN="LEFT"
491 VALIGN="TOP"
492 >yes</TD
493 ></TR
494 ><TR
495 ><TD
496 WIDTH="25%"
497 ALIGN="LEFT"
498 VALIGN="TOP"
499 >Referer forging</TD
500 ><TD
501 WIDTH="25%"
502 ALIGN="LEFT"
503 VALIGN="TOP"
504 >no</TD
505 ><TD
506 WIDTH="25%"
507 ALIGN="LEFT"
508 VALIGN="TOP"
509 >yes</TD
510 ><TD
511 WIDTH="25%"
512 ALIGN="LEFT"
513 VALIGN="TOP"
514 >yes</TD
515 ></TR
516 ><TR
517 ><TD
518 WIDTH="25%"
519 ALIGN="LEFT"
520 VALIGN="TOP"
521 >Cookie handling</TD
522 ><TD
523 WIDTH="25%"
524 ALIGN="LEFT"
525 VALIGN="TOP"
526 >none</TD
527 ><TD
528 WIDTH="25%"
529 ALIGN="LEFT"
530 VALIGN="TOP"
531 >session-only</TD
532 ><TD
533 WIDTH="25%"
534 ALIGN="LEFT"
535 VALIGN="TOP"
536 >kill</TD
537 ></TR
538 ><TR
539 ><TD
540 WIDTH="25%"
541 ALIGN="LEFT"
542 VALIGN="TOP"
543 >Pop-up killing</TD
544 ><TD
545 WIDTH="25%"
546 ALIGN="LEFT"
547 VALIGN="TOP"
548 >no</TD
549 ><TD
550 WIDTH="25%"
551 ALIGN="LEFT"
552 VALIGN="TOP"
553 >yes</TD
554 ><TD
555 WIDTH="25%"
556 ALIGN="LEFT"
557 VALIGN="TOP"
558 >yes</TD
559 ></TR
560 ><TR
561 ><TD
562 WIDTH="25%"
563 ALIGN="LEFT"
564 VALIGN="TOP"
565 >Fast redirects</TD
566 ><TD
567 WIDTH="25%"
568 ALIGN="LEFT"
569 VALIGN="TOP"
570 >no</TD
571 ><TD
572 WIDTH="25%"
573 ALIGN="LEFT"
574 VALIGN="TOP"
575 >no</TD
576 ><TD
577 WIDTH="25%"
578 ALIGN="LEFT"
579 VALIGN="TOP"
580 >yes</TD
581 ></TR
582 ><TR
583 ><TD
584 WIDTH="25%"
585 ALIGN="LEFT"
586 VALIGN="TOP"
587 >HTML taming</TD
588 ><TD
589 WIDTH="25%"
590 ALIGN="LEFT"
591 VALIGN="TOP"
592 >yes</TD
593 ><TD
594 WIDTH="25%"
595 ALIGN="LEFT"
596 VALIGN="TOP"
597 >yes</TD
598 ><TD
599 WIDTH="25%"
600 ALIGN="LEFT"
601 VALIGN="TOP"
602 >yes</TD
603 ></TR
604 ><TR
605 ><TD
606 WIDTH="25%"
607 ALIGN="LEFT"
608 VALIGN="TOP"
609 >JavaScript taming</TD
610 ><TD
611 WIDTH="25%"
612 ALIGN="LEFT"
613 VALIGN="TOP"
614 >yes</TD
615 ><TD
616 WIDTH="25%"
617 ALIGN="LEFT"
618 VALIGN="TOP"
619 >yes</TD
620 ><TD
621 WIDTH="25%"
622 ALIGN="LEFT"
623 VALIGN="TOP"
624 >yes</TD
625 ></TR
626 ><TR
627 ><TD
628 WIDTH="25%"
629 ALIGN="LEFT"
630 VALIGN="TOP"
631 >Web-bug killing</TD
632 ><TD
633 WIDTH="25%"
634 ALIGN="LEFT"
635 VALIGN="TOP"
636 >yes</TD
637 ><TD
638 WIDTH="25%"
639 ALIGN="LEFT"
640 VALIGN="TOP"
641 >yes</TD
642 ><TD
643 WIDTH="25%"
644 ALIGN="LEFT"
645 VALIGN="TOP"
646 >yes</TD
647 ></TR
648 ><TR
649 ><TD
650 WIDTH="25%"
651 ALIGN="LEFT"
652 VALIGN="TOP"
653 >Fun text replacements</TD
654 ><TD
655 WIDTH="25%"
656 ALIGN="LEFT"
657 VALIGN="TOP"
658 >no</TD
659 ><TD
660 WIDTH="25%"
661 ALIGN="LEFT"
662 VALIGN="TOP"
663 >no</TD
664 ><TD
665 WIDTH="25%"
666 ALIGN="LEFT"
667 VALIGN="TOP"
668 >yes</TD
669 ></TR
670 ><TR
671 ><TD
672 WIDTH="25%"
673 ALIGN="LEFT"
674 VALIGN="TOP"
675 >Image tag reordering</TD
676 ><TD
677 WIDTH="25%"
678 ALIGN="LEFT"
679 VALIGN="TOP"
680 >no</TD
681 ><TD
682 WIDTH="25%"
683 ALIGN="LEFT"
684 VALIGN="TOP"
685 >no</TD
686 ><TD
687 WIDTH="25%"
688 ALIGN="LEFT"
689 VALIGN="TOP"
690 >yes</TD
691 ></TR
692 ><TR
693 ><TD
694 WIDTH="25%"
695 ALIGN="LEFT"
696 VALIGN="TOP"
697 >Ad-filtering by link</TD
698 ><TD
699 WIDTH="25%"
700 ALIGN="LEFT"
701 VALIGN="TOP"
702 >no</TD
703 ><TD
704 WIDTH="25%"
705 ALIGN="LEFT"
706 VALIGN="TOP"
707 >no</TD
708 ><TD
709 WIDTH="25%"
710 ALIGN="LEFT"
711 VALIGN="TOP"
712 >yes</TD
713 ></TR
714 ></TBODY
715 ></TABLE
716 ></DIV
717 ></P
718 ><P
719 > Where the defaults are likely to break some sites, exceptions for
720  known popular <SPAN
721 CLASS="QUOTE"
722 >"problem"</SPAN
723 > sites are included, but in
724  general, the more aggressive your default settings are, the more
725  exceptions you will have to make later. See the <A
726 HREF="../user-manual/index.html"
727 TARGET="_top"
728 >user manual</A
729 > for a more
730  deatiled discussion.</P
731 ></DIV
732 ><DIV
733 CLASS="SECT2"
734 ><H3
735 CLASS="SECT2"
736 ><A
737 NAME="BROWSECONFIG">3.9. Why can I change the configuration 
738 with a browser? Does that not raise security issues?</H3
739 ><P
740 >  It may seem strange that regular users can edit the config files with their
741   browsers, although the whole <TT
742 CLASS="FILENAME"
743 >/etc/privoxy</TT
744 > hierarchy
745   belongs to the user <SPAN
746 CLASS="QUOTE"
747 >"privoxy"</SPAN
748 >, with only 644 permissions.
749  </P
750 ><P
751 >  When you use the browser-based editor, <SPAN
752 CLASS="APPLICATION"
753 >Privoxy</SPAN
754 >
755   itself is writing to the config files.  Because
756   <SPAN
757 CLASS="APPLICATION"
758 >Privoxy</SPAN
759 > is running as the user <SPAN
760 CLASS="QUOTE"
761 >"privoxy"</SPAN
762 >,
763   it can update the config files.
764  </P
765 ><P
766 >  If you run <SPAN
767 CLASS="APPLICATION"
768 >Privoxy</SPAN
769 > for multiple untrusted users (e.g. in
770   a LAN), you will probably want to turn the web-based editor and remote toggle
771   features off by setting <SPAN
772 CLASS="QUOTE"
773 >"<TT
774 CLASS="LITERAL"
775 ><A
776 HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS"
777 TARGET="_top"
778 >enable-edit-actions</A
779 >
780   0</TT
781 >"</SPAN
782 > and <SPAN
783 CLASS="QUOTE"
784 >"<TT
785 CLASS="LITERAL"
786 ><A
787 HREF="../user-manual/config.html#ENABLE-REMOTE-TOGGLE"
788 TARGET="_top"
789 >enable-remote-toggle</A
790 >
791   0</TT
792 >"</SPAN
793 > in the <A
794 HREF="../user-manual/config.html"
795 TARGET="_top"
796 >main configuration file</A
797 >.
798  </P
799 ><P
800 >  Note that in the default configuration, only local users (i.e. those on
801   <SPAN
802 CLASS="QUOTE"
803 >"localhost"</SPAN
804 >) can connect to <SPAN
805 CLASS="APPLICATION"
806 >Privoxy</SPAN
807 >,
808   so this is not (normally) a security problem.
809  </P
810 ></DIV
811 ><DIV
812 CLASS="SECT2"
813 ><H3
814 CLASS="SECT2"
815 ><A
816 NAME="AEN431">3.10. What is the <TT
817 CLASS="FILENAME"
818 >default.filter</TT
819 > file? What is a <SPAN
820 CLASS="QUOTE"
821 >"filter"</SPAN
822 >?</H3
823 ><P
824 > The <A
825 HREF="../user-manual/filter-file.html"
826 TARGET="_top"
827 ><TT
828 CLASS="FILENAME"
829 >default.filter</TT
830 ></A
831 >
832  file is where <SPAN
833 CLASS="emphasis"
834 ><I
835 CLASS="EMPHASIS"
836 >filters</I
837 ></SPAN
838 > are defined, which can be used to modify or
839  remove, web page content on the fly. Filters apply to <SPAN
840 CLASS="emphasis"
841 ><I
842 CLASS="EMPHASIS"
843 >anything</I
844 ></SPAN
845 >
846  in the page source, including HTML tags, and JavaScript. Regular expressions are used
847  to accomplish this. There are a number of pre-defined filters to deal with common
848  annoyances. The filters are only defined here, to invoke them, you need to use the
849  <A
850 HREF="../user-manual/actions-file.html#FILTER"
851 TARGET="_top"
852 ><TT
853 CLASS="LITERAL"
854 >filter</TT
855 >
856  action</A
857 > in one of the actions files. Filtering is automatically
858  disabled for inappropriate MIME types.</P
859 ><P
860 > If you are familiar with regular expressions, and HTML, you can look at 
861  the provided <TT
862 CLASS="FILENAME"
863 >default.filter</TT
864 > with a text editor and define
865  your own filters.  This is potentially a very powerful feature, but
866  requires some expertise in both regular expressions and HTML/HTTP. </P
867 ><P
868 > Presently, there is no GUI editor option for this part of the configuration, 
869  but you can disable/enable the various pre-defined filters of the included 
870  <TT
871 CLASS="FILENAME"
872 >default.filter</TT
873 > file with the <A
874 HREF="http://config.privoxy.org/show-status"
875 TARGET="_top"
876 >web-based actions file editor</A
877 >.</P
878 ></DIV
879 ><DIV
880 CLASS="SECT2"
881 ><H3
882 CLASS="SECT2"
883 ><A
884 NAME="AEN447">3.11. How can I set up <SPAN
885 CLASS="APPLICATION"
886 >Privoxy</SPAN
887 > to act as a proxy for my 
888  LAN?</H3
889 ><P
890 > By default, <SPAN
891 CLASS="APPLICATION"
892 >Privoxy</SPAN
893 > only responds to requests 
894  from <TT
895 CLASS="LITERAL"
896 >127.0.0.1</TT
897 > (localhost). To have it act as a server for
898  a network, this needs to be changed in the <A
899 HREF="../user-manual/config.html"
900 TARGET="_top"
901 >main configuration file</A
902 >. Look for
903  the <TT
904 CLASS="LITERAL"
905 ><A
906 HREF="../user-manual/config.html#LISTEN-ADDRESS"
907 TARGET="_top"
908 >listen-address</A
909 ></TT
910 >
911  option, which may be commented out with a <SPAN
912 CLASS="QUOTE"
913 >"#"</SPAN
914 > symbol. Make sure
915  it is uncommented, and assign it the address of the LAN gateway interface,
916  and port number to use. Assuming your LAN address is 192.168.1.1 and you
917  wish to run <SPAN
918 CLASS="APPLICATION"
919 >Privoxy</SPAN
920 > on port 8118, this line
921  should look like:</P
922 ><P
923 > <TABLE
924 BORDER="0"
925 BGCOLOR="#E0E0E0"
926 WIDTH="100%"
927 ><TR
928 ><TD
929 ><PRE
930 CLASS="SCREEN"
931 >  listen-address  192.168.1.1:8118</PRE
932 ></TD
933 ></TR
934 ></TABLE
935 ></P
936 ><P
937 > Save the file, and restart <SPAN
938 CLASS="APPLICATION"
939 >Privoxy</SPAN
940 >. Configure 
941  all browsers on the network then to use this address and port number.</P
942 ><P
943 > If you run <SPAN
944 CLASS="APPLICATION"
945 >Privoxy</SPAN
946 > on a LAN with untrusted users,
947  we recommend that you double-check the <A
948 HREF="../user-manual/config.html#ACCESS-CONTROL"
949 TARGET="_top"
950 >access control and security</A
951 >
952  options!</P
953 ></DIV
954 ><DIV
955 CLASS="SECT2"
956 ><H3
957 CLASS="SECT2"
958 ><A
959 NAME="AEN465">3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</H3
960 ><P
961 > The replacement for blocked images can be controlled with the <A
962 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
963 TARGET="_top"
964 ><TT
965 CLASS="LITERAL"
966 >set-image-blocker</TT
967 >
968  action</A
969 >. You have the choice of a checkerboard pattern, a transparent 1x1 GIF
970  image (aka <SPAN
971 CLASS="QUOTE"
972 >"blank"</SPAN
973 >), or a redirect to a custom image of your choice.
974  Note that this choice only has effect for images which are blocked as images, i.e.
975  whose URLs match both a <TT
976 CLASS="LITERAL"
977 ><A
978 HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
979 TARGET="_top"
980 >handle-as-image</A
981 ></TT
982 >
983  <SPAN
984 CLASS="emphasis"
985 ><I
986 CLASS="EMPHASIS"
987 >and</I
988 ></SPAN
989 > <TT
990 CLASS="LITERAL"
991 ><A
992 HREF="../user-manual/actions-file.html#BLOCK"
993 TARGET="_top"
994 >block</A
995 ></TT
996 > action.</P
997 ><P
998 > If you want to see nothing, then change the <A
999 HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
1000 TARGET="_top"
1001 ><TT
1002 CLASS="LITERAL"
1003 >set-image-blocker</TT
1004 >
1005  action</A
1006 > to <SPAN
1007 CLASS="QUOTE"
1008 >"blank"</SPAN
1009 >. This can be done by editing the 
1010  <TT
1011 CLASS="FILENAME"
1012 >default.action</TT
1013 > file, or trough the <A
1014 HREF="http://config.privoxy.org/show-status"
1015 TARGET="_top"
1016 >web-based actions file editor</A
1017 >.</P
1018 ></DIV
1019 ><DIV
1020 CLASS="SECT2"
1021 ><H3
1022 CLASS="SECT2"
1023 ><A
1024 NAME="AEN482">3.13. Why would anybody want to see a checkerboard pattern?</H3
1025 ><P
1026 > Remember that <A
1027 HREF="general.html#WHATSANAD"
1028 >telling which image is an ad and which
1029  isn't</A
1030 >, is mostly guesswork. While we hope that the standard configuration
1031  is rather smart, it can and will make errors. The checkerboard image is visually
1032  decent, but it shows you that and where images were blocked, which can be very
1033  helpful in case some navigation aid or otherwise innocent image was
1034  erraneously blocked. Some people might also enjoy seeing how many banners
1035  they <SPAN
1036 CLASS="emphasis"
1037 ><I
1038 CLASS="EMPHASIS"
1039 >don't</I
1040 ></SPAN
1041 > have to see..</P
1042 ></DIV
1043 ><DIV
1044 CLASS="SECT2"
1045 ><H3
1046 CLASS="SECT2"
1047 ><A
1048 NAME="AEN487">3.14. I see some images being replaced by a text
1049 instead of the checkerboard image. Why and how do I get rid of this?</H3
1050 ><P
1051 > This happens when the banners are not embedded in the HTML code of the
1052  page itself, but in separate HTML (sub)documents that are loaded into (i)frames
1053  or (i)layers, and these external HTML documents are blocked. Being non-images
1054  they get replaced by a substitute HTML page rather than a substitute image,
1055  which wouldn't work out technically, since the browser expects and accepts
1056  only HTML when it has requested an HTML document. </P
1057 ><P
1058 > The substitute page adapts to the available space and shows itself as a
1059  miniature two-liner if loaded into small frames, or full-blown with a
1060  large red "BLOCKED" banner if space allows.</P
1061 ><P
1062 > If you prefer the banners to be blocked by images, you must see to it that
1063  the HTML documents in which they are embedded are not blocked. Clicking
1064  the <SPAN
1065 CLASS="QUOTE"
1066 >"See why"</SPAN
1067 > link offered in the substitute page will show
1068  you which rule blocked the page. After changing the rule and un-blocking
1069  the HTML documents, the browser will try to load the actual banner images
1070  and the usual image blocking will (hopefully!) kick in.</P
1071 ></DIV
1072 ><DIV
1073 CLASS="SECT2"
1074 ><H3
1075 CLASS="SECT2"
1076 ><A
1077 NAME="SRVANY">3.15. Can <SPAN
1078 CLASS="APPLICATION"
1079 >Privoxy</SPAN
1080 > run as a service 
1081 on Win2K/NT?</H3
1082 ><P
1083 > Yes, it can run as a system service using <B
1084 CLASS="COMMAND"
1085 >srvany.exe</B
1086 >.
1087  The only catch is that this will effectively disable the
1088  <SPAN
1089 CLASS="APPLICATION"
1090 >Privoxy</SPAN
1091 > icon (and its menu!) in the taskbar. You can have 
1092  one or the other, but not both at this time :( </P
1093 ><P
1094 > There is a pending feature request for this functionality. See the discussion
1095  at <A
1096 HREF="http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118"
1097 TARGET="_top"
1098 >http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</A
1099 >, 
1100  for details, and a sample configuration.&#13;</P
1101 ></DIV
1102 ><DIV
1103 CLASS="SECT2"
1104 ><H3
1105 CLASS="SECT2"
1106 ><A
1107 NAME="OTHERPROXY">3.16. How can I make <SPAN
1108 CLASS="APPLICATION"
1109 >Privoxy</SPAN
1110 > work with other 
1111 proxies like <SPAN
1112 CLASS="APPLICATION"
1113 >Squid</SPAN
1114 >?</H3
1115 ><P
1116 > This can be done and is often useful to combine the benefits of
1117  <SPAN
1118 CLASS="APPLICATION"
1119 >Privoxy</SPAN
1120 > with those of a caching proxy.
1121  See the <A
1122 HREF="../user-manual/config.html#FORWARDING"
1123 TARGET="_top"
1124 >forwarding chapter</A
1125 >
1126  in the <A
1127 HREF="../user-manual/index.html"
1128 TARGET="_top"
1129 >user manual</A
1130 > which
1131  describes how to do this.</P
1132 ></DIV
1133 ><DIV
1134 CLASS="SECT2"
1135 ><H3
1136 CLASS="SECT2"
1137 ><A
1138 NAME="PORT-80">3.17. Can I just set <SPAN
1139 CLASS="APPLICATION"
1140 >Privoxy</SPAN
1141 > to use port 80
1142 and thus avoid individual browser configuration?</H3
1143 ><P
1144 > No, its more complicated than that. This only works with special kinds 
1145  of proxies known as <SPAN
1146 CLASS="QUOTE"
1147 >"transparent"</SPAN
1148 > proxies (see below).</P
1149 ></DIV
1150 ><DIV
1151 CLASS="SECT2"
1152 ><H3
1153 CLASS="SECT2"
1154 ><A
1155 NAME="TRANSPARENT">3.18. Can <SPAN
1156 CLASS="APPLICATION"
1157 >Privoxy</SPAN
1158 > run as a <SPAN
1159 CLASS="QUOTE"
1160 >"transparent"</SPAN
1161 > proxy?</H3
1162 ><P
1163 > No, <SPAN
1164 CLASS="APPLICATION"
1165 >Privoxy</SPAN
1166 > currently does not have this ability, 
1167  though it is planned for a future release. Transparent proxies require 
1168  special handling of the request headers beyond what
1169  <SPAN
1170 CLASS="APPLICATION"
1171 >Privoxy</SPAN
1172 > is now capable of.</P
1173 ><P
1174 > Chaining <SPAN
1175 CLASS="APPLICATION"
1176 >Privoxy</SPAN
1177 > behind another proxy that has 
1178  this ability should work though. 
1179  See the <A
1180 HREF="../user-manual/config.html#FORWARDING"
1181 TARGET="_top"
1182 >forwarding chapter</A
1183 >
1184  in the <A
1185 HREF="../user-manual/index.html"
1186 TARGET="_top"
1187 >user manual</A
1188 >. As
1189  a transparent proxy to be used for chaining we recommend Transproxy
1190  (<A
1191 HREF="http://www.transproxy.nlc.net.au/"
1192 TARGET="_top"
1193 >http://www.transproxy.nlc.net.au/</A
1194 >).</P
1195 ></DIV
1196 ></DIV
1197 ><DIV
1198 CLASS="NAVFOOTER"
1199 ><HR
1200 ALIGN="LEFT"
1201 WIDTH="100%"><TABLE
1202 SUMMARY="Footer navigation table"
1203 WIDTH="100%"
1204 BORDER="0"
1205 CELLPADDING="0"
1206 CELLSPACING="0"
1207 ><TR
1208 ><TD
1209 WIDTH="33%"
1210 ALIGN="left"
1211 VALIGN="top"
1212 ><A
1213 HREF="installation.html"
1214 ACCESSKEY="P"
1215 >Prev</A
1216 ></TD
1217 ><TD
1218 WIDTH="34%"
1219 ALIGN="center"
1220 VALIGN="top"
1221 ><A
1222 HREF="index.html"
1223 ACCESSKEY="H"
1224 >Home</A
1225 ></TD
1226 ><TD
1227 WIDTH="33%"
1228 ALIGN="right"
1229 VALIGN="top"
1230 ><A
1231 HREF="misc.html"
1232 ACCESSKEY="N"
1233 >Next</A
1234 ></TD
1235 ></TR
1236 ><TR
1237 ><TD
1238 WIDTH="33%"
1239 ALIGN="left"
1240 VALIGN="top"
1241 >Installation</TD
1242 ><TD
1243 WIDTH="34%"
1244 ALIGN="center"
1245 VALIGN="top"
1246 >&nbsp;</TD
1247 ><TD
1248 WIDTH="33%"
1249 ALIGN="right"
1250 VALIGN="top"
1251 >Miscellaneous</TD
1252 ></TR
1253 ></TABLE
1254 ></DIV
1255 ></BODY
1256 ></HTML
1257 >