002 《Privoxy 全面深度解析：隐私保护与流量控制权威指南》
🌟🌟🌟本文由Gemini 2.5 Flash Preview 04-17生成，用来辅助学习。🌟🌟🌟
书籍大纲
▮▮ 1. 第一章：引言——认识隐私卫士 Privoxy
▮▮▮▮ 1.1 1.1 什么是 Privoxy?
▮▮▮▮▮▮ 1.1.1 1.1.1 非缓存代理(Non-Caching Proxy)的特点
▮▮▮▮▮▮ 1.1.2 1.1.2 主要功能概览
▮▮▮▮ 1.2 1.2 为什么选择 Privoxy?
▮▮▮▮▮▮ 1.2.1 1.2.1 相较于浏览器扩展的优势
▮▮▮▮▮▮ 1.2.2 1.2.2 相较于传统代理服务器的特点
▮▮▮▮ 1.3 1.3 Privoxy 的历史与现状
▮▮ 2. 第二章：基础入门——安装与首次运行
▮▮▮▮ 2.1 2.1 系统要求与获取安装包
▮▮▮▮ 2.2 2.2 在 Windows 上安装
▮▮▮▮ 2.3 2.3 在 Linux 上安装
▮▮▮▮ 2.4 2.4 在 macOS 上安装
▮▮▮▮ 2.5 2.5 首次运行与基本测试
▮▮ 3. 第三章：工作原理——理解 Privoxy 如何处理流量
▮▮▮▮ 3.1 3.1 HTTP 代理模式(HTTP Proxy Mode)
▮▮▮▮ 3.2 3.2 HTTPS 流量的处理
▮▮▮▮▮▮ 3.2.1 3.2.1 CONNECT 方法的工作流程
▮▮▮▮▮▮ 3.2.2 3.2.2 HTTPS 流量过滤的局限性
▮▮▮▮ 3.3 3.3 透明代理(Transparent Proxy)设置
▮▮▮▮ 3.4 3.4 Privoxy 的内部处理流程
▮▮ 4. 第四章：核心配置——privoxy.cfg 深度解析
▮▮▮▮ 4.1 4.1 配置文件的位置与结构
▮▮▮▮ 4.2 4.2 网络接口与端口配置 (listen-address)
▮▮▮▮ 4.3 4.3 访问控制 (permit/deny)
▮▮▮▮ 4.4 4.4 日志配置 (logfile, loglevel)
▮▮▮▮ 4.5 4.5 转发代理设置 (forward, forward-socks)
▮▮▮▮ 4.6 4.6 启用/禁用功能 (toggle)
▮▮▮▮ 4.7 4.7 其他重要配置项
▮▮ 5. 第五章：过滤引擎——Actions 文件详解
▮▮▮▮ 5.1 5.1 动作文件的工作机制
▮▮▮▮ 5.2 5.2 动作文件基本语法 (.action 文件)
▮▮▮▮ 5.3 5.3 模式匹配语法 (Pattern Matching)
▮▮▮▮▮▮ 5.3.1 5.3.1 基础模式匹配
▮▮▮▮▮▮ 5.3.2 5.3.2 正则表达式匹配 (Regular Expressions)
▮▮▮▮ 5.4 5.4 常用动作类型 (Action Types) 详解
▮▮▮▮▮▮ 5.4.1 5.4.1 阻塞动作 (+block, -block)
▮▮▮▮▮▮ 5.4.2 5.4.2 过滤动作 (+filter, -filter)
▮▮▮▮▮▮ 5.4.3 5.4.3 头部修改动作 (+hide-headers, +change-x-forwarded-for 等)
▮▮▮▮▮▮ 5.4.4 5.4.4 重定向动作 (+redirect)
▮▮▮▮▮▮ 5.4.5 5.4.5 Cookie 控制动作 (+session-cookies, +force-remote-cookies 等)
▮▮▮▮▮▮ 5.4.6 5.4.6 其他高级动作
▮▮ 6. 第六章：实战应用——构建你的过滤规则
▮▮▮▮ 6.1 6.1 理解默认动作文件 (default.action)
▮▮▮▮ 6.2 6.2 广告和追踪器屏蔽
▮▮▮▮▮▮ 6.2.1 6.2.1 基于 URL 模式的屏蔽
▮▮▮▮▮▮ 6.2.2 6.2.2 基于内容过滤的屏蔽 (+filter)
▮▮▮▮ 6.3 6.3 增强隐私保护规则
▮▮▮▮ 6.4 6.4 控制网站行为
▮▮▮▮ 6.5 6.5 组织和管理自定义规则
▮▮ 7. 第七章：高级主题——HTTPS、条件规则与链式代理
▮▮▮▮ 7.1 7.1 更深入的 HTTPS 处理
▮▮▮▮▮▮ 7.1.1 7.1.1 forward-ssl-over-http 指令的应用
▮▮▮▮▮▮ 7.1.2 7.1.2 与 SSL 拦截代理(SSL Interception Proxy)的集成（如有必要）
▮▮▮▮ 7.2 7.2 条件性规则 (.action 中的 {} 语法)
▮▮▮▮ 7.3 7.3 链式代理设置 (Chaining Proxies)
▮▮▮▮▮▮ 7.3.1 7.3.1 配置 forward 指令到其他 HTTP 代理
▮▮▮▮▮▮ 7.3.2 7.3.2 配置 forward-socks 指令到 SOCKS 代理 (如 Tor)
▮▮▮▮▮▮ 7.3.3 7.3.3 链式代理的优势与注意事项
▮▮▮▮ 7.4 7.4 自定义过滤器 (Custom Filters)
▮▮ 8. 第八章：维护与故障排除
▮▮▮▮ 8.1 8.1 理解 Privoxy 的日志
▮▮▮▮ 8.2 8.2 常见错误与解决方法
▮▮▮▮ 8.3 8.3 规则冲突与调试
▮▮▮▮ 8.4 8.4 性能优化建议
▮▮▮▮ 8.5 8.5 报告 Bug 与获取社区支持
▮▮ 9. 第九章：Privoxy 的未来与生态
▮▮▮▮ 9.1 9.1 项目最新进展与路线图
▮▮▮▮ 9.2 9.2 Privoxy 与其他工具的集成
▮▮▮▮ 9.3 9.3 相关或替代性工具简介
▮▮▮▮ 9.4 9.4 参与社区与贡献
▮▮ 附录A: 附录 A：常用动作列表速查
▮▮ 附录B: 附录 B：模式匹配语法速查
▮▮ 附录C: 附录 C：示例配置文件集
▮▮ 附录D: 附录 D：术语汇编 (Glossary)
▮▮ 附录E: 附录 E：参考文献与进一步阅读
1. 第一章：引言——认识隐私卫士 Privoxy
欢迎来到本书的第一章！在这个日益互联互通的数字时代，我们的网络行为无时无刻不在产生数据，这些数据被用来追踪我们、投放广告，甚至可能损害我们的隐私。虽然有各种各样的工具声称能保护隐私和屏蔽广告，但 Privoxy 作为一款历史悠久、功能强大且高度可配置的代理服务器，在提供精细化控制和增强在线隐私方面拥有其独特的地位。本章将带您初步认识 Privoxy，理解它的定位、核心功能以及为何它在当今的网络环境中依然扮演着重要的角色。我们将探讨它与浏览器扩展、传统代理服务器的区别，并简要回顾它的发展历程，为后续章节的深入学习打下基础。
1.1 什么是 Privoxy?
Privoxy 是一个非缓存的 Web 代理（Non-Caching Web Proxy），主要功能是增强隐私、过滤网页内容以及管理 HTTP 头部。它设计用于拦截和修改来自网络的请求和响应，从而实现对网页内容的控制和用户隐私的保护。与传统的缓存代理服务器不同，Privoxy 的核心不在于存储网页副本以加快访问速度，而是专注于检查和修改流经它的数据。
Privoxy 可以与几乎所有支持 HTTP 代理配置的浏览器或应用程序配合使用。它作为一个独立的程序在用户的计算机或网络中的服务器上运行，充当用户设备与互联网之间的中间人。
1.1.1 非缓存代理(Non-Caching Proxy)的特点
作为非缓存代理，Privoxy 的主要特点在于：
① 专注于内容过滤和修改：而非数据缓存。这意味着 Privoxy 在处理每个请求和响应时，都会根据预设的规则对其进行检查和可能的修改，而不是直接返回之前缓存的内容。
② 实时处理：Privoxy 对流量的处理是实时的。请求到达时立即处理，响应返回时也立即处理。这保证了过滤和修改规则能立即生效，但也意味着它不会像缓存代理那样通过提供本地缓存来减少网络流量或提高速度。
③ 资源占用相对较低：相较于需要维护庞大缓存数据的缓存代理，非缓存代理在存储资源上的需求通常较低。
④ 灵活性高：由于不对内容进行缓存，Privoxy 可以更灵活地处理各种复杂的网络场景和动态内容，其过滤规则的修改也能立即生效。
理解其非缓存的特性对于理解 Privoxy 的应用场景至关重要。它并非一个旨在加速网页访问的工具，而是一个强大的、可定制的流量过滤和修改引擎。
1.1.2 主要功能概览
Privoxy 的核心功能围绕着对网络流量的拦截、分析和修改展开。其主要功能包括：
⚝ 增强隐私 (Privacy Enhancement)：
▮▮▮▮⚝ 修改或移除 HTTP 头部 (HTTP Headers)，如 Referer、User-Agent 等，防止网站追踪用户的浏览历史和设备信息。
▮▮▮▮⚝ 管理 Cookie (Cookie Management)，可以阻止、允许或修改特定网站的 Cookie。
▮▮▮▮⚝ 阻止或混淆网络浏览器指纹 (Browser Fingerprinting) 相关信息。
⚝ 内容过滤 (Content Filtering)：
▮▮▮▮⚝ 屏蔽广告和弹窗 (Ad and Pop-up Blocking)。
▮▮▮▮⚝ 移除网页中的网络跟踪器 (Trackers) 和网络臭虫 (Web Bugs)。
▮▮▮▮⚝ 过滤危险或不当内容。
▮▮▮▮⚝ 修改网页内容，例如移除脚本 (Scripts) 或内嵌框架 (Iframes)。
⚝ 灵活的配置与规则 (Flexible Configuration and Rules)：
▮▮▮▮⚝ 使用强大的模式匹配 (Pattern Matching) 语法（包括正则表达式 - Regular Expressions）来识别需要处理的 URL 或内容。
▮▮▮▮⚝ 基于动作文件 (Action Files) 实现高度定制化的过滤规则。可以为不同的网站或模式应用不同的规则集合。
▮▮▮▮⚝ 支持链式代理 (Chaining Proxies)，可以将流量转发到其他代理服务器，如 Tor 的 SOCKS 代理，以进一步增强匿名性。
⚝ 跨平台支持 (Cross-Platform Support)：
▮▮▮▮⚝ 可以在 Windows, Linux, macOS 等多种操作系统上运行。
总而言之，Privoxy 是一个强大的、专注于隐私和内容过滤的 HTTP/HTTPS 代理服务器。它通过提供细致的规则控制，赋予用户对网络流量前所未有的掌控力。
1.2 为什么选择 Privoxy?
在各种网络过滤工具和隐私保护技术层出不穷的今天，我们为什么还要选择 Privoxy 呢？理解 Privoxy 的优势和特点，有助于我们在不同的场景下做出合适的工具选择。
1.2.1 相较于浏览器扩展的优势
我们常用的广告屏蔽和隐私保护工具很多是浏览器扩展（Browser Extensions），例如 AdBlock Plus, uBlock Origin 等。它们非常方便，安装在浏览器中即可生效。然而，Privoxy 作为系统级或网络级代理，相较于浏览器扩展有其独特的优势：
① 覆盖范围更广：浏览器扩展只能过滤浏览器内的流量。而 Privoxy 作为代理，可以配置为处理系统中所有应用程序的网络流量（如果这些应用支持代理设置或通过透明代理方式强制流量通过 Privoxy）。这意味着不仅浏览器，电子邮件客户端、下载工具、桌面应用程序等产生的网络请求都可以受到 Privoxy 的过滤和隐私保护。
② 更难被绕过：一些网站会尝试检测并绕过浏览器扩展的屏蔽规则。Privoxy 在网络层面进行处理，其工作方式使得网站更难区分请求是否经过了过滤，从而提高了规则的有效性。
③ 集中管理：在一个网络环境中（例如家庭网络），可以在路由器或一台中心服务器上部署 Privoxy，让所有连接到该网络的设备（电脑、手机、平板等）都受益于相同的过滤和隐私规则，而无需在每台设备或每个浏览器上单独安装和配置扩展。
④ 更底层的控制：Privoxy 对 HTTP/HTTPS 流量的控制更为底层和精细。它可以修改或删除各种 HTTP 头部，而浏览器扩展通常只能在有限范围内操作或依赖浏览器提供的 API。Privoxy 甚至可以对非浏览器产生的 HTTP 请求进行处理。
当然，浏览器扩展也有其便捷性、易用性和针对特定浏览器特性优化的优势。Privoxy 更适合那些希望在系统或网络层面进行统一、精细化控制的用户。
1.2.2 相较于传统代理服务器的特点
传统的代理服务器（如 Squid）通常专注于缓存、访问控制（例如限制对某些网站的访问）、带宽管理和基本的 URL 过滤。它们更常用于企业网络环境进行流量管理和加速。Privoxy 与这些传统代理服务器的主要区别在于其核心功能和设计理念：
① 专注于内容过滤和隐私保护：这是 Privoxy 的核心优势。它提供了极为丰富的动作和灵活的规则匹配能力，可以深入到 HTTP 请求和响应的各个部分，进行复杂的模式匹配和内容修改。传统代理的过滤功能通常比较基础，难以实现 Privoxy 这种粒度的控制，尤其是在修改页面内容、增强隐私信息方面。
② 非缓存设计：如前所述，Privoxy 刻意设计为非缓存，这意味着它不会为了加速访问而存储页面副本，而是专注于流量的处理和修改。传统代理则将缓存视为重要功能。
③ 配置文件的易读性：虽然功能强大，但 Privoxy 的配置文件（尤其动作文件）设计得相对易于理解和编写规则，即使是普通用户经过学习也能掌握其基本用法。某些企业级代理服务器的配置可能更为复杂。
④ 轻量级：相较于功能庞杂的传统代理服务器，Privoxy 设计更为轻量级，资源占用通常较低，适合在个人电脑或资源有限的设备上运行。
总的来说，如果你的主要需求是缓存和基本的访问控制，传统代理可能更合适。但如果你的目标是细致地过滤网页内容、屏蔽广告和追踪、增强在线隐私，Privoxy 则是更强大、更灵活的选择。它也可以与传统代理或其他工具（如 Tor）结合使用，发挥各自的优势。
1.3 Privoxy 的历史与现状
Privoxy 的历史可以追溯到 1990 年代末期，它是基于一个名为 Internet Junkbuster 的开源项目发展而来的。Internet Junkbuster 是一个早期的广告屏蔽代理，但其开发在后来趋于停滞。Privoxy 项目继承了 Internet Junkbuster 的代码基础，并在此之上进行了大量的改进和扩展，特别是在过滤规则的灵活性和功能多样性方面。
自那时起，Privoxy 作为一个开源项目持续发展。它由一个社区进行维护和更新。虽然其界面和配置方式（主要依赖文本文件）可能看起来不那么现代化，但其核心过滤引擎和强大的规则系统至今仍保持着活力，并且不断有更新发布以适应变化的网络环境和新的网络技术。
当前，Privoxy 仍然是一个活跃的开源项目，拥有持续的维护和社区支持。许多 Linux 发行版、BSD 系统以及 macOS、Windows 用户都可以方便地获取和安装它。它常常被那些重视隐私、希望对网络访问有深度控制的技术爱好者、系统管理员以及需要特定过滤功能的开发者所使用。它的稳定性和强大的可配置性是其长期存在并保持相关性的关键。了解其历史，有助于我们 appreciate Privoxy 作为一个成熟、专注于特定领域的工具的价值。
2. 第二章：基础入门——安装与首次运行
本章将引导读者迈出使用 Privoxy 的第一步。我们将详细介绍在 Windows、Linux 和 macOS 等主流操作系统上安装 Privoxy 的过程，并指导您完成首次运行的必要配置以及进行基本的连通性测试。无论您是计算机初学者还是有一定经验的用户，本章都旨在确保您能够顺利地将 Privoxy 部署到您的环境中，为后续的深入学习打下坚实基础。
2.1 系统要求与获取安装包
在开始安装 Privoxy 之前，了解其基本的系统要求并知道如何获取官方可靠的安装包或源代码至关重要。这能确保安装过程顺利进行，并避免因版本或来源问题导致的潜在麻烦。
2.1.1 系统要求概览
Privoxy 是一个轻量级的应用程序，对系统资源的占用非常低。它可以在各种类 Unix 系统（如 Linux、macOS、BSD）和 Windows 系统上稳定运行。
① 操作系统（Operating System）:
▮▮▮▮ⓑ Windows (XP, Vista, 7, 8, 10, 11 及更高版本，通常支持 32 位和 64 位架构)
▮▮▮▮ⓒ Linux (几乎所有主流发行版，如 Ubuntu, Debian, Fedora, CentOS, Arch Linux 等)
▮▮▮▮ⓓ macOS (各个现代版本)
▮▮▮▮ⓔ 其他类 Unix 系统 (如 BSD)
⑥ 硬件资源（Hardware Resources）:
▮▮▮▮⚝ 处理器（CPU）: 任何现代处理器即可。
▮▮▮▮⚝ 内存（RAM）: 几十 MB 即可满足基本运行需求，即使在高负载下，通常也只需要几百 MB。
▮▮▮▮⚝ 存储空间（Storage Space）: 安装文件本身非常小，通常只需几十 MB。配置文件和日志文件也不会占用太多空间。
③ 网络连接（Network Connection）: 需要正常的网络连接以下载安装包和进行后续的代理测试。
总而言之，如果您当前的计算机能够正常运行其操作系统并连接到互联网，那么它就满足了运行 Privoxy 的最低硬件要求。
2.1.2 获取官方安装文件或源代码
获取 Privoxy 官方发布的安装包是推荐的方式，这能确保您获得的是未被篡改且包含最新修复和功能的版本。
① 官方网站（Official Website）:
▮▮▮▮⚝ Privoxy 的官方网站是获取所有资源最权威的渠道。您可以通过搜索引擎查找 "Privoxy official website" 或直接访问其已知地址（通常是 privoxy.org）。
▮▮▮▮⚝ 在官方网站的下载（Download）或发布（Release）页面，您可以找到针对不同操作系统的预编译二进制文件（Precompiled Binaries）或源代码压缩包（Source Tarball）。
② 选择版本（Choosing a Version）:
▮▮▮▮⚝ 对于大多数用户，下载最新的稳定版本（Stable Version）即可。稳定版本经过充分测试，功能完善且 Bug 较少。
▮▮▮▮⚝ 如果您是经验丰富的用户或开发者，可能也会考虑下载开发版本（Development Version）或源代码来体验最新功能或进行定制，但这不推荐给初学者。
③ 下载类型（Download Type）:
▮▮▮▮⚝ 预编译二进制文件（Precompiled Binaries）: 这是最方便的选择，特别是对于 Windows 和 macOS 用户，直接下载对应的安装程序（.exe 或 .pkg 文件）或压缩包即可。
▮▮▮▮⚝ 源代码压缩包（Source Tarball）: 对于 Linux 用户，特别是希望从源代码编译安装的用户，或者希望在官方不提供预编译包的系统上安装时，需要下载源代码。编译安装通常需要基本的开发工具链（如 GCC, Make 等）。
请务必从官方或其认可的镜像站点下载文件，并在可能的情况下验证文件的哈希值（Hash Value）或数字签名（Digital Signature），以确保文件的完整性和安全性。
2.2 在 Windows 上安装
在 Windows 系统上安装 Privoxy 通常非常简单，通过官方提供的安装程序可以快速完成。
① 下载安装程序（Download the Installer）:
▮▮▮▮⚝ 访问 Privoxy 官方网站的下载页面。
▮▮▮▮⚝ 找到适用于 Windows 的最新版本安装程序（通常是一个 .exe 文件）。选择与您的 Windows 版本（32 位或 64 位）对应的安装程序。
▮▮▮▮⚝ 点击链接下载文件到您的计算机。
② 运行安装程序（Run the Installer）:
▮▮▮▮⚝ 找到下载的 .exe 文件，双击运行。
▮▮▮▮⚝ Windows 可能会弹出用户账户控制（User Account Control, UAC）提示，询问是否允许此程序对您的计算机进行更改。点击“是”继续。
③ 遵循安装向导（Follow the Installation Wizard）:
▮▮▮▮⚝ 安装向导会启动，首先是欢迎界面，点击“Next”继续。
▮▮▮▮⚝ 阅读并接受许可协议（License Agreement），然后点击“Next”。
▮▮▮▮⚝ 选择安装组件（Choose Components）: 通常建议保持默认选择，包括核心程序文件和文档。点击“Next”。
▮▮▮▮⚝ 选择安装位置（Choose Install Location）: 您可以选择 Privoxy 的安装目录。默认位置通常是 C:\Program Files\Privoxy 或 C:\Program Files (x86)\Privoxy。您可以点击“Browse”更改位置，但通常建议保持默认。确认后点击“Install”。
▮▮▮▮⚝ 安装程序会复制文件到指定目录并进行必要配置。
④ 完成安装（Complete Installation）:
▮▮▮▮⚝ 安装完成后，向导会显示安装成功的消息。通常会提供一个选项来启动 Privoxy 服务。您可以选择立即启动，也可以稍后手动启动。
▮▮▮▮⚝ 点击“Finish”退出安装向导。
⑤ 验证安装（Verify Installation）:
▮▮▮▮⚝ 安装完成后，Privoxy 的配置文件 config.txt（相当于其他系统上的 privoxy.cfg）通常位于安装目录下的 etc\ 子目录中。
▮▮▮▮⚝ 如果您选择立即启动服务，可以在 Windows 的服务管理器（Services Manager）中查找名为“Privoxy”的服务，确认其状态为“正在运行”（Running）。
▮▮▮▮⚝ 如果没有立即启动，可以通过服务管理器手动启动它。
至此，Privoxy 已成功安装到您的 Windows 系统上。接下来需要进行配置和测试。
2.3 在 Linux 上安装
在 Linux 系统上安装 Privoxy 有多种方式，最常见且推荐的是使用发行版自带的包管理器。对于需要特定版本或深度定制的用户，也可以选择从源代码编译安装。
2.3.1 使用包管理器安装
这是 Linux 上最便捷的安装方式，适用于大多数用户。不同的 Linux 发行版使用不同的包管理器。
① 基于 Debian/Ubuntu 的系统 (apt):
▮▮▮▮⚝ 打开终端（Terminal）。
▮▮▮▮⚝ 更新包列表：
1
sudo apt update
▮▮▮▮⚝ 安装 Privoxy：
1
sudo apt install privoxy
▮▮▮▮⚝ 安装完成后，Privoxy 服务通常会自动启动。您可以使用以下命令检查其状态：
1
systemctl status privoxy
▮▮▮▮⚝ Privoxy 的主配置文件位于 /etc/privoxy/config 或 /etc/privoxy/privoxy.cfg。
② 基于 Fedora/CentOS/RHEL 的系统 (dnf 或 yum):
▮▮▮▮⚝ 打开终端（Terminal）。
▮▮▮▮⚝ 安装 Privoxy：
1
sudo dnf install privoxy # For Fedora 22+ / CentOS 8+ / RHEL 8+
2
# 或者对于较旧的系统：
3
# sudo yum install privoxy
▮▮▮▮⚝ 安装完成后，可能需要手动启动并设置开机自启：
1
sudo systemctl start privoxy
2
sudo systemctl enable privoxy
▮▮▮▮⚝ 使用以下命令检查状态：
1
systemctl status privoxy
▮▮▮▮⚝ Privoxy 的主配置文件通常位于 /etc/privoxy/config 或 /etc/privoxy/privoxy.cfg。
③ 基于 Arch Linux 的系统 (pacman):
▮▮▮▮⚝ 打开终端（Terminal）。
▮▮▮▮⚝ 安装 Privoxy：
1
sudo pacman -S privoxy
▮▮▮▮⚝ 安装完成后，需要手动启动并设置开机自启：
1
sudo systemctl start privoxy
2
sudo systemctl enable privoxy
▮▮▮▮⚝ 使用以下命令检查状态：
1
systemctl status privoxy
▮▮▮▮⚝ Privoxy 的主配置文件通常位于 /etc/privoxy/config 或 /etc/privoxy/privoxy.cfg。
2.3.2 从源代码编译安装 (面向高级用户)
如果您需要安装特定版本、对程序进行定制或在没有预编译包的系统上安装，可以选择从源代码编译。这通常需要安装编译工具和库。
① 安装依赖（Install Dependencies）:
▮▮▮▮⚝ 通常需要 C 编译器 (如 GCC)、Make 工具以及一些开发库（具体取决于 Privoxy 版本和配置选项）。使用您的包管理器安装 build-essential (Debian/Ubuntu) 或 Development Tools (Fedora/CentOS) 等开发包组。
② 下载源代码（Download Source Code）:
▮▮▮▮⚝ 从 Privoxy 官方网站下载最新的源代码压缩包（例如 privoxy-x.xx.tar.gz）。
▮▮▮▮⚝ 解压文件到合适的目录：
1
tar -xzf privoxy-x.xx.tar.gz
2
cd privoxy-x.xx
③ 配置（Configure）:
▮▮▮▮⚝ 运行配置脚本。可以使用 --prefix 指定安装目录，使用其他选项启用/禁用特定功能。
1
./configure --prefix=/usr/local/privoxy # 例如，安装到 /usr/local/privoxy
▮▮▮▮⚝ 运行 ./configure --help 可以查看所有可用选项。
④ 编译（Compile）:
▮▮▮▮⚝ 运行 Make 命令编译程序：
1
make
⑤ 安装（Install）:
▮▮▮▮⚝ 运行 Make Install 命令进行安装。通常需要管理员权限：
1
sudo make install
⑥ 配置服务（Configure Service）:
▮▮▮▮⚝ 从源代码安装不会自动配置系统服务。您需要手动创建一个 Systemd unit 文件（或其他初始化系统对应的文件）来管理 Privoxy 服务，或者直接通过命令行启动。这部分操作相对复杂，超出了基础入门的范畴。
对于大多数 Linux 用户来说，使用包管理器安装是最简单、最推荐的方式。安装完成后，配置文件通常位于 /etc/privoxy/ 目录下。
2.4 在 macOS 上安装
在 macOS 上安装 Privoxy，最便捷的方式是使用 Homebrew 这个优秀的第三方包管理器。
① 安装 Homebrew (如果未安装):
▮▮▮▮⚝ 打开“终端”（Terminal.app）。
▮▮▮▮⚝ 访问 Homebrew 官方网站 https://brew.sh/，复制其提供的安装命令并粘贴到终端中执行。安装过程可能需要您输入用户密码并下载一些文件。
② 使用 Homebrew 安装 Privoxy:
▮▮▮▮⚝ 在终端中执行以下命令：
1
brew install privoxy
▮▮▮▮⚝ Homebrew 会自动下载 Privoxy 及其依赖项，并进行编译和安装。
③ 启动 Privoxy 服务:
▮▮▮▮⚝ 使用 Homebrew 的 Service 命令启动 Privoxy 服务并设置为开机自启：
1
brew services start privoxy
▮▮▮▮⚝ 您也可以选择只临时启动服务：
1
brew services run privoxy
④ 验证安装（Verify Installation）:
▮▮▮▮⚝ 使用以下命令检查 Privoxy 服务的状态：
1
brew services list # 查看所有 Homebrew 管理的服务状态
▮▮▮▮⚝ 确保 privoxy 的状态显示为 started。
▮▮▮▮⚝ Privoxy 的主配置文件通常位于 /usr/local/etc/privoxy/config。如果您使用了其他方式安装 Homebrew 或指定了安装路径，位置可能会有所不同。您可以通过 brew info privoxy 查看安装信息，包括配置文件位置。
如果您不想使用 Homebrew，也可以尝试从 Privoxy 官方网站下载 macOS 的预编译包或源代码进行手动安装，但这相对复杂，且维护不如 Homebrew 方便。
2.5 首次运行与基本测试
安装完成后，最重要的一步是确保 Privoxy 正在运行，并配置您的应用程序（通常是浏览器）使用它作为代理。本节将指导您完成这些步骤并进行基本测试。
2.5.1 启动 Privoxy 服务
取决于您的安装方式和操作系统，Privoxy 服务可能已经自动启动，或者需要您手动启动。
① Windows:
▮▮▮▮⚝ 如果安装时没有选择自动启动，可以通过“服务”（Services）管理工具找到“Privoxy”服务，右键点击并选择“启动”。
▮▮▮▮⚝ 也可以在安装目录下的 Privoxy 文件夹中找到 privoxy.exe 或相关的启动脚本/快捷方式来手动运行，但作为服务运行是更推荐的方式。
② Linux:
▮▮▮▮⚝ 如果是通过包管理器安装，通常会配置为系统服务。使用 Systemd 的系统可以使用：
1
sudo systemctl start privoxy
▮▮▮▮⚝ 使用 SysVinit 的系统可以使用：
1
sudo service privoxy start
▮▮▮▮⚝ 检查服务状态以确认是否成功启动（参考前述命令）。
③ macOS:
▮▮▮▮⚝ 如果使用 Homebrew 安装，使用以下命令启动服务：
1
brew services start privoxy
▮▮▮▮⚝ 检查服务状态以确认是否成功启动。
2.5.2 配置浏览器使用 Privoxy 代理
要让网络流量经过 Privoxy，您需要将客户端应用程序（例如网页浏览器）的代理设置指向 Privoxy 监听的地址和端口。默认情况下，Privoxy 监听在本地地址 127.0.0.1 的端口 8118。
① 在主要浏览器中配置代理 (以 Chrome 为例):
▮▮▮▮⚝ Chrome/Edge: 通常使用系统代理设置。
▮▮▮▮▮▮▮▮❶ Windows: 进入“设置” -> “网络和 Internet” -> “代理”，选择“手动设置代理”，启用“使用代理服务器”，地址填写 127.0.0.1，端口填写 8118。勾选“不要对本地地址使用代理服务器”。保存设置。
▮▮▮▮▮▮▮▮❷ macOS: 进入“系统设置” -> “网络” -> 选择当前使用的网络连接（如 Wi-Fi）-> 点击“详细信息”/“高级” -> 切换到“代理”标签页。勾选“网页代理 (HTTP)”和“安全网页代理 (HTTPS)”，地址填写 127.0.0.1，端口填写 8118。点击“好”或“应用”。
▮▮▮▮▮▮▮▮❸ Linux (GNOME/KDE 等桌面环境): 大多数桌面环境在系统设置中有网络代理选项，配置方式类似 Windows 和 macOS，设置为手动代理，地址 127.0.0.1，端口 8118，应用于 HTTP 和 HTTPS。
▮▮▮▮⚝ Firefox: Firefox 通常有独立的代理设置，不完全依赖系统代理。
▮▮▮▮▮▮▮▮❶ 进入 Firefox 的“设置” -> “网络设置”（或搜索“代理”）。
▮▮▮▮▮▮▮▮❷ 选择“手动配置代理”。
▮▮▮▮▮▮▮▮❸ 在“HTTP 代理”和“HTTPS 代理”字段中填写 127.0.0.1，端口填写 8118。
▮▮▮▮▮▮▮▮❹ 确保“为所有协议使用同一代理服务器”或类似选项被选中（如果需要）。
▮▮▮▮▮▮▮▮❺ 在“无代理的地址”字段中填写 localhost, 127.0.0.1，防止循环代理或影响本地访问。
▮▮▮▮▮▮▮▮❻ 点击“确定”保存设置。
② 其他应用程序或系统范围代理:
▮▮▮▮⚝ 一些应用程序（如下载工具、即时通讯客户端）可能有自己的代理设置，请查阅其文档进行配置。
▮▮▮▮⚝ 对于需要系统范围代理的情况，可以在操作系统网络设置中配置，如前所述（Windows, macOS, Linux 桌面环境）。
▮▮▮▮⚝ 在某些情况下，您可能需要使用透明代理（Transparent Proxy）设置（如通过路由器或防火墙规则），这将在后续章节讨论。
2.5.3 进行基本测试
配置好代理后，您可以进行简单的测试来确认 Privoxy 是否正常工作。
① 访问 Privoxy 内部状态页面:
▮▮▮▮⚝ 在配置了 Privoxy 代理的浏览器中，尝试访问 http://config.privoxy.org/ 或 http://p.p/。
▮▮▮▮⚝ 如果 Privoxy 正常运行并被浏览器使用，您应该能看到 Privoxy 的状态页面，其中包含配置信息、版本号和一些统计数据。这是确认浏览器已通过 Privoxy 连接的最直接方法。如果无法访问，请检查 Privoxy 服务是否运行以及浏览器的代理设置是否正确。
② 访问普通网站:
▮▮▮▮⚝ 尝试访问一些常见的网站，例如 http://example.com 或 https://www.baidu.com。
▮▮▮▮⚝ 如果网页能够正常加载，说明 Privoxy 正在转发您的请求。
▮▮▮▮⚝ 如果加载失败或提示连接错误，检查 Privoxy 的日志文件（默认配置通常会将日志输出到终端或日志文件，位置取决于安装方式和配置）以获取错误信息。常见的错误可能是 Privoxy 未启动、防火墙阻止连接、配置文件错误等。
③ 检查广告或追踪器是否被屏蔽:
▮▮▮▮⚝ 访问一个通常包含广告的网站，例如新闻网站或博客。
▮▮▮▮⚝ 观察页面加载情况。如果默认的 Privoxy 规则生效，一些广告位可能会是空白的，或者某些追踪脚本可能无法加载。
▮▮▮▮⚝ 这也取决于 Privoxy 的默认配置和您使用的规则文件。即使初始看不到明显的广告屏蔽效果，只要能访问 config.privoxy.org，就说明 Privoxy 代理是工作的。
④ 检查日志文件:
▮▮▮▮⚝ 查看 Privoxy 的日志文件，通常会记录接收到的连接、应用的规则以及任何错误。日志是诊断问题最有用的信息来源。默认日志位置可能在 /var/log/privoxy/ (Linux)、安装目录下的 log\ 文件夹 (Windows) 或其他位置，具体取决于安装和配置。
通过以上步骤，您应该已经成功安装并初步验证了 Privoxy 的运行。如果遇到问题，请仔细检查安装步骤、服务状态、配置文件（特别是 listen-address 和 permit/deny 指令）以及客户端的代理设置。本章的目标是让 Privoxy 成功作为代理运行起来，下一章将深入探讨它的工作原理。
3. 第三章：工作原理——理解 Privoxy 如何处理流量
欢迎来到本书的第三章！在前面两章，我们已经了解了 Privoxy 是什么以及如何将其安装并运行起来。但要真正发挥 Privoxy 的强大功能，深入理解它如何在幕后处理网络流量至关重要。本章将像解剖刀一样，带你层层剥开 Privoxy 的内部工作机制，让你知其然，更知其所以然。无论是简单的 HTTP 请求，还是复杂的 HTTPS 连接，甚至是无需客户端手动设置的透明代理，Privoxy 都有其独特的处理方式。掌握这些原理，将为你后续配置高级过滤规则和解决疑难问题打下坚实的基础。
3.1 HTTP 代理模式(HTTP Proxy Mode)
作为一款专注于内容过滤的 HTTP 代理(HTTP Proxy)，Privoxy 最核心的工作模式就是拦截并处理 HTTP 流量。想象一下，当你通过浏览器访问一个网站时，通常情况下，浏览器会直接与目标网站的服务器建立连接并发送请求。但在使用 Privoxy 作为 HTTP 代理时，这个过程发生了改变。
① 浏览器不再直接连接目标服务器。
② 浏览器会首先将 HTTP 请求发送给 Privoxy。
③ Privoxy 接收到请求后，并不会立即转发。它会对请求进行一系列检查和处理，这包括但不限于：
▮▮▮▮⚝ 检查请求的 URL 是否匹配任何阻塞(blocking)规则。
▮▮▮▮⚝ 修改请求头部(request headers)，例如移除或更改 User-Agent、Referer 等信息，以增强隐私(privacy)。
▮▮▮▮⚝ 根据过滤规则修改请求体(request body)，尽管这在 HTTP 请求中不常见。
▮▮▮▮⚝ 根据转发规则(forwarding rules)决定是将请求直接转发，还是发送给另一个上游代理(upstream proxy)。
④ 如果请求未被阻塞，Privoxy 会根据处理后的结果，与目标服务器建立连接（如果之前没有建立过），并将修改或未修改的请求发送过去。
⑤ 目标服务器接收到请求，处理后返回 HTTP 响应(HTTP response)给 Privoxy。
⑥ Privoxy 接收到响应后，同样会对响应进行处理，这包括：
▮▮▮▮⚝ 检查响应头部，例如修改或移除 Set-Cookie 头部以控制 Cookie。
▮▮▮▮⚝ 根据过滤规则修改响应体，这是 Privoxy 进行内容过滤、广告屏蔽的核心步骤，例如删除 HTML 中的广告代码、修改 CSS 或 JavaScript 文件等。
⑦ Privoxy 将处理后的响应发送回浏览器。
⑧ 浏览器接收到响应，解析并显示网页内容。
这个过程可以用一个简单的流程图表示（虽然这里我们不能画图，但你可以在脑海中构建它）：
浏览器 -> Privoxy (处理请求) -> 目标服务器 -> Privoxy (处理响应) -> 浏览器
Privoxy 的强大之处在于其在请求和响应之间增加了一个可编程的“拦截点”，允许我们根据预设的规则对流量进行精细的控制和修改。它是一个应用层(Application Layer)的代理，专注于 HTTP 协议(HTTP Protocol)的解析和内容处理，这使得它在过滤网页内容方面具有独特的优势。
3.2 HTTPS 流量的处理
随着网络安全意识的提高，越来越多的网站开始使用 HTTPS 来加密通信。HTTPS (Hypertext Transfer Protocol Secure) 是在 HTTP 协议的基础上，通过 SSL/TLS (Secure Sockets Layer/Transport Layer Security) 对数据进行加密。这带来了新的挑战：Privoxy 作为一个代理，如何处理加密的 HTTPS 流量？
由于 HTTPS 流量是加密的，Privoxy 无法像处理 HTTP 那样直接查看和修改加密数据包的内部内容（如请求头部、响应体）。如果 Privoxy 尝试解密 HTTPS 流量，就需要客户端（浏览器）信任 Privoxy 的伪造证书，这通常不安全且复杂。Privoxy 设计时避免了这种中间人攻击(Man-in-the-Middle, MITM)式的解密。
那么，Privoxy 是如何处理 HTTPS 流量的呢？它主要依赖于 HTTP 协议中的 CONNECT 方法。
3.2.1 CONNECT 方法的工作流程
当浏览器需要通过代理访问一个 HTTPS 网站时，它不会直接发送 GET 或 POST 请求，而是先向代理服务器发送一个 CONNECT 请求。
① 浏览器向 Privoxy 发送一个 CONNECT 请求，例如 CONNECT www.example.com:443 HTTP/1.1。这个请求的目的是告诉 Privoxy：“我想连接到 www.example.com 的 443 端口（通常是 HTTPS 端口），请帮我建立一个隧道。”
② Privoxy 接收到 CONNECT 请求后，会检查请求中的域名和端口。此时，Privoxy 可以根据配置的规则对这个 CONNECT 请求本身进行处理，例如：
▮▮▮▮⚝ 检查目标域名是否在阻塞列表中。如果匹配阻塞规则，Privoxy 会返回一个错误响应（例如 403 Forbidden），阻止连接的建立。
▮▮▮▮⚝ 检查目标端口是否允许通过。
▮▮▮▮⚝ 决定是否将 CONNECT 请求转发给上游代理（如果配置了链式代理(Chaining Proxy)）。
③ 如果 Privoxy 允许建立连接，它会尝试与目标服务器（www.example.com:443）建立一个 TCP 连接。
④ 一旦与目标服务器的 TCP 连接成功建立，Privoxy 会向浏览器返回一个成功的 HTTP 响应，通常是 HTTP/1.1 200 Connection established。
⑤ 收到 200 响应后，浏览器和目标服务器之间就可以通过 Privoxy 建立的这条 TCP 连接直接进行端到端的 SSL/TLS 握手和加密通信了。
⑥ 从此时起，Privoxy 扮演的角色更像一个简单的 TCP 中继(TCP Relay)。它只是将浏览器发送的加密数据包转发给服务器，并将服务器返回的加密数据包转发给浏览器。Privoxy 无法看到加密数据包的内部内容。
这个过程可以简化为：
浏览器 -> Privoxy (CONNECT 请求) -> Privoxy (检查并建立与目标服务器的TCP连接) -> Privoxy (返回 200 OK) -> 浏览器 <----(加密通信通过Privoxy中继)----> 目标服务器
通过 CONNECT 方法，Privoxy 在保证 HTTPS 连接端到端加密安全性的同时，仍然可以对连接的建立过程进行初步的控制（基于域名和端口）。
3.2.2 HTTPS 流量过滤的局限性
正如 CONNECT 方法的工作流程所示，一旦 SSL/TLS 隧道建立，Privoxy 就无法看到加密流量的实际内容。这带来了 HTTPS 流量过滤的显著局限性：
① 无法进行内容过滤(Content Filtering)：Privoxy 无法查看响应体中的 HTML、CSS、JavaScript 等，因此无法像处理 HTTP 网页那样移除广告元素、修改页面结构或注入自定义脚本。
② 无法修改加密的头部(Encrypted Headers)：即使是请求和响应头部，一旦连接通过 SSL/TLS 加密，Privoxy 也无法在传输过程中修改它们。
③ 只能基于连接信息进行有限过滤：Privoxy 对 HTTPS 流量的过滤主要局限于 CONNECT 请求阶段能获取的信息，即目标域名和端口。它能做的是：
▮▮▮▮⚝ 根据域名或 IP 地址阻止整个 HTTPS 连接（使用 +block 动作）。
▮▮▮▮⚝ 根据域名将连接转发给特定的上游代理（使用 forward 或 forward-socks 动作）。
例如，你可以用 Privoxy 阻止对 facebook.com 的 HTTPS 访问，但你不能阻止 facebook.com 页面中的某个特定的追踪脚本，因为那个脚本的请求和响应都在加密隧道内部。
如果需要对 HTTPS 内容进行深度过滤（例如，公司网络为了安全检查而解密流量），则需要使用能够进行 SSL 解密(SSL Decryption)的代理服务器，这通常涉及到在客户端安装和信任代理服务器的根证书，这会破坏连接的端到端安全性，并且超出了 Privoxy 的设计目标和能力范围。Privoxy 的哲学是在尽可能不牺牲安全性和隐私的前提下进行过滤，因此它选择了不对 HTTPS 内容进行解密过滤。
3.3 透明代理(Transparent Proxy)设置
在上述讨论中，无论是 HTTP 还是 HTTPS，客户端（通常是浏览器）都需要被配置使用 Privoxy 作为代理服务器。然而，在某些场景下，我们希望网络中的设备无需进行任何代理配置，它们的流量就能自动通过 Privoxy 进行处理。这就是透明代理(Transparent Proxy)的概念。
透明代理的核心思想是：通过网络层或传输层的技术（例如防火墙规则），强制将原本应该直连目标服务器的网络流量重定向(redirect)到代理服务器的监听端口。对于客户端应用（如浏览器）而言，它们并不知道自己的流量正在通过代理，感觉就像是直接连接一样，因此称为“透明”。
实现透明代理通常需要在网关设备或运行 Privoxy 的主机上配置防火墙规则。以 Linux 系统为例，常用的工具是 iptables 或 nftables。
基本原理如下：
① 流量拦截: 配置防火墙规则，拦截流出网络的、目标端口是 HTTP (80) 或 HTTPS (443) 的 TCP 连接。
② 流量重定向: 将这些被拦截的流量重定向到 Privoxy 监听的端口（例如默认的 8118）。
③ Privoxy 处理: Privoxy 接收到这些被重定向的连接后，需要开启透明代理模式来正确处理它们。在 Privoxy 的配置中，通常通过特定的 listen-address 配置（例如包含 +T 标记或使用特定语法）来启用透明代理功能。在这种模式下，Privoxy 会尝试从连接中获取原始的目标地址和端口，而不是像普通代理模式那样从 HTTP 请求的 Host 头部或 CONNECT 请求中获取。
④ 模拟原始请求: Privoxy 获取到原始目标地址后，就可以像在普通代理模式下一样，对请求进行处理（对于 HTTP），或者建立 CONNECT 隧道（对于 HTTPS 的连接请求）。
⑤ 发送/转发: 处理完成后，Privoxy 将流量发送到原始目标服务器，并将响应返回给客户端。
使用 iptables 配置透明代理的简要示例 (仅作说明，具体规则需根据网络环境调整):
1
# 假设 Privoxy 运行在同一台机器上，监听 8118 端口
2
# 假设外部接口是 eth0
3
4
# 将所有发往 80 端口的 TCP 流量重定向到 8118
5
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8118
6
7
# 将所有发往 443 端口的 TCP 流量重定向到 8118
8
# 注意：这将重定向 HTTPS 的 CONNECT 请求，而不是内容本身
9
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 8118
10
11
# 排除发往 Privoxy 本身端口的流量，避免循环重定向 (如果需要)
12
# iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 8118 -j ACCEPT
13
14
# 对于 OUTPUT 链 (如果 Privoxy 和客户端在同一台机器上，需要处理本机发出的流量)
15
# iptables -t nat -A OUTPUT -p tcp --dport 80 -j REDIRECT --to-port 8118
16
# iptables -t nat -A OUTPUT -p tcp --dport 443 -j REDIRECT --to-port 8118
17
18
# 还需要在 Privoxy 的 listen-address 中启用透明代理模式，例如
19
# listen-address 0.0.0.0:8118 +T
透明代理的优缺点：
⚝ 优点:
▮▮▮▮⚝ 对客户端透明：无需在每个设备上单独配置代理设置。
▮▮▮▮⚝ 适用于无法手动配置代理的设备或应用。
▮▮▮▮⚝ 可以强制网络中的所有流量都经过过滤。
⚝ 缺点:
▮▮▮▮⚝ 配置相对复杂，依赖防火墙规则。
▮▮▮▮⚝ 需要在网关或共享网络的主机上部署。
▮▮▮▮⚝ 某些复杂的网络环境或应用可能存在兼容性问题。
▮▮▮▮⚝ HTTPS 的透明代理仍然无法解密内容，过滤能力受限。
透明代理是一种强大的部署方式，尤其适用于家庭网络、小型办公室或虚拟机环境，可以为连接到该网络的设备提供统一的隐私保护和广告过滤。
3.4 Privoxy 的内部处理流程
为了更系统地理解 Privoxy 如何将请求和响应处理，我们可以概括其内部的核心流程。当一个连接到达 Privoxy 监听的端口时（无论是普通代理还是透明代理模式），Privoxy 会启动一个处理流程：
① 连接建立: Privoxy 接受客户端发起的 TCP 连接。
② 请求接收与解析: Privoxy 读取客户端发送的请求数据。
▮▮▮▮⚝ 对于 HTTP 请求，解析出请求行（方法、URL、协议版本）和头部。
▮▮▮▮⚝ 对于 HTTPS 的 CONNECT 请求，解析出目标主机和端口。
▮▮▮▮⚝ 对于透明代理模式下的请求，Privoxy 会尝试获取原始目标地址和端口。
③ 预处理与初步检查: 在解析请求后，Privoxy 会进行一些初步检查和预处理：
▮▮▮▮⚝ 检查访问控制规则 (permit/deny)，判断该客户端是否有权限使用代理。
▮▮▮▮⚝ 判断是 HTTP 请求还是 CONNECT 请求。
④ 动作文件处理 (HTTP 请求): 如果是 HTTP 请求，Privoxy 的核心过滤引擎开始工作。它会加载并按顺序处理配置中指定的动作文件(.action 文件)。
▮▮▮▮⚝ Privoxy 遍历动作文件中的规则，针对当前请求的 URL、头部等信息进行模式匹配(Pattern Matching)。
▮▮▮▮⚝ 对于匹配到的规则，Privoxy 会收集相应的动作(Action)。例如，一个 URL 可能匹配到一条 +block 规则和一条 +hide-user-agent 规则。
▮▮▮▮⚝ Privoxy 根据收集到的动作，决定如何处理请求。可能的操作包括：
▮▮▮▮▮▮▮▮❶ 阻塞请求 (+block)：直接向客户端返回一个错误页面（例如，表示被 Privoxy 阻止）。
▮▮▮▮▮▮▮▮❷ 修改请求头部 (+hide-headers, +change-x-forwarded-for 等)。
▮▮▮▮▮▮▮▮❸ 重定向请求 (+redirect) 到其他 URL。
⑤ CONNECT 请求处理 (HTTPS): 如果是 CONNECT 请求，Privoxy 主要依据请求中的目标主机和端口来应用规则。
▮▮▮▮⚝ 检查是否存在针对该主机/端口的 +block 规则。
▮▮▮▮⚝ 检查是否存在 forward/forward-socks 规则，决定是否将 CONNECT 请求转发给上游代理。
⑥ 转发或建立连接:
▮▮▮▮⚝ 如果请求未被阻塞，并且没有配置上游代理，Privoxy 会与目标服务器建立新的连接。
▮▮▮▮⚝ 如果配置了上游代理（forward/forward-socks），Privoxy 会将请求（对于 HTTP）或 CONNECT 请求（对于 HTTPS）发送给上游代理。
⑦ 响应接收与处理 (HTTP 响应): Privoxy 接收到目标服务器（或上游代理）返回的响应后：
▮▮▮▮⚝ 解析响应头部。
▮▮▮▮⚝ 再次应用动作文件中的规则，这次主要针对响应头部和响应体进行匹配。
▮▮▮▮⚝ 根据匹配到的动作，决定如何处理响应：
▮▮▮▮▮▮▮▮❶ 修改响应头部 (+session-cookies, +force-remote-cookies 等)。
▮▮▮▮▮▮▮▮❷ 应用内容过滤器 (+filter) 修改响应体内容（例如，移除广告、注入脚本）。
⑧ 转发响应: Privoxy 将处理后的响应发送回客户端。
⑨ 连接关闭: 当请求/响应事务完成或发生错误时，Privoxy 关闭与客户端和服务器的连接。
整个过程是一个流水线式的处理。Privoxy 会为每个进入的连接（或更准确地说，每个 HTTP 请求/响应对）执行上述流程。其高效的模式匹配引擎和灵活的动作系统是实现精细过滤的关键。理解这个流程，能帮助你在配置复杂规则时，预判 Privoxy 会如何处理特定的流量，并在遇到问题时更有效地进行调试。
第四章：核心配置——privoxy.cfg 深度解析
本章将带您深入探索 Privoxy 的核心——其主配置文件 privoxy.cfg。理解并掌握这个文件是有效利用 Privoxy 进行隐私保护和流量控制的关键。我们将逐一解析文件中的重要指令，学习如何根据自己的需求定制 Privoxy 的行为，从而充分发挥其强大功能。无论是初学者还是希望进行高级配置的专家，本章都将为您提供宝贵的知识和实践指导。
4.1 配置文件的位置与结构
privoxy.cfg 是 Privoxy 的主配置文件，包含了控制 Privoxy 运行行为的各种指令。了解这个文件在哪里以及它的基本结构是开始配置的第一步。
不同操作系统的安装方式和文件管理习惯不同，导致 privoxy.cfg 的默认位置也会有所差异。
① 在 Linux 系统上：
▮▮▮▮通常位于 /etc/privoxy/privoxy.cfg 或 /usr/local/etc/privoxy/privoxy.cfg。如果您是通过包管理器安装的，很可能在 /etc 目录下。如果是从源代码编译安装，通常在 /usr/local/etc 下。
▮▮▮▮有时，配置文件可能位于其他路径，具体取决于发行版或编译时的配置参数。您可以使用 find / -name privoxy.cfg 命令尝试查找其位置。
② 在 Windows 系统上：
▮▮▮▮通常位于 Privoxy 安装目录下的 config 子文件夹内，例如 C:\Program Files\Privoxy\config\privoxy.cfg 或 C:\Privoxy\config\privoxy.cfg。
③ 在 macOS 系统上：
▮▮▮▮如果使用 Homebrew 安装，配置文件可能位于 /usr/local/etc/privoxy/privoxy.cfg。如果是官方安装包，可能在 /Applications/Privoxy/config/privoxy.cfg 或其他系统目录下。
配置文件的基本结构：
privoxy.cfg 文件是一个纯文本文件，由一系列指令组成。每一行通常包含一个指令及其参数。其结构相对简单：
⚝ 指令（Directive）：指定 Privoxy 的某个特定设置或行为。
⚝ 参数（Arguments）：提供指令所需的具体数值、路径或其他信息。
⚝ 注释（Comments）：以 # 开头的行是注释，Privoxy 会忽略这些行。注释用于解释指令的作用或临时禁用某些配置，是理解和管理配置文件的重要工具。
⚝ 空行：空行也会被忽略，用于提高配置文件的可读性，分隔不同的配置部分。
一个典型的 privoxy.cfg 文件片段可能看起来像这样：
1
# This is the main configuration file for Privoxy.
2
3
# 4.2 Network Interface and Port Configuration
4
listen-address 127.0.0.1:8118
5
6
# 4.3 Access Control
7
permit-access 127.0.0.1
8
9
# 4.4 Logging
10
logfile privoxy.log
11
loglevel 6 # Info level
在修改配置文件之前，强烈建议先备份原始文件，以防配置错误导致 Privoxy 无法正常启动或工作。例如，可以执行 cp /etc/privoxy/privoxy.cfg /etc/privoxy/privoxy.cfg.bak 进行备份。
4.2 网络接口与端口配置 (listen-address)
listen-address 指令用于配置 Privoxy 监听（Listen）哪个网络接口（Network Interface）和端口（Port）以接收来自客户端的代理请求。这是让浏览器或其他应用程序能够连接到 Privoxy 的基础。
该指令的格式通常是 listen-address [IP地址]:[端口号] 或 listen-address [hostname]:[端口号]。
① IP地址或主机名（IP Address or Hostname）：
▮▮▮▮指定 Privoxy 应该监听的本地网络接口。
▮▮▮▮127.0.0.1 或 localhost：表示 Privoxy 只监听本地回环接口（Loopback Interface），只允许在运行 Privoxy 的同一台设备上的应用程序通过 127.0.0.1:[端口号] 连接。这是最安全的默认设置，限制了外部访问。
▮▮▮▮0.0.0.0 或 *：表示 Privoxy 监听所有可用的网络接口。这意味着局域网（Local Area Network）内的其他设备理论上也可以通过您的设备 IP 地址和配置的端口连接到 Privoxy。如果您希望在局域网内共享 Privoxy，可以使用此设置。请注意，这样做会增加安全风险，应谨慎使用，并结合访问控制（ permit/deny）来限制谁可以连接。
▮▮▮▮特定的本地 IP 地址（Specific Local IP Address）：如果您有多块网卡或希望 Privoxy 只监听某个特定的本地 IP 地址，可以直接指定该 IP 地址。例如，192.168.1.100:8118。
② 端口号（Port Number）：
▮▮▮▮指定 Privoxy 监听的 TCP 端口。
▮▮▮▮默认端口通常是 8118。
▮▮▮▮您可以选择任何未被其他程序占用的端口，但建议使用 1024 以上的非特权端口。
▮▮▮▮例如，listen-address 127.0.0.1:8118 表示 Privoxy 只在本地的 8118 端口监听。
▮▮▮▮例如，listen-address 192.168.1.100:8000 表示 Privoxy 在 IP 地址为 192.168.1.100 的接口上监听 8000 端口。
▮▮▮▮例如，listen-address 0.0.0.0:8118 表示 Privoxy 监听所有接口的 8118 端口。
您可以配置多个 listen-address 指令，让 Privoxy 同时在不同的接口和端口上监听。
1
# Listen on the local machine only, port 8118 (default)
2
listen-address 127.0.0.1:8118
3
4
# Listen on the local network interface with IP 192.168.1.100, port 8118
5
# This allows other devices on the local network to connect
6
# listen-address 192.168.1.100:8118
7
8
# Listen on all network interfaces, port 8118
9
# Use with caution and apply access controls!
10
# listen-address 0.0.0.0:8118
配置完成后，需要重启或重新加载 Privoxy 服务以使更改生效。
4.3 访问控制 (permit/deny)
permit 和 deny 指令用于控制哪些客户端 IP 地址被允许或拒绝连接到 Privoxy。这在将 Privoxy 监听地址设置为非 127.0.0.1（如 0.0.0.0 或局域网 IP）时尤为重要，可以增强安全性，防止未授权的设备使用您的代理。
これらの指令は、Privoxy がリクエストを受け付ける際に、接続元の IP アドレスに基づいてアクセスを許可または拒否するために使用されます。
指令的格式是 permit-access [IP地址或网络/掩码] 或 deny-access [IP地址或网络/掩码]。
① IP地址或网络（IP Address or Network）：
▮▮▮▮可以是单个 IP 地址，例如 192.168.1.5。
▮▮▮▮可以是 IP 地址段，使用斜线（/）加子网掩码位表示法（CIDR），例如 192.168.1.0/24 表示 192.168.1.x 这个网段的所有 IP 地址。
▮▮▮▮可以是 IP 地址和网络掩码（Network Mask），例如 192.168.1.0/255.255.255.0，等同于上面的 /24。
② 指令的顺序很重要：
▮▮▮▮Privoxy 会按照指令在文件中的顺序从上到下进行匹配。
▮▮▮▮一旦匹配到一条规则，就会立即应用该规则（许可或拒绝），并停止进一步检查。
▮▮▮▮通常，您会先 deny 明确不允许的，然后 permit 允许剩余的；或者先 permit 明确允许的，然后 deny 剩余的（默认行为）。
▮▮▮▮请注意：如果没有 permit-access 指令，默认行为是允许所有连接到监听地址的客户端。如果设置了任何 permit-access 指令，则默认行为变为拒绝所有未被明确许可的连接。
示例：
⚝ 示例 1：只允许本地连接（这是默认且最安全的）
1
listen-address 127.0.0.1:8118
2
# No permit/deny needed here, as 127.0.0.1 is inherently local.
3
# If you WERE to use permit/deny with 127.0.0.1, it would look like:
4
# permit-access 127.0.0.1
5
# deny-access 0.0.0.0/0 # This line is redundant if listen-address is 127.0.0.1
⚝ 示例 2：允许本地连接和局域网内的特定设备
1
listen-address 0.0.0.0:8118 # 或你的局域网IP，例如 192.168.1.100:8118
2
permit-access 127.0.0.1 # 允许本机连接
3
permit-access 192.168.1.200 # 允许局域网内的特定IP地址连接
4
# 如果没有其他 permit/deny，则默认拒绝其他所有连接。
5
# 如果你想明确拒绝其他所有连接：
6
# deny-access 0.0.0.0/0 # 拒绝所有其他IP
⚝ 示例 3：允许整个局域网段连接
1
listen-address 0.0.0.0:8118 # 或你的局域网IP
2
permit-access 127.0.0.1 # 允许本机连接
3
permit-access 192.168.1.0/24 # 允许 192.168.1.x 网段的所有IP连接
4
# deny-access 0.0.0.0/0 # 可选，明确拒绝其他所有IP
⚝ 示例 4：拒绝特定的局域网设备，允许其他局域网设备
1
listen-address 0.0.0.0:8118 # 或你的局域网IP
2
deny-access 192.168.1.50 # 拒绝这个特定的IP
3
permit-access 192.168.1.0/24 # 允许 192.168.1.x 网段的所有IP连接 (除了上面被拒绝的)
4
permit-access 127.0.0.1 # 允许本机连接
5
# 注意顺序，先拒绝特定的，再许可一个范围。
正确配置访问控制对于确保只有预期的客户端能够使用 Privoxy 至关重要，尤其是在开放监听端口时。
4.4 日志配置 (logfile, loglevel)
日志（Log）是诊断问题、监控 Privoxy 运行状态以及理解其如何处理流量的宝贵信息来源。Privoxy 提供了灵活的日志配置选项。
相关的核心指令是 logfile 和 loglevel。
① logfile 指令：
▮▮▮▮用于指定 Privoxy 将日志输出到哪个文件。
▮▮▮▮格式：logfile [文件路径]
▮▮▮▮如果指定文件路径，Privoxy 会将日志写入该文件。请确保运行 Privoxy 的用户有权限在该位置创建和写入文件。
▮▮▮▮如果参数是 /dev/null (Linux/macOS) 或 NUL (Windows)，则表示禁用文件日志输出。
▮▮▮▮如果该指令被注释掉或不存在，Privoxy 通常会将日志输出到标准错误流（Standard Error Stream），这通常意味着日志会显示在您启动 Privoxy 的终端窗口中，或者被系统的日志服务（如 systemd journald, syslog）捕获。
1
# Log to a specific file
2
logfile /var/log/privoxy/privoxy.log
3
4
# Disable file logging (log goes to stderr, often captured by systemd/syslog)
5
# logfile /dev/null
② loglevel 指令：
▮▮▮▮用于控制日志输出的详细程度。不同的级别对应不同类型的信息。
▮▮▮▮格式：loglevel [级别数字] 或 loglevel [级别名称]
▮▮▮▮级别数字越高，日志越详细。常用的级别及含义（可能随版本略有差异）：
▮▮▮▮▮▮▮▮❶ 0 (fatal)：致命错误，Privoxy 将停止运行。
▮▮▮▮▮▮▮▮❷ 1 (error)：错误，可能导致某些请求失败或功能异常，但 Privoxy 会继续运行。
▮▮▮▮▮▮▮▮❸ 2 (warning)：警告，可能存在潜在问题或非预期情况。
▮▮▮▮▮▮▮▮❹ 3 (info)：一般信息，如启动、关闭、配置加载等。
▮▮▮▮▮▮▮▮❺ 4 (debug)：调试信息，更详细的处理过程日志。
▮▮▮▮▮▮▮▮❻ 5 (debug-verbose)：非常详细的调试信息，可能包含请求/响应的更多细节。
▮▮▮▮▮▮▮▮❼ 6 (info-verbose)：包含更多处理过程的普通信息。
⑧ 7 (developer)：开发者使用的最低级别日志，包含所有信息。
通常，在日常运行时，可以将 loglevel 设置为 3 或 4。当需要诊断特定问题时，可以临时将级别提高到 6 或 7 以获取更详细的信息。
1
# Log level: Info and above
2
loglevel 3
3
4
# Log level: Debug and above (more detailed)
5
# loglevel 4
6
7
# Log level: Very verbose info (useful for troubleshooting rule application)
8
loglevel 6
结合使用 logfile 和 loglevel 可以有效地管理 Privoxy 的日志输出，帮助用户监控其状态和解决问题。
4.5 转发代理设置 (forward, forward-socks)
Privoxy 可以配置为将接收到的请求转发到另一个代理服务器。这被称为链式代理（Chaining Proxies）。这种设置常用于：
⚝ 将 Privoxy 的过滤功能与另一个代理（如 Tor）的匿名功能结合。
⚝ 通过 Privoxy 访问需要上游代理（Upstream Proxy）的网络环境。
Privoxy 支持转发到标准的 HTTP 代理或 SOCKS 代理。对应的指令是 forward 和 forward-socks。
① forward 指令：
▮▮▮▮用于将匹配特定模式的请求转发到另一个 HTTP 代理。
▮▮▮▮格式：forward [模式] [目标HTTP代理地址]
▮▮▮▮[模式]：一个模式字符串，用于匹配应该被转发的请求的目标地址（通常是 IP地址/子网掩码 或 .域名）。特殊模式 / 表示匹配所有地址。
▮▮▮▮[目标HTTP代理地址]：上游 HTTP 代理的地址和端口，格式为 IP地址:端口号 或 hostname:端口号。特殊的地址 . 表示不使用上游代理，直接连接目标服务器（这是默认行为）。特殊的地址 - 表示阻塞所有匹配该模式的请求（不常用，通常用 Action Files 的 +block 实现）。
1
# Forward all requests to an HTTP proxy at 192.168.1.200:8080
2
forward / 192.168.1.200:8080
3
4
# Forward requests to *.example.com through a specific HTTP proxy
5
forward .example.com 10.0.0.1:3128
6
7
# For all other requests, connect directly (this is implicit default if no matching forward)
8
# forward / .
② forward-socks 指令：
▮▮▮▮用于将匹配特定模式的请求转发到 SOCKS 代理（支持 SOCKS4 和 SOCKS5）。
▮▮▮▮格式：forward-socks[4|5] [模式] [目标SOCKS代理地址]
▮▮▮▮[4|5]：指定 SOCKS 协议版本，可以是 4 或 5。如果省略，则尝试使用 SOCKS5，失败后再尝试 SOCKS4。通常建议明确指定 5。
▮▮▮▮[模式]：与 forward 指令中的模式相同，用于匹配要转发的请求目标地址。/ 表示匹配所有地址。
▮▮▮▮[目标SOCKS代理地址]：上游 SOCKS 代理的地址和端口，格式为 IP地址:端口号 或 hostname:端口号。
与 Tor 集成是 forward-socks 的常见用途： Tor Browser 或 Tor 服务的默认 SOCKS 代理地址通常是 127.0.0.1:9050 或 127.0.0.1:9150。
1
# Forward all requests through a local Tor SOCKS proxy (default Tor port)
2
forward-socks5 / 127.0.0.1:9050
3
4
# If Tor Browser is running, the port might be 9150
5
# forward-socks5 / 127.0.0.1:9150
6
7
# Example: Only forward traffic to .onion addresses through Tor SOCKS proxy
8
# (Privoxy can resolve .onion names via SOCKS5 proxy that supports it, like Tor)
9
# forward-socks5 .onion 127.0.0.1:9050
10
# For all other traffic, connect directly
11
# forward / .
③ 指令顺序：
▮▮▮▮与 permit/deny 类似，forward 和 forward-socks 指令也按顺序匹配。第一个匹配到的规则决定了请求的转发路径。因此，更具体的规则应该放在前面，更通用的规则（如 /）放在后面。
链式代理是 Privoxy 强大的高级功能之一，特别是与 Tor 结合使用时，可以实现既有过滤功能又提供匿名性的上网体验。
4.6 启用/禁用功能 (toggle)
Privoxy 提供了许多功能，例如 Cookie 管理、页面内容过滤、HTTP 头部修改等。有时候，您可能希望在不修改配置文件的情况下临时开启或关闭某些功能。toggle 指令允许您通过访问一个特殊的 Privoxy 内部页面来控制这些功能的开关。
toggle 指令本身是在 privoxy.cfg 中启用或配置这个控制接口。
① 配置 toggle 指令：
▮▮▮▮格式：toggle [模式] [地址]
▮▮▮▮[模式]：一个模式字符串，匹配允许访问 Privoxy 控制页面的客户端 IP 地址或网络。通常设置为允许本地访问，例如 127.0.0.1 或 192.168.1.0/24。
▮▮▮▮[地址]：指定用于访问控制页面的特殊主机名。默认是 p.p。您可以更改它以提高一点隐蔽性，但通常使用默认值即可。
1
# Allow clients from 127.0.0.1 to access the toggle page using the hostname p.p
2
toggle 127.0.0.1 p.p
3
4
# Allow clients from the local network (192.168.1.x) to access the toggle page
5
# toggle 192.168.1.0/24 p.p
② 使用 toggle 页面：
▮▮▮▮一旦在 privoxy.cfg 中配置并启用了 toggle 指令，您就可以通过浏览器访问 Privoxy 监听地址和端口，加上配置的地址来访问控制页面。
▮▮▮▮例如，如果 listen-address 是 127.0.0.1:8118 且 toggle 配置为 p.p，您可以在浏览器中访问 http://p.p:8118/ 或 http://127.0.0.1:8118/p.p/ (取决于 Privoxy 版本和配置，通常是前者)。
▮▮▮▮这个页面通常会列出 Privoxy 的一些主要功能，以及它们的当前状态（启用/禁用），并提供切换按钮。
③ 可通过 toggle 页面控制的主要功能包括（可能随版本有所不同）：
▮▮▮▮Enable Actions（启用动作）：控制是否应用所有的过滤和修改规则。
▮▮▮▮Enable Filtering（启用过滤）：控制是否进行内容过滤。
▮▮▮▮Enable Ad Blocking（启用广告屏蔽）：控制是否执行广告相关的屏蔽规则。
▮▮▮▮Enable Privacy（启用隐私保护）：控制是否执行隐私相关的头部修改、Cookie 管理等。
▮▮▮▮Enable Socks Proxying（启用 SOCKS 代理）：控制是否使用配置的 forward-socks 规则。
▮▮▮▮Enable HTTP Proxying（启用 HTTP 代理）：控制是否使用配置的 forward 规则。
通过 toggle 页面，您可以方便地在需要时快速调整 Privoxy 的行为，而无需频繁编辑和重启服务。
4.7 其他重要配置项
除了上述核心指令外，privoxy.cfg 文件还包含许多其他指令，用于更精细地控制 Privoxy 的行为、性能和兼容性。了解这些指令可以帮助您更好地优化和定制 Privoxy。
这里介绍一些常用的其他重要配置项：
① temp-directory：
▮▮▮▮指定 Privoxy 存储临时文件的目录。
▮▮▮▮格式：temp-directory [目录路径]
▮▮▮▮在处理一些大型请求或进行复杂的过滤时，Privoxy 可能需要使用临时文件。确保指定的目录存在且 Privoxy 有写入权限。默认情况下，Privoxy 可能会使用系统的临时目录。
1
# Set the temporary directory
2
temp-directory /tmp/privoxy
② buffer-limit：
▮▮▮▮限制 Privoxy 为每个连接分配的最大缓冲区大小，单位是字节（Bytes）。这有助于控制内存使用，防止单个大请求耗尽资源。
▮▮▮▮格式：buffer-limit [大小]
▮▮▮▮默认值通常是 4MB。如果处理非常大的文件上传/下载或页面，可能需要适当增加，但要注意内存消耗。
1
# Set the buffer limit to 8MB
2
buffer-limit 8MB
③ socket-timeout：
▮▮▮▮设置 Privoxy 与客户端或目标服务器之间连接的超时时间，单位是秒（Seconds）。如果连接在指定时间内无活动，Privoxy 会关闭它。
▮▮▮▮格式：socket-timeout [秒数]
▮▮▮▮默认值通常是 300 秒（5分钟）。可以根据网络环境调整，减小该值可以更快地清理死连接，但可能导致在慢速网络下连接过早中断。
1
# Set socket timeout to 60 seconds
2
socket-timeout 60
④ handle-as-empty-request 和 handle-as-empty-response：
▮▮▮▮这些指令用于处理特定的 HTTP 状态码。当 Privoxy 收到这些状态码的响应时，会将其视为空请求或空响应，这有时用于绕过一些简单的内容嗅探或过滤机制。
▮▮▮▮格式：
▮▮▮▮handle-as-empty-request [状态码列表]
▮▮▮▮handle-as-empty-response [状态码列表]
▮▮▮▮状态码列表是空格分隔的数字，例如 204 304。
1
# Treat 204 (No Content) and 304 (Not Modified) as empty responses
2
handle-as-empty-response 204 304
⑤ keep-alive-timeout：
▮▮▮▮设置 HTTP 持久连接（Keep-Alive Connection）的超时时间。
▮▮▮▮格式：keep-alive-timeout [秒数]
▮▮▮▮默认值通常是 5 秒。较长的超时时间可以减少建立新连接的开销，提高性能，但会占用更多资源。
1
# Set keep-alive timeout to 10 seconds
2
keep-alive-timeout 10
⑥ enable-remote-http-toggle 和 enable-remote-http-info：
▮▮▮▮类似于 toggle 指令，但用于通过 HTTP 访问特定的控制和信息页面，而不是特殊的 p.p 地址。
▮▮▮▮enable-remote-http-toggle [模式]：启用通过常规 HTTP 访问 toggle 页面。强烈不建议在不可信网络接口上启用此功能，因为它没有认证，可能被滥用。
▮▮▮▮enable-remote-http-info [模式]：启用通过常规 HTTP 访问 Privoxy 的信息页面，可以查看状态、版本、配置摘要等。同样需要谨慎使用。
1
# WARNING: Use with caution!
2
# enable-remote-http-toggle 127.0.0.1
3
# enable-remote-http-info 127.0.0.1
privoxy.cfg 文件中还有更多指令，您可以在 Privoxy 的官方文档中找到完整的指令列表和详细说明。通过结合使用这些指令，您可以根据具体的网络环境、安全需求和性能偏好，对 Privoxy 进行深度定制。
在修改 privoxy.cfg 文件后，务必重启或重新加载 Privoxy 服务，以使新的配置生效。在 Linux 上，这通常通过服务管理命令完成，例如 sudo systemctl restart privoxy 或 sudo service privoxy restart。在 Windows 上，可以通过服务管理器重启 Privoxy 服务。
1
# Linux systemd example
2
sudo systemctl restart privoxy
3
4
# Linux SysVinit example
5
sudo service privoxy restart
6
7
# Windows: Open Services management console, find Privoxy service, right-click and Restart.
掌握 privoxy.cfg 的配置是迈向 Privoxy 高级应用的关键一步。在下一章中，我们将深入探讨 Privoxy 最强大的过滤引擎——Actions 文件，学习如何编写规则来实际地过滤内容和修改流量。
第五章：过滤引擎——Actions 文件详解
欢迎来到本书的核心章节之一！🎉 在前面的章节中，我们已经了解了 Privoxy 的基本概念、安装以及它作为代理服务器处理流量的方式。现在，是时候深入探索 Privoxy 最强大的功能——流量过滤和修改了。而实现这一切的关键，就在于动作文件 (Action Files)。
本章将带您全面解析动作文件的方方面面：它们如何工作，基本的语法规则，强大的模式匹配能力，以及 Privoxy 提供的各种丰富的动作类型。无论您是想屏蔽广告、增强隐私、控制网站行为，还是进行更复杂的流量定制，理解动作文件都是必不可少的第一步。
5.1 动作文件的工作机制
Privoxy 的过滤和修改能力完全依赖于加载的动作文件。当 Privoxy 启动时，它会读取主配置文件 privoxy.cfg。在这个文件中，通过 actionsfile 指令指定了一个或多个动作文件。Privoxy 会按照指定的顺序加载这些文件，并将其中定义的规则（即模式与动作的组合）编译到其内存中的过滤引擎里。
当一个 HTTP 或 HTTPS (通过 CONNECT 方法) 请求到达 Privoxy 时，Privoxy 会执行以下基本流程：
① 接收并解析客户端的请求（例如，获取 URL、请求方法、头部等）。
② 检查请求是否符合任何一个加载的动作文件中定义的模式 (Pattern)。
③ 如果请求匹配到某个模式，Privoxy 会查找与该模式相关联的动作 (Action)。一个模式可以关联一个或多个动作。
④ Privoxy 按照预定义的顺序或优先级（虽然用户通常不直接控制优先级，但内部处理有其逻辑，例如，阻塞通常优先于过滤）执行匹配到的动作。
⑤ 动作可能会修改请求（例如，更改头部）、过滤响应内容（如果请求是 HTTP 并且内容是文本类型），或者完全阻塞请求。
⑥ 处理完毕后，Privoxy 将修改后的请求转发到目标服务器（如果未被阻塞），或将服务器的响应（可能被过滤修改）发送回客户端。
这个过程的核心是模式匹配 (Pattern Matching)和动作执行 (Action Execution)。动作文件就是定义了“如果匹配到这样的模式，就执行那样的动作”的规则集合。
5.2 动作文件基本语法 (.action 文件)
动作文件通常以 .action 为扩展名，例如 default.action, user.action。它们是纯文本文件，可以使用任何文本编辑器打开和修改。理解其基本语法对于编写和定制规则至关重要。
动作文件中的每一行通常包含一个规则定义或一个指令。规则定义的基本结构是：
1
{ 动作列表 } 模式
或者更常见的，先列出模式，再列出动作：
1
模式 { 动作列表 }
例如：
1
{ +block } example.com
2
{ +hide-user-agent } .
第一行表示匹配到 example.com 时执行 +block 动作。
第二行表示匹配到任意内容 (.) 时执行 +hide-user-agent 动作。
下面详细介绍动作文件中的关键语法元素：
① 注释 (Comments)
▮▮▮▮以 # 开头的行是注释，Privoxy 会忽略它们。这对于解释规则的目的非常有用。
1
# 这是一个注释，说明下面的规则是用来屏蔽广告的
2
{ +block } adserver.com
② 模式 (Pattern)
▮▮▮▮模式用于指定哪些 URL、域名或其他信息会触发关联的动作。模式是动作文件规则的核心，我们将在下一节详细讨论模式匹配语法。
③ 动作列表 (Action List)
▮▮▮▮动作列表包含一个或多个动作，用空格分隔。每个动作前通常带有 + 或 - 符号，表示启用或禁用该动作。
▮▮▮▮+动作名：启用指定的动作。
▮▮▮▮-动作名：禁用指定的动作。
▮▮▮▮例如：{ +block +hide-referer } example.com 表示对 example.com 同时执行阻塞和隐藏 Referer 头部两个动作。
④ 指令 (Directives)
▮▮▮▮动作文件中也可以包含一些特殊的指令，最常用的是 +include。
▮▮▮▮+include 文件名：这个指令告诉 Privoxy 在当前位置包含并处理另一个动作文件。这使得组织和管理大量规则变得更容易，可以将规则分门别类放在不同的文件中。
1
# 加载默认的规则文件
2
+include default.action
3
4
# 加载用户自定义的广告屏蔽规则
5
+include user-ads.action
6
7
# 加载用户自定义的隐私增强规则
8
+include user-privacy.action
▮▮▮▮通过 +include 指令，privoxy.cfg 中指定的第一个动作文件通常会作为主入口点，然后通过链式包含来加载所有其他必要的规则文件。
⑤ 条件性规则 (Conditional Rules)
▮▮▮▮如前面提到的，动作文件也可以包含更复杂的条件性规则，这在第七章的高级主题中会更详细介绍。简单的形式是 { 动作列表 } 条件 { 动作列表 } 模式 或 { 动作列表 } 模式 { 动作列表 } 条件。不过通常条件性规则是放在大括号内的。例如：
1
{ +block { /*.doubleclick.net/ */ } } # 匹配任意请求，但如果URL包含doubleclick.net，则阻塞
▮▮▮▮这里的 { /*.doubleclick.net/ */ } 是一个附加的模式条件。只有主模式和条件模式都匹配时，才会执行动作。这在某些复杂场景下非常有用。
理解这些基本语法后，您就可以开始阅读和修改现有的动作文件，或者编写自己的简单规则了。
5.3 模式匹配语法 (Pattern Matching)
模式匹配是 Privoxy 过滤引擎的核心，决定了哪些网络请求或响应会受到动作的影响。Privoxy 提供了多种模式匹配语法，从简单的字符串匹配到强大的正则表达式。
5.3.1 基础模式匹配
Privoxy 的基础模式匹配主要用于匹配请求的 URL (Uniform Resource Locator)。
① 直接字符串匹配
▮▮▮▮直接输入一个字符串，Privoxy 会检查请求的 URL 中是否包含该字符串。
1
# 匹配所有包含 "ads" 字符串的 URL
2
{ +block } ads
▮▮▮▮这个规则会匹配 http://www.example.com/banners/ads/image.gif，也会匹配 http://ads.example.com/page.html。
② 精确匹配 (Exact Match)
▮▮▮▮使用 = 符号开头表示精确匹配整个 URL。
1
# 精确匹配这个特定的URL，不多不少
2
{ +block } =http://www.example.com/specific-ad.html
③ 前缀匹配 (Prefix Match)
▮▮▮▮使用 == 符号开头表示匹配 URL 的前缀。
1
# 匹配所有以 http://ads.example.com/ 开头的URL
2
{ +block } ==http://ads.example.com/
④ 后缀匹配 (Suffix Match)
▮▮▮▮使用 $ 符号结尾表示匹配 URL 的后缀。
1
# 匹配所有以 .gif 结尾的URL (注意：实际应用中不推荐这样简单屏蔽，容易误伤)
2
{ +block } .gif$
⑤ 通配符匹配 (Wildcard Matching)
▮▮▮▮Privoxy 支持简单的通配符：
▮▮▮▮*：匹配零个或多个任意字符。
▮▮▮▮?：匹配正好一个任意字符。
1
# 匹配所有域名以 "ad" 开头，后面跟任意字符的域名下的任意路径
2
{ +block } *://ad*.example.com/*
3
4
# 匹配 /banner/ 目录下，文件名有三个字符且以 .png 结尾的图片
5
{ +block } */banner/???.png
⑥ 域名前缀匹配 (.domain 形式)
▮▮▮▮以 . 开头表示匹配指定域名或其子域名下的所有 URL。
1
# 匹配 example.com 及其所有子域名下的所有URL
2
{ +block } .example.com
▮▮▮▮这个规则会匹配 http://example.com/page，http://www.example.com/page，http://ads.example.com/page 等。
⑦ 路径匹配 (/path 形式)
▮▮▮▮以 / 开头表示匹配请求路径中包含该路径段的 URL。
1
# 匹配所有包含 /ads/ 路径段的URL
2
{ +block } /ads/
这些基础模式匹配已经可以满足很多常见的过滤需求，尤其是基于 URL 或域名进行屏蔽。
5.3.2 正则表达式匹配 (Regular Expressions)
对于更复杂的模式匹配需求，Privoxy 支持使用正则表达式 (Regular Expressions)。在动作文件中，正则表达式模式需要用 / 符号包围起来。
① 基本语法
▮▮▮▮正则表达式模式写在两个 / 之间。Privoxy 使用的是 POSIX 扩展正则表达式语法。
1
# 匹配所有 URL 中包含任意数字后跟 "ad" 字符串的情况，例如 /123ad/ 或 banner45ad.gif
2
{ +block } /[0-9]+ad/
② 匹配位置锚定
▮▮▮▮^：匹配字符串的开始。
▮▮▮▮$：匹配字符串的结束。
1
# 匹配以 http://ads. 开头的URL
2
{ +block } /^http:\/\/ads\./
▮▮▮▮注意：在正则表达式中，特殊字符（如 ., /, ?, +, * 等）需要使用反斜杠 \ 进行转义，除非它们被用作正则表达式运算符。
③ 常用元字符与量词
▮▮▮▮.：匹配除换行符外的任意单个字符。
▮▮▮▮*：匹配前一个元素零次或多次。
▮▮▮▮+：匹配前一个元素一次或多次。
▮▮▮▮?：匹配前一个元素零次或一次。
▮▮▮▮|：选择，匹配 | 符号前或后的表达式。
▮▮▮▮(...)：分组，也可以用于捕获（尽管 Privoxy 动作不直接使用捕获组）。
▮▮▮▮[...]：字符集，匹配方括号内的任意一个字符。
▮▮▮▮[^...]：否定字符集，匹配不在方括号内的任意一个字符。
▮▮▮▮{n}：匹配前一个元素正好 n 次。
▮▮▮▮{n,}：匹配前一个元素至少 n 次。
▮▮▮▮{n,m}：匹配前一个元素至少 n 次，至多 m 次。
④ 在不同位置使用正则
▮▮▮▮正则表达式模式默认是匹配整个 URL 字符串。但也可以通过特定的语法将其应用于请求或响应头部。例如，在头部匹配时，正则表达式模式前需要加上 <Header>。
1
# 匹配请求头部中包含 "User-Agent" 且值为 Firefox 的情况 (示例，实际修改头部更常用动作)
2
{ +block } /^User-Agent: .*Firefox/i
▮▮▮▮注意：i 标志表示不区分大小写匹配。并非所有 Privoxy 版本和模式都完全支持所有正则表达式特性和标志，但基本语法是通用的。
⑤ 正则表达式的优势与注意事项
▮▮▮▮优势：能够构建非常灵活和复杂的匹配规则，处理传统通配符难以应对的场景。
▮▮▮▮注意事项：
▮▮▮▮▮▮▮▮❶ 正则表达式比基础模式匹配的性能开销更大。编写低效的正则表达式可能会影响 Privoxy 的速度。
▮▮▮▮▮▮▮▮❷ 正则表达式容易出错，需要仔细测试。
▮▮▮▮▮▮▮▮❸ 在 Privoxy 中使用正则时，要注意模式默认匹配的是整个 URL 字符串，而不是 URL 的某个部分（如域名或路径），除非使用了锚点或特定语法。
掌握了模式匹配语法，您就拥有了精准定位网络请求的能力。接下来，我们将了解匹配后可以执行哪些动作。
5.4 常用动作类型 (Action Types) 详解
Privoxy 提供了丰富的动作类型，可以对匹配到的请求或响应执行各种操作。以下是一些最常用、最重要的动作类型：
5.4.1 阻塞动作 (+block, -block)
这是最直接的动作，用于阻止对特定 URL 或模式匹配到的资源的访问。
① +block
▮▮▮▮阻止对匹配模式的 URL 的访问。当一个请求被 +block 动作匹配并阻止时，Privoxy 会返回一个内部的“阻塞”页面给客户端浏览器，通常显示“此地址被 Privoxy 阻止”的信息。
1
# 阻塞对特定广告域名的访问
2
.doubleclick.net { +block }
3
.googlesyndication.com { +block }
4
5
# 阻塞包含 "/adserver/" 路径的任何URL
6
/adserver/ { +block }
② -block
▮▮▮▮在某些情况下，你可能有更广泛的阻塞规则，但想对特定网站或 URL 禁用阻塞。-block 动作就用于此目的。由于 Privoxy 按照动作文件中规则出现的顺序进行处理，并且后匹配到的动作可以覆盖先前的动作（对于某些动作类型），或者规则集之间存在优先级（更具体的规则通常优先，尽管这取决于具体实现）， -block 可以用来创建例外。
1
# 默认阻塞所有以 /ads/ 开头的URL
2
/ads/ { +block }
3
4
# 但允许访问 example.com 网站中以 /ads/ 开头的URL (假设这条规则出现在上面的后面或者规则集有优先级配置使其生效)
5
.example.com/ads/ { -block }
▮▮▮▮实际使用 -block 进行例外处理时，需要注意规则的顺序和组织方式，以确保期望的规则能够正确生效。
5.4.2 过滤动作 (+filter, -filter)
过滤动作用于激活或禁用 Privoxy 内置或用户自定义的过滤器。这些过滤器可以检查和修改 HTTP 响应的内容（例如 HTML 页面），从而移除广告元素、追踪代码、弹窗脚本等。
① +filter: 过滤器名称
▮▮▮▮激活对匹配模式的 URL 的响应执行指定的过滤器。Privoxy 内置了许多过滤器，例如 crunch-css (压缩 CSS), clean-html (清理 HTML), fast-redirects (加速重定向) 等，以及用于广告屏蔽的特定过滤器（通常以 +filter{名称} 的形式在规则中使用）。
1
# 对所有网站响应启用特定的广告过滤脚本
2
. { +filter: javascript-ads }
3
4
# 对特定网站启用 HTML 清理过滤器
5
.problem-site.com { +filter: clean-html }
▮▮▮▮过滤器的名称通常是预定义的（内置过滤器）或在 .filter 文件中定义的。
② -filter: 过滤器名称
▮▮▮▮禁用对匹配模式的 URL 的响应执行指定的过滤器。用于为特定网站创建过滤例外。
1
# 对所有网站启用一个广泛的广告过滤
2
. { +filter: extensive-ad-filter }
3
4
# 但对银行网站禁用此过滤，以免影响正常功能
5
.bank.com { -filter: extensive-ad-filter }
③ +filter (不带过滤器名称)
▮▮▮▮激活所有适用的过滤器。这通常不是一个好主意，因为它可能会启用不希望在所有网站上运行的过滤器。
④ -filter (不带过滤器名称)
▮▮▮▮禁用所有适用的过滤器。可以用来对特定网站完全关闭所有内容过滤。
1
# 对所有网站启用一些基础过滤
2
. { +filter: basic-filters }
3
4
# 对一个已知安全的网站完全禁用所有内容过滤
5
.trusted-site.org { -filter }
▮▮▮▮过滤器的具体功能和如何编写自定义过滤器将在第七章详细介绍。
5.4.3 头部修改动作 (+hide-headers, +change-x-forwarded-for 等)
这类动作用于修改或移除 HTTP 请求和响应的头部信息，这对于增强隐私保护至关重要。网站和广告商经常通过头部信息来追踪用户。
① +hide-headers: 头部名称列表
▮▮▮▮从请求或响应中移除指定的头部。常见的用于隐私保护的头部包括 Referer (拼写错误是历史遗留问题，但现在标准是 Referrer), User-Agent, Cookie, Via, From 等。
1
# 移除 Referer 头部，阻止网站知道您从哪个页面链接过来
2
. { +hide-headers: Referer }
3
4
# 移除 Via 头部，隐藏您正在使用代理的事实
5
. { +hide-headers: Via }
6
7
# 同时移除多个头部
8
. { +hide-headers: Referer,User-Agent,Cookie }
▮▮▮▮注意：移除所有 Cookie 可能会导致网站无法正常工作。通常更倾向于使用 Cookie 控制动作。
② +change-x-forwarded-for: 模式
▮▮▮▮X-Forwarded-For 头部通常被代理服务器用来标识原始客户端的 IP 地址。这可能会暴露您的真实 IP。+change-x-forwarded-for 动作可以修改这个头部。
▮▮▮▮+change-x-forwarded-for{block}：完全移除 X-Forwarded-For 头部。
▮▮▮▮+change-x-forwarded-for{forge}：伪造一个假的 X-Forwarded-For 头部（不常用）。
▮▮▮▮+change-x-forwarded-for{allow}：允许保留 X-Forwarded-For 头部（默认行为）。
1
# 对所有网站移除 X-Forwarded-For 头部以保护隐私
2
. { +change-x-forwarded-for{block} }
③ +add-header: 头部名称: 头部值
▮▮▮▮向请求或响应中添加自定义头部。这在模拟特定客户端或与特定服务器交互时可能有用。
1
# 向所有请求添加一个伪造的 User-Agent 头部 (示例)
2
. { +add-header: User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.85 Safari/537.36 }
▮▮▮▮注意：Privoxy 也提供专门用于修改 User-Agent 的动作 +hide-user-agent。
④ +hide-user-agent, -hide-user-agent
▮▮▮▮这是一个专门用于修改 User-Agent 头部以增强隐私的动作。+hide-user-agent 会用一个通用的、不那么具體的字符串替换原始的 User-Agent 头部。
1
# 隐藏所有网站的真实 User-Agent
2
. { +hide-user-agent }
3
4
# 但对特定网站恢复真实的 User-Agent，以便其正常显示
5
.site-requiring-real-ua.com { -hide-user-agent }
⑤ +client-header-filter, -client-header-filter: 过滤器名称
▮▮▮▮应用自定义过滤器来修改客户端请求的头部。
⑥ +server-header-filter, -server-header-filter: 过滤器名称
▮▮▮▮应用自定义过滤器来修改服务器响应的头部。
头部修改动作是 Privoxy 隐私保护功能的重要组成部分。
5.4.4 重定向动作 (+redirect)
+redirect 动作用于将匹配到的请求重定向到另一个 URL。这可以用来将广告或追踪请求导向一个本地的空白页面或错误页面，而不是完全阻塞。
① +redirect: 新 URL
▮▮▮▮将匹配到的请求重定向到指定的新 URL。
1
# 将对某个特定广告图片的请求重定向到一个本地的空白图片 (如果配置了)
2
# 这里的 "http://p.p/" 是 Privoxy 内部用于重定向到内置空白页面的特殊地址
3
adserver.com/banner.gif { +redirect: http://p.p/ }
4
5
# 将所有对 example.com 的请求重定向到 google.com (危险操作，仅作示例!)
6
.example.com { +redirect: http://www.google.com/ }
▮▮▮▮使用重定向时要小心，确保重定向到的地址是安全且有效的。Privoxy 内部的 http://p.p/ 通常用于重定向被屏蔽的资源请求，返回一个空白内容，这样可以避免某些网站检测到资源加载失败。
5.4.5 Cookie 控制动作 (+session-cookies, +force-remote-cookies 等)
Cookie 是网站用于跟踪用户、保存会话信息的重要机制。Privoxy 提供了一系列动作来控制 Cookie 的行为，从而增强隐私。
① +session-cookies, -session-cookies
▮▮▮▮+session-cookies 动作会将所有匹配到的网站发送给浏览器的持久 Cookie 转换为会话 Cookie。会话 Cookie 在浏览器关闭时会被删除，而持久 Cookie 则会存储在用户的硬盘上，可以用于长期跟踪。
1
# 将所有网站的持久 Cookie 转换为会话 Cookie (增强隐私)
2
. { +session-cookies }
3
4
# 但允许特定网站设置持久 Cookie (例如，需要记住登录状态的网站)
5
.my-bank.com { -session-cookies }
② +force-remote-cookies, -force-remote-cookies
▮▮▮▮+force-remote-cookies 动作阻止网站设置与其自身域名不符的 Cookie。这有助于阻止第三方跟踪 Cookie。
1
# 强制所有网站只能设置自己的 Cookie，阻止第三方 Cookie
2
. { +force-remote-cookies }
3
4
# 但对特定需要第三方 Cookie 才能正常工作的网站禁用此规则
5
.site-with-share-buttons.com { -force-remote-cookies }
③ +filter: all-cookies
▮▮▮▮这是一个过滤器，可以用来移除所有 Cookie 头部，或者根据更复杂的规则过滤 Cookie。使用这个过滤器通常比简单的 +hide-headers: Cookie 更灵活。
Cookie 控制是 Privoxy 隐私保护的核心功能之一，正确配置可以显著减少被追踪的可能性。
5.4.6 其他高级动作
除了上述常用动作，Privoxy 还提供了许多其他动作，用于更复杂的场景或更精细的控制：
① +limit-connect：限制通过 CONNECT 方法建立连接（主要用于限制 HTTPS 或其他隧道连接）。
② +crunch-whitespace：压缩 HTML 内容中的空白字符以减小传输大小。
③ +fast-redirects：优化 HTTP 重定向的处理速度。
④ +prevent-popups：尝试阻止弹窗脚本。
⑤ +annoyances：一个包含多种消除网页烦人元素的复合动作或过滤器。
这些动作的使用频率可能不如阻塞、过滤或头部修改高，但在特定情况下非常有用。您可以在 Privoxy 的官方文档中找到所有动作的完整列表和详细说明。
本章我们深入探讨了 Privoxy 动作文件的工作原理、基本语法以及各种常用的动作类型。理解这些是构建强大过滤规则的基础。在下一章中，我们将把这些知识付诸实践，通过具体的案例学习如何编写和组织规则，以实现广告和追踪器的屏蔽、隐私增强以及其他定制化目标。
好的，同学们，欢迎来到本书的第六章。在前几章中，我们已经学习了 Privoxy 的基础知识、安装、工作原理以及核心配置文件 privoxy.cfg。现在，我们将把理论付诸实践，深入探讨 Privoxy 最强大的功能之一：构建和应用过滤规则。这就像是给你的网络流量配备了一个智能管家，可以根据你的指示，决定哪些流量可以通过，哪些应该被修改，甚至哪些应该被完全屏蔽。本章的目标是帮助你理解 Privoxy 的过滤引擎是如何工作的，并手把手教你如何编写自己的规则，以实现广告屏蔽、隐私增强和网站行为控制等目标。
6. 第六章：实战应用——构建你的过滤规则
6.1 理解默认动作文件 (default.action)
在我们开始编写自己的规则之前，首先需要了解 Privoxy 自带的默认规则集。这个规则集是 Privoxy 能够开箱即用地提供基本隐私保护和广告过滤功能的基础。
default.action 文件包含了 Privoxy 作者和社区贡献者维护的一系列通用规则，旨在应对常见的在线追踪器、广告网络以及一些已知的隐私侵犯行为。
▮▮▮▮⚝ 文件位置: default.action 文件通常位于 Privoxy 的配置目录中。不同操作系统的位置可能略有差异：
▮▮▮▮▮▮▮▮⚝ Linux/macOS: /etc/privoxy/default.action 或 /usr/local/etc/privoxy/default.action
▮▮▮▮▮▮▮▮⚝ Windows: Privoxy 安装目录下的 config 子目录，例如 C:\Program Files\Privoxy\config\default.action
▮▮▮▮⚝ 文件结构: default.action 文件按照一定的逻辑结构组织，通常包含多个部分。每个部分定义了一组针对特定模式应用的“动作”(actions)。文件的基本语法是：
1
{ +action1 +action2 -action3 ... } pattern
▮▮▮▮▮▮▮▮⚝ { ... }: 大括号内列出要应用的动作列表，动作前面带有 + 表示启用，- 表示禁用。
▮▮▮▮▮▮▮▮⚝ pattern: 这是一个模式匹配规则，用于匹配请求的 URL、域名或其他相关信息。只有当请求匹配这个模式时，花括号内的动作才会被考虑应用。模式匹配语法我们在第五章的 5.3 节已经详细讲解过，可以使用通配符或正则表达式。
▮▮▮▮⚝ 常用规则示例: default.action 中包含各种类型的规则，例如：
▮▮▮▮▮▮▮▮⚝ 屏蔽特定域名或 URL 路径的请求：
1
{ +block } .doubleclick.net/
👆 这条规则会屏蔽所有访问 doubleclick.net 域名下任意路径的请求。
▮▮▮▮▮▮▮▮⚝ 移除或修改 HTTP 头部 (HTTP Headers)：
1
{ +hide-referer{lite} } .*/.*
👆 这条规则（可能在更复杂的条件块中）会移除或精简大多数请求的 Referer 头部，防止泄露用户来源信息。
▮▮▮▮▮▮▮▮⚝ 应用内容过滤器 (Content Filters)：
1
{ +filter{html-annoyances} } .*/.*
👆 这条规则会启用名为 html-annoyances 的内置过滤器，该过滤器会尝试移除 HTML 页面中的一些常见干扰元素（如弹窗脚本）。
重要提示: 虽然 default.action 提供了一个很好的起点，但不建议直接修改这个文件。原因如下：
▮▮▮▮⚝ 软件更新时可能会覆盖你的修改。
▮▮▮▮⚝ 你的修改可能与未来的默认规则产生冲突。
正确的做法是创建或修改 user.action 文件（如果 privoxy.cfg 配置了包含 user.action），或者创建自己的 .action 文件，并在 privoxy.cfg 中使用 actionsfile 指令来包含它。Privoxy 会按照 privoxy.cfg 中列出的顺序加载动作文件，并且后面的规则可以覆盖前面的规则。
通过仔细阅读 default.action，你可以学到很多编写 Privoxy 规则的技巧和常见模式，为构建自己的规则集打下基础。🕵️♀️
6.2 广告和追踪器屏蔽
广告和在线追踪是许多用户使用 Privoxy 的主要原因之一。Privoxy 提供了强大的功能来拦截这些不受欢迎的流量。
我们主要通过两种方式来实现广告和追踪器屏蔽：
① 基于 URL 模式的屏蔽：这是最直接的方式，通过识别广告和追踪器服务器的域名或特定的资源路径，然后使用 +block 动作阻止浏览器与这些地址建立连接或下载资源。
② 基于内容过滤的屏蔽：即使请求没有被完全屏蔽，广告或追踪代码可能仍然包含在页面内容中。通过应用内容过滤器 (+filter 动作)，Privoxy 可以在将页面发送给浏览器之前，修改页面内容（HTML, CSS, JavaScript），移除广告元素或追踪代码。
现在，让我们深入探讨这两种方法。
6.2.1 基于 URL 模式的屏蔽
这种方法依赖于维护一个已知的广告和追踪服务器地址列表，并在 Privoxy 中配置规则来匹配这些地址。
▮▮▮▮⚝ +block 动作: 这是用于屏蔽请求的核心动作。当某个请求的 URL 匹配到一条带有 +block 动作的规则时，Privoxy 会直接返回一个错误页面给浏览器，而不是将请求转发出去。
▮▮▮▮⚝ 编写屏蔽规则: 你可以在 user.action 或你的自定义动作文件中添加如下格式的规则：
1
{ +block } pattern
▮▮▮▮▮▮▮▮⚝ 使用通配符:
1
# 屏蔽所有来自 doubleclick.net 域名的请求
2
{ +block } .doubleclick.net/
3
4
# 屏蔽所有来自 ad.example.com 的请求
5
{ +block } ad.example.com/
6
7
# 屏蔽所有包含 /ads/ 或 /adserver/ 路径的请求
8
{ +block } */ads/*
9
{ +block } */adserver/*
10
11
# 屏蔽特定类型的广告资源文件（例如，图片、脚本）
12
{ +block } *.ad.com/*.gif
13
{ +block } *.tracker.org/*.js
👆 通配符 * 匹配零个或多个任意字符，. 匹配一个任意字符。在域名匹配中，开头的 . 是一个特殊用法，表示匹配该域名及其所有子域名。
▮▮▮▮▮▮▮▮⚝ 使用正则表达式: 对于更复杂的匹配需求，可以使用正则表达式。需要在模式前加上 @ 符号来表示这是一个正则表达式。
1
# 使用正则表达式屏蔽 Google Analytics 的请求
2
{ +block } @\.google-analytics\.com/r/collect
3
4
# 屏蔽所有以 ad 开头或 tracker 结尾的子域名下的任意请求
5
{ +block } @^(ad|.*tracker)\..*
👆 正则表达式提供了极大的灵活性，但也更复杂，需要熟悉正则表达式语法。在 Privoxy 中使用正则表达式时，通常需要对特殊字符进行转义（如 . 需要转义为 \.）。
▮▮▮▮⚝ 获取屏蔽列表: 手动维护一个全面的屏蔽列表是非常困难的。幸运的是，有很多开源项目和社区维护着高质量的广告和追踪器域名列表。你可以找到这些列表，并将其格式转换为 Privoxy 兼容的规则，或者寻找已经转换为 Privoxy 格式的现成规则文件。一些流行的列表包括 EasyList 的一部分（虽然 EasyList 主要用于浏览器扩展，但其数据可以转化）、Fanboy's List 等。许多 Privoxy 用户会导入这些列表的 Privoxy 版本。
示例: 如果你找到了一个域名列表，比如：
1
ads.example.com
2
tracker.anothersite.org
你可以将其转换为 Privoxy 规则：
1
{ +block } ads.example.com/
2
{ +block } tracker.anothersite.org/
或者使用更简洁的模式：
1
{ +block } ads.example.com/ tracker.anothersite.org/
多个模式可以用空格分隔。
将这些规则添加到你的自定义动作文件中，并在 privoxy.cfg 中确保该文件被 actionsfile 指令包含。重启或重新加载 Privoxy 配置后，这些规则就会生效。🚀
6.2.2 基于内容过滤的屏蔽 (+filter)
即使 URL 没有被屏蔽，某些广告或追踪代码可能嵌入在网页的 HTML、CSS 或 JavaScript 内容中。在这种情况下，基于 URL 的屏蔽就无能为力了。这时，Privoxy 的内容过滤功能就派上用场了。
▮▮▮▮⚝ +filter 动作: 这个动作用于告诉 Privoxy 对匹配的请求响应（通常是 HTML 页面）应用一个或多个预定义的内容过滤器。
▮▮▮▮⚝ 内容过滤器 (.filter 文件): 内容过滤器定义了如何在响应体中查找特定模式并替换或删除它们。过滤器规则存储在 .filter 文件中。例如，default.action 可能会通过 { +filter{html-annoyances} } 来调用一个名为 html-annoyances 的过滤器。这个过滤器实际定义在另一个文件（通常是 default.filter 或被包含的文件）中。
▮▮▮▮▮▮▮▮⚝ .filter 文件语法: .filter 文件包含以 FILTER: 开头的行，后面跟着过滤器的名称，然后是查找和替换的规则。
1
FILTER: filter-name
2
3
# 查找模式 (Pattern to find)
4
s@pattern_to_find@replacement_pattern@options
5
6
# 可以有多个查找替换规则
7
s@another_pattern@another_replacement@options
👆 s@...说@...@... 是一个替换指令，灵感来源于 sed 命令。@ 是分隔符，你也可以使用其他字符。pattern_to_find 是要匹配的内容模式（通常是正则表达式），replacement_pattern 是替换后的内容，options 是控制替换行为的标志（如 g 表示全局替换）。
▮▮▮▮▮▮▮▮⚝ 内置过滤器: Privoxy 提供了几个内置的、有用的过滤器，例如：
▮▮▮▮▮▮▮▮❶ html-annoyances: 移除一些常见的 HTML 干扰元素（弹窗、浮动广告等）。
▮▮▮▮▮▮▮▮❷ strip-comments: 移除 HTML 注释。
▮▮▮▮▮▮▮▮❸ refresh-redirects: 将 HTML meta refresh 重定向转换为 HTTP 重定向。
▮▮▮▮⚝ 启用内容过滤: 要使用内容过滤器，你需要在你的动作文件中使用 +filter{filter-name} 动作，并指定要应用的过滤器的名称。
1
# 对所有网站的 HTML 页面应用 html-annoyances 过滤器
2
{ +filter{html-annoyances} }
3
.*/.*
👆 这个规则会对所有 URL 应用 html-annoyances 过滤器。通常会结合文件类型或其他条件来更精确地应用。
1
# 只对 text/html 类型的响应应用过滤器 (更精确的做法，需要结合 Header 匹配，或者依赖 Privoxy 内部逻辑自动判断)
2
# 注意：Privoxy 在匹配 pattern 时主要是看 URL，对响应内容应用 filter 是在请求匹配 pattern 且响应是可过滤类型后进行的。
3
{ +filter{html-annoyances} }
4
.html
👆 这个规则会尝试对 URL 中包含 .html 的请求所返回的响应应用过滤器。更精确的内容类型判断通常是 Privoxy 内部根据 Content-Type 头部进行的。
▮▮▮▮⚝ 编写自定义过滤器: 如果内置过滤器无法满足你的需求，或者你想移除页面上非常特定的元素，你可以编写自己的过滤器。
▮▮▮▮▮▮▮▮⚝ 创建一个新的 .filter 文件（例如 my.filter）。
▮▮▮▮▮▮▮▮⚝ 在文件中定义你的过滤器，使用正则表达式来匹配和替换。
▮▮▮▮▮▮▮▮⚝ 在 privoxy.cfg 中使用 filterfile 指令包含你的过滤器文件。
▮▮▮▮▮▮▮▮⚝ 在动作文件中使用 +filter{你的过滤器名称} 来应用它。
示例: 假设你想移除所有页面中的特定脚本 <script src="http://example.com/annoying.js"></script>。
在 my.filter 中：
1
FILTER: remove-annoying-script
2
s@<script src="http://example\.com/annoying\.js"></script>@@g
👆 这个过滤器名为 remove-annoying-script，它查找 <script src="http://example.com/annoying.js"></script> 这段文本（注意对特殊字符 . 进行转义），并用空字符串替换它（即删除），g 标志表示全局替换（如果页面中出现多次则全部删除）。
在你的动作文件 (例如 user.action) 中：
1
# 对所有网站的 HTML 页面应用自定义过滤器
2
{ +filter{remove-annoying-script} }
3
.*/.*
或者更精确地只在特定网站应用：
1
{ +filter{remove-annoying-script} }
2
.some-website.com/
内容过滤功能非常强大，但也可能影响页面布局或功能。在应用自定义过滤器时，务必进行充分测试。🧪
6.3 增强隐私保护规则
除了屏蔽广告和追踪器，Privoxy 的另一个核心价值在于增强用户的在线隐私。通过修改或删除 HTTP 请求/响应头部，Privoxy 可以阻止网站收集你的敏感信息。
▮▮▮▮⚝ HTTP 头部与隐私: 浏览器在发送 HTTP 请求时，会附带一系列头部信息，例如：
▮▮▮▮▮▮▮▮⚝ User-Agent: 透露你的浏览器类型、操作系统版本等信息，用于浏览器指纹识别。
▮▮▮▮▮▮▮▮⚝ Referer: 透露你从哪个页面链接到当前页面，可能暴露你的浏览历史。
▮▮▮▮▮▮▮▮⚝ Cookie: 包含网站存储在你浏览器上的小段信息，用于用户会话管理或追踪。
▮▮▮▮▮▮▮▮⚝ X-Forwarded-For: 如果你在多层代理后，这个头部可能包含你真实的 IP 地址。
Privoxy 提供了一系列动作来控制这些头部信息。
▮▮▮▮⚝ 常用的隐私增强动作:
▮▮▮▮▮▮▮▮⚝ +hide-headers: 用于移除请求中的指定头部。
1
# 移除 Referer 头部
2
{ +hide-headers{Referer} } .*/.*
3
4
# 移除 User-Agent 头部 (注意：移除 User-Agent 可能导致某些网站显示异常或拒绝服务)
5
{ +hide-headers{User-Agent} } .*/.*
6
7
# 同时移除多个头部
8
{ +hide-headers{Referer,User-Agent} } .*/.*
9
10
# Privoxy 提供了一些预设的隐藏级别，如 lite 或 standard，用于隐藏常见的隐私相关头部
11
{ +hide-referer{lite} } .*/.* # 精简 Referer 头部
12
{ +hide-user-agent{standard} } .*/.* # 使用一个通用的 User-Agent 替换实际的
👆 使用 +hide-headers 直接移除头部，使用 +hide-header{name} 带有级别参数的动作（如 hide-referer, hide-user-agent）则通常是替换为更通用的值，而不是简单移除，以减少对网站兼容性的影响。具体行为取决于 Privoxy 版本和配置。
▮▮▮▮▮▮▮▮⚝ +change-x-forwarded-for: 控制 X-Forwarded-For 头部。
1
# 移除 X-Forwarded-For 头部
2
{ +change-x-forwarded-for{block} } .*/.*
3
4
# 替换为一个固定的伪造值
5
{ +change-x-forwarded-for{forge} } .*/.* # Privoxy 可能将其替换为 127.0.0.1 或其他预设值
6
7
# 允许正常的 X-Forwarded-For 头部（这是默认行为，除非前面有代理添加了这个头部）
8
{ -change-x-forwarded-for } .*/.*
👆 这个动作对于隐藏你的真实 IP 地址（如果在使用多层代理，例如 Privoxy -> Squid -> 互联网）非常重要。
▮▮▮▮▮▮▮▮⚝ Cookie 控制动作:
▮▮▮▮▮▮▮▮❶ +session-cookies: 将持久化 Cookie (Persistent Cookies) 转换为会话 Cookie (Session Cookies)。这意味着当浏览器关闭时，这些 Cookie 会被删除，而不是存储在硬盘上。
1
# 对所有网站应用
2
{ +session-cookies } .*/.*
▮▮▮▮▮▮▮▮❷ +force-remote-cookies: 强制网站使用它们自己的 Cookie，而不是 Privoxy 可能提供的模拟 Cookie。这通常用于解决某些网站的兼容性问题。
1
# 对 example.com 应用此规则
2
{ +force-remote-cookies } .example.com/
▮▮▮▮▮▮▮▮❸ +block-cookies: 完全阻止 Cookie。
1
# 阻止所有网站设置 Cookie
2
{ +block-cookies } .*/.*
👆 阻止所有 Cookie 会导致绝大多数需要登录或维持会话的网站无法正常工作。谨慎使用。
将这些隐私增强规则添加到你的动作文件中，并根据你的需求调整模式匹配，只对需要增强隐私的网站或所有网站应用这些规则。🔒
6.4 控制网站行为
除了屏蔽广告和增强隐私，你还可以利用 Privoxy 的过滤规则来修改或阻止特定的网页元素或脚本的加载，从而改变网站的默认行为，提升浏览体验。
▮▮▮▮⚝ 禁用脚本: 许多网站功能和广告依赖于 JavaScript。你可以通过屏蔽 JavaScript 文件的 URL 或过滤掉 HTML 中的 <script> 标签来禁用特定网站的脚本。
▮▮▮▮▮▮▮▮⚝ 基于 URL 屏蔽脚本:
1
# 屏蔽所有来自 example.com 网站的 .js 文件请求
2
{ +block } .example.com/*.js
3
4
# 屏蔽所有网站中路径包含 /scripts/ 或 /js/ 的 .js 文件请求
5
{ +block } */scripts/*.js
6
{ +block } */js/*.js
👆 注意，过度屏蔽 .js 文件可能会导致网站核心功能失效。
▮▮▮▮▮▮▮▮⚝ 基于内容过滤移除脚本标签:
1
# 这需要一个自定义过滤器来匹配并移除 HTML 中的 <script>...根据情况移除</script> 标签及其内容
2
# 在 .filter 文件中定义一个过滤器
3
FILTER: remove-scripts
4
s@<script\b[^>]*>.*?</script>@@gis
5
6
# 在动作文件中应用这个过滤器
7
{ +filter{remove-scripts} } .example.com/
👆 这个正则表达式 s@<script\b[^>]*>.*?</script>@@gis 会匹配大多数 <script> 标签及其内部内容并删除（s 是替换，@ 是分隔符，g 是全局匹配，i 是不区分大小写，s 是让 . 匹配换行符）。
▮▮▮▮⚝ 屏蔽弹窗: 弹窗通常是通过 JavaScript 或特定的 HTML 元素实现的。内容过滤可以帮助移除这些元素。
▮▮▮▮▮▮▮▮⚝ 移除弹窗 HTML/CSS 元素: 这通常需要分析弹窗的 HTML 结构，然后编写一个自定义过滤器来移除它。例如，如果弹窗是一个带有特定 ID 或类的 <div> 元素：
1
FILTER: remove-popup-div
2
s@<div id="popup-ad" style="[^"]*position:\s*fixed;[^"]*">.*?</div>@@gis
👆 这个例子尝试匹配一个带有 id="popup-ad" 且样式包含 position: fixed; 的 div 元素并移除。实际情况复杂多变，需要具体分析。
▮▮▮▮▮▮▮▮⚝ 屏蔽弹窗脚本: 如果弹窗由一个特定的 JavaScript 文件触发，你可以屏蔽那个脚本文件。
▮▮▮▮⚝ 移除其他烦人元素: 类似的，你可以通过内容过滤来移除网站上的浮动横幅、自动播放视频、订阅提示等元素。这通常是最具挑战性的部分，因为它需要你对网页的结构有一定了解，并能编写精确的正则表达式来匹配和移除目标元素。
技巧:
▮▮▮▮⚝ 使用浏览器的开发者工具 (Developer Tools) 检查页面元素，找到你想要屏蔽的广告、弹窗或烦人元素的 HTML 结构、CSS 类或 ID，以及它们加载的脚本或图片 URL。
▮▮▮▮⚝ 结合使用基于 URL 的屏蔽 (+block) 和基于内容的过滤 (+filter) 来达到最佳效果。
▮▮▮▮⚝ 从简单的规则开始，逐步细化和添加更复杂的规则。
通过精心编写和组合这些规则，你可以大幅提升特定网站的浏览体验。✨
6.5 组织和管理自定义规则
随着你编写的规则越来越多，如何有效地组织和管理它们变得至关重要，这关系到配置的可读性、可维护性以及故障排除的便利性。
▮▮▮▮⚝ 使用 user.action 文件: Privoxy 默认配置通常会包含 user.action 文件。这是存放用户自定义规则的首选位置。将你的所有自定义规则集中放在这个文件中，可以与 default.action 分开，便于管理和升级。
▮▮▮▮⚝ 创建多个动作文件: 对于复杂的规则集或不同的应用场景，你可以创建多个 .action 文件，例如 my-ads.action, my-privacy.action, my-sites.action 等。然后，在 privoxy.cfg 中使用多个 actionsfile 指令来包含它们：
1
# 在 privoxy.cfg 中
2
actionsfile default.action
3
actionsfile user.action
4
actionsfile my-ads.action
5
actionsfile my-privacy.action
6
actionsfile my-sites.action
👆 Privoxy 会按照这些指令的顺序加载动作文件。后面的文件中的规则可以覆盖前面文件中的规则。
▮▮▮▮⚝ 添加详细注释: 在动作文件中使用 # 符号添加注释，解释每条规则的作用、目的或来源。清晰的注释可以帮助你和他人理解规则集。
1
# 屏蔽所有来自已知的第三方追踪器域名的请求 - 来自 Fanboy's Tracking List (部分)
2
{ +block } doubleclick.net/ google-analytics.com/ stats.施行.com/
3
4
# 隐藏 referer 头部，仅对外部链接生效
5
{ +hide-referer{lite} } !.my-website.com/ && .*/.*
▮▮▮▮⚝ 分组规则: 在一个动作文件内部，可以将相关的规则分组，例如按照屏蔽类型（广告、追踪）、网站、或动作类型（屏蔽、过滤、头部修改）进行分组。可以使用注释行或空行来增强可读性。
▮▮▮▮⚝ 规则测试:
▮▮▮▮▮▮▮▮⚝ 使用 Privoxy 的 Web 界面: 如果启用了 Web 界面（通常在 listen-address 中配置），可以通过浏览器访问 http://privoxy/。这里有一个 "Toggle" 页面，可以查看哪些规则对当前的请求生效，这对于调试非常有用。
▮▮▮▮▮▮▮▮⚝ 检查日志文件: 配置适当的日志级别 (loglevel 指令)，可以查看 Privoxy 处理每个请求时应用了哪些规则，这对于找出规则冲突或不生效的原因非常有帮助。
▮▮▮▮⚝ 定期维护: 广告和追踪技术不断变化，你使用的规则列表也需要定期更新。关注你规则来源的社区或项目，及时获取最新的规则文件。同时，定期检查自己的自定义规则，移除不再需要的或已经失效的规则。
▮▮▮▮⚝ 备份: 在进行任何修改之前，养成备份你的 privoxy.cfg、.action 文件和 .filter 文件的习惯。这样在配置出错时，可以轻松恢复到之前的状态。💾
通过良好的组织和管理，你的 Privoxy 规则集将变得易于维护和扩展，能够更持久有效地保护你的隐私和优化你的网络体验。
本章我们深入探讨了 Privoxy 的核心过滤功能，学习了如何利用动作文件和内容过滤器来屏蔽广告、增强隐私和控制网站行为。我们看到了构建自定义规则集的强大之处，同时也强调了规则组织和管理的重要性。在下一章中，我们将进入一些更高级的主题，包括 HTTPS 处理、条件性规则以及如何将 Privoxy 与其他代理（如 Tor）链式连接使用。期待与你一同探索！
第七章：高级主题——HTTPS、条件规则与链式代理
欢迎回到我们的课堂！📚 在前面几个章节中，我们已经扎实地掌握了 Privoxy 的基础知识，包括它的安装、基本配置以及如何使用动作文件（Action Files）进行初步的过滤。现在，我们将进入更高级的领域，探讨 Privoxy 在处理加密流量（HTTPS）、构建复杂过滤逻辑（条件规则）以及与其他代理协同工作（链式代理）方面的能力。这些高级功能将极大地扩展 Privoxy 的应用范围，让你能更精细地控制网络流量，进一步增强隐私保护和灵活性。
7.1 更深入的 HTTPS 处理
在我们对网络流量进行过滤和控制时，不得不面对一个日益普遍的挑战：HTTPS。与明文传输的 HTTP 不同，HTTPS 流量在客户端和服务器之间是加密的，这使得像 Privoxy 这样的中间代理无法直接查看和修改其内容。理解 Privoxy 如何处理 HTTPS，以及它在这种加密环境下的能力与局限性，对于充分利用 Privoxy 至关重要。
7.1.1 forward-ssl-over-http 指令的应用
我们知道，当浏览器通过 HTTP 代理访问 HTTPS 网站时，它并不会直接将加密的 HTTPS 请求发送给代理。相反，它会先向代理发送一个特殊的 HTTP CONNECT 请求，请求代理在浏览器和目标 HTTPS 服务器之间建立一个 TCP 隧道（Tunnel）。一旦隧道建立成功，浏览器就会通过这个隧道发送加密的 HTTPS 数据。Privoxy 默认处理 CONNECT 请求，简单地在客户端和目标服务器之间建立连接并转发后续的加密流量，它并不会解密或检查这些流量的内容。
然而，在某些特定且不常见的网络环境中，你可能需要将这个用于建立 HTTPS 连接的 CONNECT 请求本身，通过另一个 HTTP 代理 进行转发，而不是直接连接目标服务器。这听起来有点绕，但想象一下这样的场景：你的网络环境只允许通过一个固定的 HTTP 代理（比如公司内部的认证代理）访问外部网络，即使是建立 HTTPS 连接所需的 CONNECT 请求也必须经过它。
这时，forward-ssl-over-http 指令就派上用场了。这个指令用于告诉 Privoxy，当遇到 CONNECT 请求（通常用于 HTTPS 或其他需要隧道的情况）时，不要直接尝试连接目标服务器，而是将这个 CONNECT 请求发送给另一个指定的 HTTP 代理。
① 指令格式：
1
forward-ssl-over-http <代理地址>:<代理端口>
② 应用场景举例：
如果你需要通过地址为 192.168.1.100，端口为 8080 的另一个 HTTP 代理来建立所有的 HTTPS 连接隧道，你可以在 privoxy.cfg 中添加：
1
forward-ssl-over-http 192.168.1.100:8080
③ 注意事项：
▮▮▮▮⚝ 这个指令只影响 CONNECT 请求的处理方式，它并不会让 Privoxy 能够查看或修改加密的 HTTPS 流量内容。
▮▮▮▮⚝ 这是一种特殊的配置，只在需要将 CONNECT 请求通过另一个 HTTP 代理转发时才使用。大多数情况下，Privoxy 直接处理 CONNECT 请求是更常见和简单的做法。
▮▮▮▮⚝ 滥用此指令或配置不当可能会导致连接失败或引入额外的延迟。
7.1.2 与 SSL 拦截代理（SSL Interception Proxy）的集成（如有必要）
正如前面提到的，Privoxy 默认不对 HTTPS 流量进行解密。这意味着它无法基于 HTTPS 连接内部的 URL 路径、请求头或响应内容进行过滤和修改。这限制了 Privoxy 在 HTTPS 网站上的广告屏蔽、内容过滤等能力。
要实现对 HTTPS 内容的深度过滤，需要一个能够执行 SSL/TLS 拦截（SSL/TLS Interception），也被称为 中间人攻击（Man-in-the-Middle Attack） 的代理。这种代理工作原理如下：
① 当浏览器请求访问 HTTPS 网站时，拦截代理会截获 CONNECT 请求。
② 拦截代理会伪造一个该网站的 SSL 证书（通常需要用户在浏览器或系统信任该代理的根证书）。
③ 浏览器与拦截代理建立 SSL 连接，但浏览器实际上是与拦截代理而不是真正的网站服务器通信。
④ 拦截代理与真正的网站服务器建立另一个 SSL 连接。
⑤ 拦截代理负责在两个 SSL 连接之间传递数据，但在传递前，它可以解密从浏览器来的数据，检查和修改内容，然后再用自己的证书加密发回浏览器，或者解密从服务器来的数据，检查和修改，再加密发往浏览器。
Privoxy 本身 不具备 SSL 拦截解密的功能。这是出于设计上的考虑，因为 SSL 拦截涉及到安全和信任问题。进行 SSL 拦截需要生成伪造证书，并在客户端（通常是浏览器）中安装和信任代理的根证书。这绕过了 SSL 的安全机制，虽然在某些受控环境（如企业内部网络安全监控）中使用，但在普通用户环境中默认启用会引入安全风险和隐私问题。
📘 集成可能性与考虑：
虽然 Privoxy 自己不做 SSL 拦截，但在理论上，你可以将 Privoxy 与一个具备 SSL 拦截功能的代理 串联 使用。例如：
浏览器 -> Privoxy -> SSL 拦截代理 -> 互联网
在这种链式配置中，Privoxy 接收浏览器请求，对其进行 HTTP 层的过滤（比如修改非加密的 HTTP 头，或者根据 CONNECT 请求的目标地址进行初步阻塞），然后将请求（包括 CONNECT 请求）转发给 SSL 拦截代理。SSL 拦截代理会接管后续的处理，进行 SSL 解密、内容检查、重新加密，最后发送到互联网。
然而，这种集成是复杂的，并且需要仔细权衡。
▮▮▮▮⚝ 优势： 可以在 HTTPS 流量上应用更细粒度的过滤规则（由 SSL 拦截代理完成），而 Privoxy 仍然可以处理 HTTP 流量并执行其独特的头部修改等功能。
▮▮▮▮⚝ 缺点与风险：
▮▮▮▮▮▮▮▮⚝ 复杂性： 配置和维护两条代理链增加了复杂性。
▮▮▮▮▮▮▮▮⚝ 性能： SSL 加密和解密是计算密集型操作，链式代理会增加延迟。
▮▮▮▮▮▮▮▮⚝ 安全与信任： 核心问题在于你需要完全信任那个执行 SSL 拦截的代理。它可以看到并可能修改你所有的加密通信内容。如果 SSL 拦截代理的根证书或私钥泄露，将带来严重的安全风险。
▮▮▮▮▮▮▮▮⚝ 证书管理： 需要在所有使用该代理的客户端上安装和信任 SSL 拦截代理的根证书。
因此，通常情况下，如果你主要依赖 Privoxy 来进行广告和追踪屏蔽以及 HTTP 头部修改，并且可以接受其在 HTTPS 内容过滤上的局限性（例如，只能基于域名或 IP 阻塞，无法修改 HTTPS 网页内的元素），那么不需要集成 SSL 拦截代理。如果你确实需要在 HTTPS 内容级别进行过滤，你可能需要寻找一个专门设计用于此目的且你信任的解决方案，这可能意味着选择一个不同的代理或安全产品，而不是强行将 Privoxy 与 SSL 拦截结合。
7.2 条件性规则（.action 中的 {} 语法）
在前面的章节中，我们看到的动作规则通常是这样的：
1
{ +block }
2
.doubleclick.net
这意味着对于所有匹配 .doubleclick.net 模式的 URL，都执行 +block 动作。这是简单的“如果模式匹配，则执行动作”逻辑。
然而，有时我们需要更复杂的逻辑，例如：“如果请求来自特定的 IP 地址 并且 访问某个域名，则执行某个动作”；或者“如果请求头部包含特定的 User-Agent 并且 访问某个页面，则执行动作”。为了实现这种基于多个条件的过滤，Privoxy 提供了 条件性规则（Conditional Rules） 的语法，使用大括号 {} 将条件和动作组合起来。
📘 语法格式：
条件性规则的基本语法是：
1
{ <动作列表> }
2
[ <条件表达式1> ]
3
[ <条件表达式2> ]
4
...
5
<模式匹配>
① 动作列表 ({ <动作列表> })：
这部分包含要应用的动作列表，与普通规则中的动作列表相同，用空格分隔。例如 { +block +hide-referer }。
② 条件表达式 ([ <条件表达式> ])：
这部分是一个或多个条件表达式，每个表达式必须放在独立的方括号 [] 中。只有当所有条件表达式都评估为真时，规则才会被应用到后续匹配的 URL 上。 Privoxy 支持多种类型的条件表达式：
⚝ 按客户端 IP 匹配 ([ -i <IP 地址或网络掩码> ])：
[ -i 192.168.1.100 ]：只对来自 IP 192.168.1.100 的请求应用此规则。
[ -i 192.168.1.0/24 ]：只对来自 192.168.1.0 网络（掩码 24 位）的请求应用此规则。
可以在前面加感叹号 ! 表示取反，例如 [ ! -i 127.0.0.1 ] 表示不是来自本地主机的请求。
⚝ 按请求头部匹配 ([ -h <头部名称>:<匹配模式> ])：
[ -h User-Agent:.*Chrome.* ]：只对 User-Agent 头部包含 "Chrome" 的请求应用此规则。
[ -h Referer:^https?://evil\.com/ ]：只对 Referer 头部以 http://evil.com/ 或 https://evil.com/ 开头的请求应用此规则。
同样支持 ! 取反。
⚝ 按请求方法匹配 ([ -m <方法> ])：
[ -m POST ]：只对 HTTP POST 请求应用此规则。
[ -m GET | HEAD ]：只对 HTTP GET 或 HEAD 请求应用此规则（使用 | 分隔多种方法）。
同样支持 ! 取反。
⚝ 按 URL 组件匹配： Privoxy 提供了 $request{} 和 $response{} 这样的“变量”来引用请求或响应的特定部分进行匹配。这通常结合 . /pattern/ 部分使用，但也可以用于条件中（虽然不常见）。例如 $request{host}、$request{url}、$request{header}、$request{body}` 等。
③ 模式匹配 (<模式匹配>)：
这部分与普通规则相同，是用于匹配 URL 或其他目标的模式（如域名、路径等），例如 .doubleclick.net 或 /ads/.*\.gif/i。
只有当所有的 [ <条件表达式> ] 都为真，并且最下方的 <模式匹配> 也匹配成功时，{ <动作列表> } 中的动作才会被执行。
📘 条件性规则示例：
示例 1：只屏蔽来自特定 IP 的广告域名
假设你只想阻止家庭网络中某个特定设备（IP 为 192.168.1.105）访问广告域名，而其他设备不受影响。
1
{ +block }
2
[ -i 192.168.1.105 ] # 条件：客户端 IP 是 192.168.1.105
3
.doubleclick.net # 模式：访问 doubleclick.net 域名
4
.googlesyndication.com
此规则会检查请求是否来自 192.168.1.105，如果是，再检查访问的域名是否是 doubleclick.net 或 googlesyndication.com，两者都满足才会阻塞。
示例 2：根据 User-Agent 对特定网站应用不同规则
假设你想对所有非移动设备（即 User-Agent 不包含 "Mobi" 或 "Android" 或 "iOS"）访问 example.com 时移除 Referer 头部，以增强桌面浏览器的隐私。
1
{ +hide-referer }
2
[ ! -h User-Agent:.*Mobi.* ] # 条件1：User-Agent 不包含 Mobi
3
[ ! -h User-Agent:.*Android.* ] # 条件2：User-Agent 不包含 Android
4
[ ! -h User-Agent:.*iOS.* ] # 条件3：User-Agent 不包含 iOS
5
.example.com # 模式：访问 example.com 域名
只有当 User-Agent 不包含列出的任何移动标识，并且访问的是 example.com 时，Referer 头部才会被移除。
示例 3：阻止 POST 请求到特定路径
假设你想阻止所有发送到 /login 路径的 POST 请求，可能是为了防止未经授权的自动提交。
1
{ +block }
2
[ -m POST ] # 条件：请求方法是 POST
3
/login # 模式：访问路径是 /login (注意：模式匹配默认是针对 URL 的，这里简化表示路径匹配)
此规则会检查请求方法是否是 POST，如果是，再检查 URL 是否匹配 /login 模式，两者都满足才会阻塞。
📘 注意事项：
▮▮▮▮⚝ 条件表达式是可选的，但如果使用了，必须放在方括号 [] 中。
▮▮▮▮⚝ 如果有多个条件表达式，它们之间是逻辑 AND 的关系，即所有条件都必须满足。
▮▮▮▮⚝ 条件性规则的优先级遵循一般的规则处理顺序。在同一个动作文件中，从上到下处理，后匹配的规则可能会覆盖先匹配的规则（取决于动作类型）。
▮▮▮▮⚝ 条件性规则增加了灵活性，但也可能使配置变得复杂，需要仔细组织和测试。
掌握条件性规则，你可以构建出更加精细和智能的过滤策略，让 Privoxy 的控制能力更上一层楼。
7.3 链式代理设置（Chaining Proxies）
将一个代理的流量转发给另一个代理进行进一步处理，这就是 链式代理（Chaining Proxies）。Privoxy 可以很方便地配置为链式代理中的一环，将接收到的客户端请求转发给上游（Upstream）代理。这在需要结合不同代理的功能、增强匿名性或绕过特定网络限制时非常有用。
Privoxy 主要通过 forward 和 forward-socks 这两个指令来实现链式代理。
7.3.1 配置 forward 指令到其他 HTTP 代理
forward 指令用于将特定模式匹配的请求转发给另一个 HTTP 代理 或直接连接到原始服务器。
① 指令格式：
1
forward <模式> <目标地址>:<目标端口>
或用于直接连接：
1
forward <模式> .
② 参数说明：
▮▮▮▮⚝ <模式>：这是一个模式匹配字符串，只有匹配这个模式的 URL/域名才会通过这个 forward 指令进行转发。模式可以使用 .action 文件中的相同语法。如果使用 / 作为模式，表示匹配所有请求。
▮▮▮▮⚝ <目标地址>:<目标端口>：这是上游 HTTP 代理的 IP 地址和端口号。
▮▮▮▮⚝ .：如果使用点 . 代替目标地址和端口，表示对于匹配该模式的请求，Privoxy 不转发给其他代理，而是直接尝试连接到原始服务器。这常用于覆盖之前的 forward 规则，或者指定某些请求不走代理链。
③ 应用场景举例：
⚝ 将所有请求转发给上游 HTTP 代理：
1
forward / 192.168.1.200:8080
这条规则会将所有通过 Privoxy 的请求都转发给位于 192.168.1.200:8080 的 HTTP 代理。这是一种常见的用法，例如将 Privoxy 的过滤功能与另一个HTTP代理（如 Squid 用于缓存或认证）结合使用。浏览器配置 Privoxy 为代理，Privoxy 再将请求发给 Squid，Squid 处理后再发到互联网。
⚝ 将特定域名的请求直接连接（绕过上游代理）：
假设你配置了将所有请求转发给上游代理，但希望访问 internal.mycompany.com 时直接连接，不经过上游代理。
1
forward / 192.168.1.200:8080 # 所有请求转发到上游代理
2
forward .internal.mycompany.com . # 匹配 internal.mycompany.com 的请求直接连接
Privoxy 按顺序处理 forward 规则。先匹配到 .internal.mycompany.com 的请求会被第二条规则捕获，并指定为直接连接（.）。其他不匹配该域名的请求则会继续匹配下一条 / 规则，被转发到上游代理。
⚝ 将某些请求转发到不同的 HTTP 代理：
你可以根据不同的模式将请求转发到不同的上游代理。
1
forward .work-related.com 10.0.0.1:8080 # 工作相关的走工作代理
2
forward / 192.168.1.200:8080 # 其他所有请求走默认上游代理
3
4
5
```
6
7
④ 注意事项：
8
▮▮▮▮⚝ `forward` 指令只影响匹配到的请求。
9
▮▮▮▮⚝ 规则的处理顺序很重要，更具体的模式应该放在前面，否则可能会被更宽泛的模式（如 `/`）提前捕获。
10
▮▮▮▮⚝ `forward` 指令会覆盖通过 `listen-address` 接收到的请求的默认处理（即默认是直接连接）。
11
12
#### 7.3.2 配置 `forward-socks` 指令到 SOCKS 代理（如 Tor）
13
14
`forward-socks` 指令用于将特定模式匹配的请求转发给一个 **SOCKS 代理（SOCKS Proxy）**。SOCKS 是一种更底层的代理协议，它不关心应用层协议（如 HTTP），只负责在客户端和目标服务器之间转发 TCP 连接数据包。这使得 SOCKS 代理可以用于代理任何基于 TCP 的流量，包括 HTTPS、FTP 等。
15
16
最常见的 SOCKS 代理用例是将 Privoxy 与 Tor 网络结合使用。Tor 提供一个 SOCKS 代理接口（通常在 `127.0.0.1:9050` 或 `127.0.0.1:9150`），通过它发送的流量会经过 Tor 网络进行匿名化。
17
18
① 指令格式：
19
20
21
```privoxy
22
forward-socks <模式> <目标地址>:<目标端口>
或用于直接连接（覆盖 SOCKS 转发）：
1
forward-socks <模式> .
② 参数说明：
▮▮▮▮⚝ <模式>：同样是模式匹配字符串，匹配的请求将通过指定的 SOCKS 代理转发。/ 表示匹配所有请求。
▮▮▮▮⚝ <目标地址>:<目标端口>：这是上游 SOCKS 代理的 IP 地址和端口号。
▮▮▮▮⚝ .：指定匹配的请求不通过 SOCKS 代理，而是直接连接到原始服务器。
③ 应用场景举例：
⚝ 将所有请求通过本地 Tor SOCKS 代理转发：
这是将 Privoxy 与 Tor 集成以获得匿名性和过滤能力的经典配置。Privoxy 负责过滤、修改 HTTP 头等，然后将处理后的请求通过 Tor 发送。
1
forward-socks / 127.0.0.1:9050 # 假设 Tor SOCKS 代理运行在本地 9050 端口
配置后，所有通过 Privoxy 的 HTTP 和 HTTPS 请求都会被 Privoxy 处理规则后，通过本地的 Tor SOCKS 代理发送出去。
⚝ 某些域名不通过 Tor 代理：
你可能希望访问本地或受信任的内部资源时绕过 Tor 代理，以提高速度或兼容性。
1
forward-socks .internal.network . # 匹配 .internal.network 的请求直接连接
2
forward-socks / 127.0.0.1:9050 # 其他所有请求通过 Tor SOCKS 代理
这里，.internal.network 域名下的请求会因为第一条规则而被指定为直接连接（.），不经过 SOCKS 代理。
④ 注意事项：
▮▮▮▮⚝ forward-socks 指令会指示 Privoxy 使用 SOCKS 协议连接上游代理，而不是 HTTP 协议。确保你指定的上游代理确实是一个 SOCKS 代理。
▮▮▮▮⚝ Privoxy 支持 SOCKSv4 和 SOCKSv5。
▮▮▮▮⚝ 与 forward 指令类似，规则顺序很重要。
▮▮▮▮⚝ 使用 forward-socks 到 Tor 可以增强匿名性，但请注意，Tor 本身并不完美，且 Privoxy 默认无法过滤 HTTPS 内容，这可能会泄露一些信息（例如你正在访问 github.com，虽然具体看了什么代码是加密的）。
7.3.3 链式代理的优势与注意事项
📘 链式代理的优势：
① 功能叠加： 可以结合不同代理的优点。例如，Privoxy 的强大过滤和头部修改能力，加上 Tor 的匿名性，或者加上 Squid 的缓存能力。
② 增强匿名性/隐私： 将流量通过多个代理转发，使得追踪源头更加困难（尽管并非不可能）。
③ 绕过限制： 可以通过链中的某个代理绕过特定的网络防火墙或地理位置限制。
④ 灵活路由： 可以根据不同的目的地将流量导向不同的上游代理。
📘 链式代理的注意事项与挑战：
① 性能开销： 每个代理都会引入额外的延迟和处理开销。代理链越长，速度通常越慢。加密/解密操作（如 HTTPS）在链中涉及更多步骤时性能影响更大。
② 配置复杂性： 需要正确配置链中的每一个代理，确保它们能够正确接收和转发流量。一个环节出错可能导致整个链失效。
③ 故障排除困难： 当出现问题时，难以确定是链中的哪个代理或哪个环节配置错误。日志分析需要更全面。
④ 信任问题： 你需要信任链中的每一个代理。如果链中的某个代理被控制或存在恶意行为，你的流量可能会被监控或篡改。这在追求匿名性时尤为重要，确保你信任链中的所有节点，尤其是末端出口节点（对于 Tor 而言）。
⑤ 潜在的泄露风险： 即使使用了链式代理，如果配置不当（例如 DNS 请求处理、某些应用绕过代理）或者上层协议（如 HTTPS）没有得到妥善处理，仍可能存在信息泄露的风险。
总的来说，链式代理是 Privoxy 的一项强大高级功能，它为你提供了极大的灵活性来定制你的网络访问方式。但在享受其带来的便利和能力的同时，也要充分理解其复杂性、性能影响以及潜在的安全和隐私风险，并进行仔细的配置和测试。
7.4 自定义过滤器（Custom Filters）
除了通过动作文件（.action）中的 +block 阻止整个请求或 +filter 启用预设或自定义过滤器外，Privoxy 还允许你定义自己的 内容过滤器（Content Filters）。这些过滤器位于独立的文件中（通常以 .filter 为扩展名），用于在 HTTP 响应到达浏览器之前，对网页的 HTML 或其他文本内容进行搜索和替换。这使得你可以更精细地修改网页内容，例如移除特定的脚本、HTML 元素或文本字符串。
📘 过滤器文件的工作机制：
① 当 Privoxy 接收到 HTTP 响应时，如果响应内容类型是可过滤的（通常是文本类型，如 text/html, text/css, application/javascript 等），并且有规则启用了内容过滤（通常通过 +filter 动作），Privoxy 就会查找相应的过滤器。
② 过滤器文件中的规则会被应用于响应的内容上。
③ 规则通常是基于正则表达式的搜索和替换操作。
④ 修改后的内容再发送给客户端（浏览器）。
📘 过滤器文件（.filter）的基本语法：
过滤器文件由一个或多个过滤器定义组成。每个过滤器定义以 :FILTER: <过滤器名称> <描述> 开头，后面跟着一系列搜索和替换规则。
1
AlBeRt63EiNsTeIn <过滤器名称> <描述>
2
s@<搜索模式>@<替换模式>@<标记>
3
s@<搜索模式>@<替换模式>@<标记>
4
...
① :FILTER: <过滤器名称> <描述>：
▮▮▮▮⚝ :FILTER:：关键字，标记一个新过滤器的开始。
▮▮▮▮⚝ <过滤器名称>：这个过滤器的唯一名称，用于在 .action 文件中通过 +filter <过滤器名称> 引用它。名称不能包含空格或特殊字符。
▮▮▮▮⚝ <描述>：对该过滤器的简要描述（可选）。
② s@<搜索模式>@<替换模式>@<标记>：
▮▮▮▮⚝ s：表示这是一个搜索和替换操作。
▮▮▮▮⚝ @：分隔符。你可以使用除了字母、数字、空格以外的任何字符作为分隔符，但 @ 是最常见的。
▮▮▮▮⚝ <搜索模式>：一个正则表达式，用于匹配需要在响应内容中查找的内容。
▮▮▮▮⚝ <替换模式>：用于替换匹配到的搜索模式内容的字符串。可以是空字符串（用于删除匹配内容），也可以包含捕获组 (\1, \2 等) 来重组文本。
▮▮▮▮⚝ <标记>：可选的标志，用于修改匹配行为。常用标志包括：
▮▮▮▮▮▮▮▮⚝ g：全局匹配（Global），替换所有匹配项，而不是只替换第一个。
▮▮▮▮▮▮▮▮⚝ i：忽略大小写（Case-insensitive）。
▮▮▮▮▮▮▮▮⚝ s：使 . 匹配包括换行符在内的所有字符（Single line mode）。
▮▮▮▮▮▮▮▮⚝ m：多行模式（Multi-line），使 ^ 和 $ 匹配行的开头和结尾，而不仅仅是整个字符串的开头和结尾。
📘 过滤器文件示例：
假设你想创建一个过滤器，移除网页中所有 <iframe> 标签，因为它们有时用于广告或追踪。
首先，创建一个过滤器文件，例如 my_filters.filter：
1
AlBeRt63EiNsTeIn remove-iframes Remove all iframe tags
2
3
# 移除 <iframe ...>...</iframe> 及其内容
4
s@<iframe\b[^>]*>.*?</iframe>@@gis
⚝ :FILTER: remove-iframes Remove all iframe tags 定义了一个名为 remove-iframes 的过滤器。
⚝ s@...@@gis 是搜索替换规则：
▮▮▮▮⚝ s 表示替换操作。
▮▮▮▮⚝ @ 是分隔符。
▮▮▮▮⚝ <iframe\b[^>]*>：匹配 <iframe，后面跟着一个单词边界 \b（确保不是其他标签的一部分），然后是零个或多个非 > 字符 [^>]*（匹配属性），最后是 >。
▮▮▮▮⚝ .*?：非贪婪地匹配任意字符（包括换行，因为使用了 s 标志），直到遇到下一个模式。
▮▮▮▮⚝ </iframe>：匹配闭合标签 </iframe>。
▮▮▮▮⚝ @@：替换内容为空，即删除匹配到的整个 <iframe> 及其内容。
▮▮▮▮⚝ gis：标志，g 全局替换，i 忽略大小写，s 使 . 匹配换行符。
然后，在你的 .action 文件中（例如 user.action），使用 +filter 动作引用这个过滤器，并指定它应用于哪些网站。例如，应用于所有网站：
1
{ +filter{remove-iframes} }
2
/
这条规则表示对所有通过 Privoxy 的请求（/ 模式匹配所有），如果响应内容是可过滤的，则应用名为 remove-iframes 的自定义过滤器。
📘 使用自定义过滤器的步骤：
① 编写或获取 .filter 文件，定义一个或多个自定义过滤器。
② 将 .filter 文件保存在 Privoxy 配置目录下（与 privoxy.cfg 和 .action 文件通常在同一目录）。
③ 在 privoxy.cfg 中，确保使用 actionsfile 指令包含了你的 .action 文件，并且 .action 文件中包含了对 .filter 文件的引用（使用 +filter{过滤器名称}）。Privoxy 会自动加载同目录下的 .filter 文件中定义的过滤器。
④ 重启或重新加载 Privoxy 配置。
📘 注意事项：
▮▮▮▮⚝ 内容过滤只对未加密的 HTTP 响应有效。对于 HTTPS 流量，Privoxy 无法查看内容，因此自定义过滤器无法直接应用于 HTTPS 页面内容。
▮▮▮▮⚝ 正则表达式可能很复杂，编写不当可能导致性能问题或意外的页面显示错误。
▮▮▮▮⚝ 大多数广告和追踪屏蔽现在更多地依赖于阻塞请求（+block）和基于 CSS/JavaScript 的隐藏规则（这些通常由浏览器扩展完成，而 Privoxy 主要工作在网络层）。内容过滤器在修改特定页面结构或移除嵌入式内容方面仍有其用途。
自定义过滤器提供了一种强大的方式来根据你的需求精确地修改网页内容，尤其适用于处理那些不能简单通过阻塞请求解决的问题。结合动作文件中的模式匹配和条件规则，你可以构建出非常灵活和强大的内容处理管道。
第八章：维护与故障排除
欢迎来到本书的第八章！学习一个强大的工具，安装和配置只是第一步，随后的日常维护和故障排除能力同样至关重要。本章将以实践为导向，帮助您掌握诊断和解决 Privoxy 运行中遇到的各种问题，确保您的隐私保护和流量控制系统稳定可靠。我们将深入探讨 Privoxy 的日志系统，分析常见错误，学习如何调试规则冲突，并提供性能优化的宝贵建议。掌握这些技能，您就能从容应对 Privoxy 在复杂网络环境中的挑战。
8.1 理解 Privoxy 的日志
日志是任何软件排查问题的生命线，Privoxy 也不例外。通过分析 Privoxy 输出的日志信息，我们可以了解其处理请求的过程、规则的应用情况以及潜在的错误。理解并善于利用日志，是高效维护 Privoxy 的关键。
首先，我们需要知道如何配置 Privoxy 的日志。这主要通过 privoxy.cfg 文件中的几个指令来实现：
⚝ logfile <文件名>: 指定日志文件的路径。如果不设置或设置为 /dev/null (Linux/macOS) 或 NUL (Windows)，日志将输出到标准错误流（通常是终端或系统日志）。指定文件是更好的实践，便于长期保存和分析。
⚝ loglevel <级别>: 控制日志输出的详细程度。Privoxy 支持多个日志级别，从最不详细到最详细通常是：
▮▮▮▮⚝ 0: 关闭日志（不推荐）。
▮▮▮▮⚝ 1: 只记录严重错误。
▮▮▮▮⚝ 2: 记录所有错误。
▮▮▮▮⚝ 4: 记录警告信息。
▮▮▮▮⚝ 8: 记录请求处理过程中的重要事件，例如连接建立、文件加载错误等。
▮▮▮▮⚝ 16: 记录对每个请求应用的动作（Action），这是调试规则最常用的级别。
▮▮▮▮⚝ 32: 记录更详细的请求信息，如头部（Header）。
▮▮▮▮⚝ 64: 记录内容过滤（Content Filtering）的详细过程。
▮▮▮▮⚝ 128: 记录内部调试信息（通常只对开发者有用）。
日志级别是累加的。例如，设置 loglevel 10 (= 2 + 8) 将同时记录错误和重要事件。对于日常维护，建议使用 loglevel 8 或 loglevel 16。对于规则调试，loglevel 16 是最低要求，有时需要结合 32 或 64。
接下来，我们来看看日志中常见的条目及其含义：
① 连接建立与关闭:
▮▮▮▮通常会看到类似这样的日志：
▮▮▮▮Connection: client IP:port <-> Privoxy IP:port
▮▮▮▮Connection closed by client 或 Connection closed by server
▮▮▮▮这表示一个客户端连接建立以及何时关闭。如果看到大量连接频繁断开，可能表明客户端配置有问题或网络不稳定。
② 请求处理:
▮▮▮▮这是日志中最常见的类型，记录了 Privoxy 接收到的 HTTP/HTTPS 请求。
▮▮▮▮Request: GET http://example.com/path
▮▮▮▮Request: CONNECT example.com:443
▮▮▮▮对于 HTTPS 请求，Privoxy 会先看到一个 CONNECT 请求。如果您的浏览器配置正确，且 Privoxy 允许连接，它会转发这个请求并在客户端和目标服务器之间建立一个隧道（Tunnel）。
③ 动作应用:
▮▮▮▮当 loglevel 至少为 16 时，您会看到 Privoxy 对每个请求应用了哪些动作。
▮▮▮▮Applying actions to http://example.com/...:
▮▮▮▮+block （表示请求被阻塞）
▮▮▮▮-filter （表示某个过滤器被禁用）
▮▮▮▮+hide-user-agent （表示 User-Agent 头部被修改）
▮▮▮▮这些日志条目对于理解 Privoxy 规则的实际效果至关重要。如果您发现某个页面没有被过滤或不该被阻塞却被阻塞了，查看这里的日志就能定位问题。
④ 错误和警告:
▮▮▮▮Error: Could not bind to address 127.0.0.1:8118 （端口被占用）
▮▮▮▮Warning: Failed to parse rule line: ... （配置文件或动作文件语法错误）
▮▮▮▮这些信息通常表明配置或运行时出现了问题，需要优先处理。
如何分析日志:
⚝ 从后向前看: 最新发生的事件通常在日志文件的末尾。
⚝ 查找错误和警告: 优先解决明确指示问题的 Error 或 Warning 条目。
⚝ 追踪特定请求: 如果某个网站访问有问题，找到对应时间的请求条目，然后向下查看 Privoxy 对该请求应用了哪些动作以及后续的处理过程。
⚝ 使用工具: 对于大型日志文件，可以使用 grep (Linux/macOS) 或文本编辑器/日志分析工具来搜索特定模式（如 URL、IP 地址、错误关键词）。
总之，把日志视为 Privoxy 的“内心独白”，通过仔细阅读，您就能更好地理解它的行为，并快速定位问题所在。
8.2 常见错误与解决方法
在使用 Privoxy 的过程中，可能会遇到一些常见问题。本节将列举这些问题并提供详细的排查步骤和解决方法。
① Privoxy 无法启动:
▮▮▮▮ⓑ 错误现象: 尝试启动 Privoxy 服务时失败，通常会有错误提示信息。
▮▮▮▮ⓒ 可能原因:
▮▮▮▮▮▮▮▮❹ 配置文件 privoxy.cfg 存在语法错误。
▮▮▮▮▮▮▮▮❺ 监听的端口（默认 8118）已经被其他程序占用。
▮▮▮▮▮▮▮▮❻ 没有足够的权限绑定到指定的监听地址或打开日志文件。
▮▮▮▮▮▮▮▮❼ 安装不完整或文件损坏。
▮▮▮▮ⓗ 解决方法:
▮▮▮▮▮▮▮▮❾ 检查 Privoxy 的启动日志输出（如果配置了日志文件，查看日志文件；否则查看终端或系统日志）。错误信息通常会指示问题所在，例如指出配置文件中的哪一行有问题。使用配置检查工具（如果 Privoxy 提供了）或手动检查配置文件语法。
▮▮▮▮▮▮▮▮❿ 使用工具（如 netstat -tulnp 在 Linux，netstat -ano 在 Windows，lsof -i :端口号 在 macOS）检查端口是否被占用。如果是，停止占用该端口的程序，或者修改 privoxy.cfg 中的 listen-address 指令，更换一个未被占用的端口。
▮▮▮▮▮▮▮▮❸ 确保运行 Privoxy 的用户有权限访问配置文件、日志文件以及绑定指定的网络接口和端口。在 Linux/macOS 上，非 root 用户可能无法绑定 1024 以下的端口。
▮▮▮▮▮▮▮▮❹ 尝试重新安装 Privoxy。
② 浏览器或其他应用无法连接 Privoxy:
▮▮▮▮ⓑ 错误现象: 在浏览器或其他应用中配置 Privoxy 代理后，无法访问网页或出现连接超时错误。
▮▮▮▮ⓒ 可能原因:
▮▮▮▮▮▮▮▮❹ 客户端代理设置错误（IP地址、端口号）。
▮▮▮▮▮▮▮▮❺ Privoxy 服务没有运行。
▮▮▮▮▮▮▮▮❻ 防火墙阻止了客户端到 Privoxy 服务器 IP:Port 的连接。
▮▮▮▮▮▮▮▮❼ Privoxy 配置了访问控制（permit/deny），禁止了客户端 IP 的访问。
▮▮▮▮ⓗ 解决方法:
▮▮▮▮▮▮▮▮❾ 仔细检查浏览器或其他应用的代理设置，确保 IP 地址和端口与 Privoxy 监听的地址和端口完全一致。注意是 HTTP 代理设置，而不是 SOCKS 代理。
▮▮▮▮▮▮▮▮❿ 确认 Privoxy 服务正在正常运行。在 Windows 上检查服务列表，在 Linux/macOS 上使用 systemctl status privoxy 或 service privoxy status 等命令。
▮▮▮▮▮▮▮▮❸ 检查客户端和 Privoxy 服务器上的防火墙设置，确保允许从客户端 IP 到 Privoxy 监听端口的 TCP 连接。
▮▮▮▮▮▮▮▮❹ 检查 privoxy.cfg 文件中的 permit 和 deny 指令，确认客户端 IP 是否被允许访问。默认配置通常允许本地连接（如 127.0.0.1），但如果 Privoxy 运行在另一台机器上，需要明确允许客户端的网段或 IP。
③ Privoxy 运行正常，但某些网站访问异常（页面元素缺失、排版错误、功能失效）:
▮▮▮▮ⓑ 错误现象: 部分网站内容显示不完整，例如广告位虽然被移除，但留下了空白区域，或者页面脚本无法正常执行导致功能受损。
▮▮▮▮ⓒ 可能原因:
▮▮▮▮▮▮▮▮❹ Privoxy 的内容过滤（Filtering）动作移除了页面必需的元素或脚本。
▮▮▮▮▮▮▮▮❺ Privoxy 的头部修改动作（如移除 Referer）干扰了网站的正常判断。
▮▮▮▮▮▮▮▮❻ 规则过于激进，误伤了正常内容。
▮▮▮▮ⓖ 解决方法:
▮▮▮▮▮▮▮▮❽ 暂时禁用 Privoxy，直接访问该网站，看是否恢复正常。如果恢复正常，问题确实出在 Privoxy。
▮▮▮▮▮▮▮▮❾ 将 Privoxy 的 loglevel 提高到 16 或 32，访问问题网站，然后查看日志，分析 Privoxy 对该网站应用了哪些动作。
▮▮▮▮▮▮▮▮❿ 找到导致问题的动作或过滤规则。这通常需要结合日志和对动作文件的理解。例如，如果怀疑是某个过滤器的问题，可以尝试在 user.action 或 default.action 中找到对该网站生效的过滤规则，并暂时将其注释掉或修改。
▮▮▮▮▮▮▮▮❹ 对于特定网站，可以使用 -block 或 -filter 动作来例外处理，例如：
▮▮▮▮▮▮▮▮▮▮▮▮{-filter}
▮▮▮▮▮▮▮▮▮▮▮▮example.com （对 example.com 禁用所有过滤器）
▮▮▮▮▮▮▮▮▮▮▮▮或者更精确地禁用某个特定的过滤器：
▮▮▮▮▮▮▮▮▮▮▮▮{-filter{banners-by-size}}
▮▮▮▮▮▮▮▮▮▮▮▮example.com
▮▮▮▮注意，定位问题规则可能需要耐心和反复试验。
④ 使用链式代理（Chaining Proxy）时连接失败:
▮▮▮▮ⓑ 错误现象: Privoxy 配置了 forward 或 forward-socks 指令，但无法通过链上的下一个代理访问外部网络。
▮▮▮▮ⓒ 可能原因:
▮▮▮▮▮▮▮▮❹ 下一个代理的地址或端口配置错误。
▮▮▮▮▮▮▮▮❺ 下一个代理没有运行或不可达。
▮▮▮▮▮▮▮▮❻ 下一个代理需要认证，但 Privoxy 未配置认证信息。
▮▮▮▮ⓖ 解决方法:
▮▮▮▮▮▮▮▮❽ 仔细检查 forward 或 forward-socks 指令中的 IP 地址和端口号是否正确。
▮▮▮▮▮▮▮▮❾ 确保下一个代理服务正在运行，并且 Privoxy 所在的机器能够访问到该代理的 IP 和端口（检查网络连通性和防火墙）。
▮▮▮▮▮▮▮▮❿ 如果下一个代理需要用户名和密码，查阅 Privoxy 文档，看是否支持该类型代理的认证配置（通常 forward-socks 到 Tor 不需要认证，但 forward 到 HTTP 代理可能需要，Privoxy 的支持程度有限）。
▮▮▮▮▮▮▮▮❹ 查看 Privoxy 日志，级别设置为 8 或更高，可以看到 Privoxy 尝试连接下一个代理时的信息或错误。
以上涵盖了 Privoxy 常见的故障场景。解决问题的通用步骤是：观察现象 → 查看日志 → 分析原因 → 尝试解决方法 → 测试验证。熟练掌握日志分析是排除 Privoxy 故障的核心技能。
8.3 规则冲突与调试
Privoxy 强大的过滤功能依赖于动作文件（Action Files）中定义的规则。当您自定义了大量规则或同时启用了多个动作文件时，不同的规则可能会应用于同一个请求，甚至相互冲突。理解 Privoxy 如何处理规则以及如何调试规则冲突至关重要。
规则处理顺序:
Privoxy 处理一个请求时，会按顺序加载和评估在 privoxy.cfg 中通过 actionsfile 指令指定的动作文件。默认情况下，通常会先加载 default.action，然后加载 user.action 等。
在一个动作文件内部，规则的评估顺序也很重要。Privoxy 会从上到下依次评估每条规则。对于一个特定的请求 URL，匹配到的所有规则的动作都会被累积起来。这意味着，如果在文件前面有一条规则对某个网站应用了 +block，而在文件后面有另一条规则对同一个网站应用了 -block，那么最终的决定取决于最后匹配到的规则。更准确地说，Privoxy 会收集所有匹配规则的动作，并根据动作类型和文件顺序来确定最终生效的动作集合。同一类动作（如 +block/-block）通常是后匹配者覆盖先匹配者。
调试规则冲突:
当您发现某个网站的行为不符合预期（例如广告没有被屏蔽，或者正常内容被屏蔽了），很可能是规则冲突或匹配错误导致的。
① 使用日志进行调试:
▮▮▮▮将 loglevel 设置为 16 是调试规则最有效的方法。如前所述，日志会清晰地列出 Privoxy 对当前请求应用的每一个动作。
▮▮▮▮ⓐ 步骤:
▮▮▮▮▮▮▮▮❷ 编辑 privoxy.cfg，将 loglevel 设置为 16 或更高。
▮▮▮▮▮▮▮▮❸ 重启 Privoxy 服务使配置生效。
▮▮▮▮▮▮▮▮❹ 通过 Privoxy 访问有问题的网站。
▮▮▮▮▮▮▮▮❺ 查看 Privoxy 的日志文件。
▮▮▮▮ⓕ 日志分析: 在日志中找到对该网站 URL 的处理记录。查找 Applying actions to ...: 开头的行。在其下方会列出所有被应用的动作。
▮▮▮▮▮▮▮▮❼ 如果网站不该被屏蔽但被屏蔽了，查找日志中是否有 +block 动作被应用，以及它来自哪个动作文件和规则。
▮▮▮▮▮▮▮▮❽ 如果网站广告没有被屏蔽，查找日志中是否缺少了预期的 +block 或 +filter 动作，或者是否有 -block 或 -filter 动作意外地抵消了它们。
▮▮▮▮▮▮▮▮❾ 如果是内容过滤问题，将 loglevel 提高到 64，可以查看更详细的过滤过程。
② 临时禁用规则:
▮▮▮▮定位到可能存在冲突的规则后，可以采取以下方法临时禁用它们进行测试：
▮▮▮▮ⓐ 注释规则: 在动作文件中找到相关规则，在其前面加上 # 符号，将其注释掉。然后重新加载 Privoxy 配置（如果支持，无需重启服务；否则重启服务）。
▮▮▮▮ⓑ 使用 {toggle} 动作: Privoxy 提供了一个特殊的 {toggle} 动作，可以在匹配的 URL 上临时开启或关闭所有其他动作。例如：
▮▮▮▮▮▮▮▮{toggle}
▮▮▮▮▮▮▮▮problem.example.com
▮▮▮▮▮▮▮▮这条规则将禁用对 problem.example.com 的所有其他过滤和屏蔽动作，可以快速判断问题是否由规则引起。调试完成后记得移除或注释掉 {toggle} 规则。
▮▮▮▮ⓒ 隔离规则: 如果您怀疑是自定义规则的问题，可以将 privoxy.cfg 中的 actionsfile user.action 暂时注释掉，只使用默认规则进行测试。
③ 理解模式匹配:
▮▮▮▮规则冲突很多时候源于模式匹配的误解或错误。确保您对 Privoxy 的模式匹配语法（特别是正则表达式）有清晰的理解，避免意外匹配到不该匹配的 URL。参考本书第五章关于模式匹配的内容。
通过日志分析、临时禁用和隔离规则，您可以逐步缩小问题的范围，最终定位到导致规则冲突或意外行为的具体规则或动作。这是一个需要细致和耐心的过程。
8.4 性能优化建议
对于大多数个人用户而言，Privoxy 对系统资源的占用通常可以忽略不计。然而，如果在多用户环境、性能受限的设备上运行，或者处理大量复杂的规则，Privoxy 的性能可能会成为瓶颈。本节提供一些性能优化的建议。
① 简化和优化规则:
▮▮▮▮规则的数量和复杂度是影响 Privoxy 性能的最主要因素。
▮▮▮▮ⓐ 移除不必要的规则: 定期审查您的动作文件，移除不再需要或重复的规则。
▮▮▮▮ⓑ 优化模式匹配:
▮▮▮▮▮▮▮▮❸ 优先使用简单的字符串匹配或通配符 (*, ?)，它们通常比正则表达式更快。
▮▮▮▮▮▮▮▮❹ 对于需要使用正则表达式的规则，尽量编写高效的正则表达，避免过度复杂的模式。
▮▮▮▮ⓔ 合并相似规则: 如果多条规则应用相同的动作且匹配模式相似，可以考虑将它们合并为一条更通用的规则（如果逻辑允许）。
▮▮▮▮ⓕ 合理组织动作文件: 将常用的、效率高的规则放在动作文件的前面，可以稍微提升性能，因为Privoxy会按顺序评估。
② 调整 buffer-limit:
▮▮▮▮buffer-limit 指令（在 privoxy.cfg 中）控制 Privoxy 在内存中缓冲 HTTP 请求和响应的最大大小。默认值通常是 4MB。
▮▮▮▮如果您的系统内存充足，且需要处理大量大型请求或响应，可以适当增加 buffer-limit。但这会增加内存消耗。
▮▮▮▮如果系统内存非常有限，或者主要处理大量小请求，可以适当减小 buffer-limit，但这可能导致 Privoxy 无法处理过大的请求。
▮▮▮▮请根据实际情况进行调整，并在调整后监控系统资源使用情况。
③ 硬件和网络:
▮▮▮▮当然，Privoxy 的性能也受到运行环境硬件和网络条件的影响。
▮▮▮▮ⓐ 更快的 CPU: 规则评估和内容过滤都需要 CPU 资源，更快的处理器可以加快处理速度。
▮▮▮▮ⓑ 足够的内存: Privoxy 会缓冲数据和加载规则到内存，充足的内存可以避免频繁的磁盘 I/O。
▮▮▮▮ⓒ 网络带宽与延迟: Privoxy 作为代理，其性能也受限于服务器的网络连接速度和延迟。
④ 避免不必要的链式代理:
▮▮▮▮如果不是出于隐私或特定路由的目的，避免将 Privoxy 与其他代理（特别是远程代理）链式使用。每增加一层代理都会引入额外的延迟和处理开销。
⑤ 考虑替代方案或组合:
▮▮▮▮如果 Privoxy 在您的场景下性能始终无法满足需求，您可能需要考虑：
▮▮▮▮ⓐ 更专业的代理软件: 例如 Squid，它是一个功能强大的缓存代理，虽然配置更复杂，但在高负载场景下性能通常更好。
▮▮▮▮ⓑ DNS 过滤: 对于广告和追踪器的屏蔽，DNS 级别的过滤（如 AdGuard Home, Pi-hole）通常效率更高，因为它在网络请求发起之前就进行了拦截，避免了 HTTP 流量处理开销。可以将 Privoxy 与 DNS 过滤结合使用：DNS 过滤负责大部分广告/追踪域名屏蔽，Privoxy 负责更精细的 HTTP/HTTPS 内容过滤和头部修改。
进行性能优化时，务必进行基准测试和监控。在调整配置后，通过实际使用或压力测试来衡量效果，并监控 Privoxy 进程的 CPU 和内存使用情况。
8.5 报告 Bug 与获取社区支持
Privoxy 是一个开源项目，社区的支持对于其持续发展和问题解决至关重要。当您遇到无法自行解决的问题，或者发现了 Privoxy 的 Bug，积极地报告和寻求帮助是最好的方法。
① 查阅官方文档和常见问题:
▮▮▮▮在报告问题之前，首先查阅 Privoxy 的官方文档（特别是 README、INSTALL、User Manual）以及项目网站上的 FAQ（常见问题）。很多常见问题和配置疑难都可以在这里找到答案。
② 搜索社区资源:
▮▮▮▮搜索 Privoxy 的邮件列表档案、论坛或相关的技术社区。您遇到的问题可能已经有人遇到并解决了。
③ 准备 Bug 报告:
▮▮▮▮如果确认是 Bug 或无法找到现有解决方案，准备一个详细的 Bug 报告非常重要。一个好的 Bug 报告应该包含以下信息：
▮▮▮▮ⓐ Privoxy 版本: 使用 privoxy --version 命令获取确切的版本号。
▮▮▮▮ⓑ 操作系统和版本: 详细说明您使用的操作系统及其版本信息（例如 Windows 10 22H2, Ubuntu 22.04 LTS, macOS Ventura 13.4）。
▮▮▮▮ⓒ 问题描述: 清楚、简洁地描述您遇到的问题现象。
▮▮▮▮ⓓ 重现步骤: 提供能够稳定重现问题的详细步骤。这对于开发者定位问题至关重要。例如：“打开浏览器 -> 配置 Privoxy 代理 -> 访问 URL http://problem.site.com -> 期望行为 vs 实际行为”。
▮▮▮▮ⓔ 相关配置: 附上您的 privoxy.cfg 文件中与问题相关的部分配置，以及可能涉及的动作文件内容。注意移除敏感信息（如密码、真实 IP 地址等）。
▮▮▮▮⚝ 如果问题涉及某个特定的 URL，请提供该 URL。
▮▮▮▮⚝ 如果问题导致崩溃或错误信息，请提供完整的错误日志输出（通常需要将 loglevel 设置到较高的级别，如 8 或 16，甚至更高，以捕获详细信息）。
▮▮▮▮⚝ 任何其他可能有助于诊断的信息（如网络环境、与其他软件的交互等）。
④ 选择合适的报告渠道:
▮▮▮▮Privoxy 项目通常有官方推荐的 Bug 报告方式，最常见的是通过项目的 Bug Tracker 系统或邮件列表。查阅 Privoxy 官方网站或文档找到正确的报告渠道。
⑤ 寻求社区支持:
▮▮▮▮如果您不确定是不是 Bug，或者只是需要配置方面的帮助，可以到 Privoxy 官方邮件列表或相关技术论坛发帖求助。在提问时，同样提供尽可能详细的信息，包括您的配置、尝试过的解决方法以及相关的日志片段。
⑥ 贡献:
▮▮▮▮如果您通过自己的努力解决了某个问题，或者优化了某些规则，甚至改进了文档，考虑将您的成果分享给社区。您可以提交补丁（Patch）给开发者，或者在社区中分享您的经验。参与贡献不仅能帮助他人，也能提升您对 Privoxy 的理解，并为项目的进步做出贡献。
维护和故障排除是使用任何软件不可或缺的一部分。希望本章提供的知识和技巧能帮助您更有效地管理和使用 Privoxy，使其成为您网络隐私和流量控制的得力助手。
第九章：Privoxy 的未来与生态
欢迎来到本书的最后一章。在前面章节的学习中，我们系统地掌握了 Privoxy 的基本概念、安装配置、工作原理以及核心的过滤规则和高级应用。我们不仅学会了如何利用它来提升网络隐私和屏蔽烦人内容，更深入了解了其背后的机制和强大的定制能力。
本章，我们将跳出具体的配置细节，把目光投向 Privoxy 项目本身。作为一个成熟且活跃的开源项目，Privoxy 并非一成不变。理解其发展现状、未来可能的方向，以及它如何与其他网络工具协同工作，对于我们更全面地认识 Privoxy 的价值，并在更复杂的网络环境中有效利用它至关重要。同时，我们也将了解 Privoxy 的生态圈，认识一些功能相似或互补的工具，并探讨如何参与到这个开源社区中，共同推动项目的发展。
9.1 项目最新进展与路线图
任何活跃的开源项目都会经历持续的开发、维护和迭代。Privoxy 作为一个历史悠久且专注于特定领域的工具，其开发模式可能与一些新兴项目有所不同，但其核心目标——提供灵活强大的代理与过滤功能——始终不变。
了解 Privoxy 项目的最新进展和路线图，最直接的方式是查阅官方资源。这些通常包括：
① 项目官方网站 (Official Website)
▮▮▮▮这是获取 Privoxy 最新版本、官方文档、新闻发布以及社区链接的第一站。项目重要的更新和公告都会在这里发布。
② 项目邮件列表 (Mailing Lists)
▮▮▮▮这是项目开发者和用户交流的主要平台。
▮▮▮▮▮▮▮▮⚝ privoxy-announce: 用于发布重要的项目公告，如新版本发布。
▮▮▮▮▮▮▮▮⚝ privoxy-users: 用户交流、提问、分享经验和解决问题的地方。
▮▮▮▮▮▮▮▮⚝ privoxy-devel: 开发者讨论项目开发、Bug 修复、新特性和路线图的场所。
③ 版本控制仓库 (Version Control Repository)
▮▮▮▮虽然 Privoxy 的主开发可能使用 CVS 或 SVN 等传统工具，但其代码通常也会被镜像到 Git 平台（如 GitHub 或 GitLab），方便更广泛的社区参与和查阅。通过查看提交历史 (Commit History)、分支 (Branches) 和合并请求 (Pull Requests)，我们可以了解到正在进行的开发活动。
④ Bug 跟踪系统 (Bug Tracker) 或问题管理系统 (Issue Tracker)
▮▮▮▮这里记录了用户提交的 Bug 报告和功能请求 (Feature Requests)。查看活跃的问题列表可以帮助我们了解项目当前面临的挑战和社区关注的焦点。
典型的开源项目路线图对于像 Privoxy 这样功能相对稳定、专注于特定领域的工具来说，可能不像大型软件项目那样有明确的年度大版本规划。其路线图更多体现在：
⚝ Bug 修复与稳定性提升： 持续修复用户报告的 Bug，增强软件在各种复杂网络环境下的稳定性。
⚝ 兼容性更新： 适应最新的 Web 技术、HTTP 标准、浏览器行为变化以及操作系统更新。例如，对 HTTP/2 或未来的 HTTP/3 标准的支持，对新的广告/追踪技术模式的识别与过滤能力的增强。
⚝ 性能优化： 改进过滤引擎的效率，减少内存和 CPU 占用，尤其是在处理大量规则或高并发连接时。
⚝ 安全性加固： 修复潜在的安全漏洞，提升作为代理服务器的安全性。
⚝ 规则语言和动作的增强： 根据用户需求，可能会增加新的匹配语法或动作类型，提供更灵活强大的过滤能力。
⚝ 文档更新与改进： 持续完善用户手册和开发者文档，降低使用和贡献门槛。
⚝ 社区贡献的整合： 审核并整合社区成员提交的代码、规则列表或文档改进建议。
虽然 Privoxy 项目可能没有一份详细到未来的具体功能的公开“路线图”文档，但通过关注上述官方资源，特别是邮件列表和 Bug 跟踪系统，我们可以清晰地感知到项目当前的活跃程度、开发者的关注重点以及社区对未来发展的讨论方向。对于想要深入了解或参与的读者来说，订阅 privoxy-devel 邮件列表是了解项目未来走向的最有效途径。
9.2 Privoxy 与其他工具的集成
Privoxy 作为一个专注于过滤和隐私增强的 HTTP 代理服务器，在实际应用中很少孤立存在。它常常与其他网络工具协同工作，构建更强大、更灵活的网络访问控制和隐私保护体系。理解如何将其与防火墙、VPN、其他代理软件等工具集成，能够极大地扩展 Privoxy 的应用场景。
本节将探讨几种常见的集成模式：
9.2.1 与防火墙 (Firewall) 的集成
防火墙主要负责基于 IP 地址、端口、协议等信息对网络连接进行允许或拒绝的决策。Privoxy 则在连接建立后，对应用层（主要是 HTTP/HTTPS）的内容和头部进行更细粒度的过滤。两者结合可以形成多层次的网络访问控制。
① Privoxy 在防火墙 之后
▮▮▮▮在这种模式下，防火墙首先决定哪些连接可以建立。对于允许通过的 HTTP/HTTPS 连接，再将其重定向或配置浏览器通过 Privoxy。
▮▮▮▮▮▮▮▮优点： 防火墙提供了第一道防线，可以先阻止掉恶意 IP 或端口的连接尝试，减轻 Privoxy 的压力。Privoxy 专注于对已允许的流量进行内容过滤。
▮▮▮▮▮▮▮▮缺点： 需要配置防火墙将特定流量转发到 Privoxy 端口，或者在客户端配置代理。
② Privoxy 在防火墙 之前
▮▮▮▮客户端的所有 HTTP/HTTPS 流量首先被强制（通过透明代理或客户端配置）发送到 Privoxy。Privoxy 执行过滤后，再将流量转发出去，此时防火墙会检查 Privoxy 发出的流量。
▮▮▮▮▮▮▮▮优点： Privoxy 可以对所有 HTTP/HTTPS 流量进行过滤，包括那些可能被防火墙允许但包含不良内容的流量。
▮▮▮▮▮▮▮▮缺点： 如果 Privoxy 成为瓶颈，可能会影响所有 HTTP/HTTPS 连接。防火墙规则需要考虑 Privoxy 作为源地址。
集成方式示例：
⚝ 客户端配置代理 + 防火墙： 在客户端（浏览器、系统网络设置）将 HTTP/HTTPS 代理指向 Privoxy 监听的地址和端口。防火墙配置允许客户端访问 Privoxy 端口，并允许 Privoxy 访问互联网的 80/443 端口。
⚝ 透明代理 + 防火墙 (如 iptables)： 使用防火墙规则（如 Linux 的 iptables 或 nftables）将局域网内特定用户或设备发往 80/443 端口的流量 DNAT（目标网络地址转换）或 REDIRECT 到运行 Privoxy 的设备的 Privoxy 监听端口。然后防火墙再配置 Privoxy 设备的访问互联网规则。这通常需要 Privoxy 以透明代理模式运行，或者配置正确的转发规则。
9.2.2 与 VPN (Virtual Private Network) 的集成
VPN 用于在公共网络上建立加密隧道，保护数据传输的隐私和安全，同时可以隐藏用户的真实 IP 地址。Privoxy 可以在 VPN 隧道内部或外部工作，以实现不同的目标。
① Privoxy 在 VPN 客户端之前
▮▮▮▮客户端的 HTTP/HTTPS 流量首先通过 Privoxy 进行过滤和隐私增强，然后再进入 VPN 客户端，通过加密隧道发送。
▮▮▮▮▮▮▮▮优点： Privoxy 可以对原始的 HTTP/HTTPS 请求进行修改和过滤，这些修改在进入 VPN 隧道前就已完成。这意味着，即使 VPN 提供商监控隧道流量，他们看到的也是经过 Privoxy 处理后的请求。
▮▮▮▮▮▮▮▮缺点： Privoxy 的过滤是在 VPN 隧道建立前进行的。如果 Privoxy 本身受到攻击或配置不当，可能会泄露信息（尽管经过过滤）。
② Privoxy 在 VPN 客户端之后 (更常见)
▮▮▮▮客户端通过 VPN 隧道发送所有流量。在 VPN 隧道的本地出口端（即 VPN 客户端成功连接后，虚拟网卡上的流量），将 HTTP/HTTPS 流量重定向或配置通过 Privoxy。
▮▮▮▮▮▮▮▮优点： 所有流量都首先通过 VPN 加密和路由。Privoxy 过滤的是已经通过 VPN 隧道传输的流量，增加了隐私层。这是将 Privoxy 的内容过滤能力叠加在 VPN 的基础安全和匿名性之上的常用方法。
▮▮▮▮▮▮▮▮缺点： 配置可能稍复杂，需要确保只有 HTTP/HTTPS 流量被导向 Privoxy，或者 Privoxy 能够正确处理其他协议（通常 Privoxy 只处理 HTTP/HTTPS）。
③ Privoxy 在 VPN 服务器端
▮▮▮▮Privoxy 部署在 VPN 服务器所在网络或 VPN 服务器本身。所有连接到此 VPN 的客户端流量在离开 VPN 服务器进入互联网前，经过 Privoxy 过滤。
▮▮▮▮▮▮▮▮优点： 为所有 VPN 客户端提供统一的过滤和隐私保护策略，无需在每个客户端单独配置 Privoxy。
▮▮▮▮▮▮▮▮缺点： 需要控制 VPN 服务器，且所有客户端必须接受服务器端的过滤策略。
集成方式示例：
⚝ Privoxy + VPN 客户端： 在系统网络设置中，先配置 HTTP/HTTPS 代理为 Privoxy。然后启动 VPN 客户端。确保 VPN 客户端的流量包含了代理流量。或者，配置 VPN 客户端允许通过代理连接。
⚝ VPN 客户端 + Privoxy (透明代理/策略路由)： 启动 VPN 客户端后，使用策略路由或防火墙规则（如 iptables/nftables 或 Windows 防火墙）将通过 VPN 虚拟网卡发出的 HTTP/HTTPS 流量重定向到本地运行的 Privoxy 端口。
9.2.3 与其他代理软件的链式连接 (Chaining with Other Proxies)
我们在第七章已经详细讨论了链式代理，特别是与 Tor 的集成 (forward-socks)。这里可以进一步概括：
⚝ Privoxy -> Tor： 客户端连接 Privoxy，Privoxy 将流量通过 SOCKS 协议转发给 Tor 客户端。Privoxy 负责 HTTP/HTTPS 过滤和隐私增强，Tor 负责匿名路由。这是非常常见的组合，提升了匿名性和抗追踪能力。
⚝ Privoxy -> 其他 HTTP/HTTPS 代理： 客户端连接本地 Privoxy，Privoxy 将流量转发给上游的 HTTP/HTTPS 代理。上游代理可能是公司的网关代理、具有缓存功能的代理（如 Squid），或者其他过滤代理。这种模式常用于企业网络或特定场景。
⚝ 其他代理 -> Privoxy： 客户端连接到另一个代理（可能是透明代理或 Socks 代理），该代理再将 HTTP/HTTPS 流量转发给 Privoxy 进行过滤。例如，可以使用 Polipo 或 Dante 等轻量级 Socks 代理将 Socks 流量转换为 HTTP 流量再送给 Privoxy。
链式代理的配置主要依赖于 Privoxy 的 forward 和 forward-socks 指令，如第七章所述。关键在于理解数据流向以及每个代理在链中所扮演的角色。
9.2.4 与网络监控和日志分析工具
Privoxy 的日志 (Log Files) 包含了详细的连接信息、请求/响应处理结果、应用了哪些规则等。将这些日志导向中心化的日志管理系统（如 ELK Stack, Splunk 等）或专门的网络监控工具，可以帮助管理员：
⚝ 监控网络流量和访问模式。
⚝ 分析过滤规则的效果，发现需要调整的地方。
⚝ 诊断连接问题或规则冲突。
⚝ 识别潜在的安全威胁或策略违规。
通过配置 Privoxy 的 logfile 和 loglevel 指令，并结合系统级的日志转发工具（如 syslog），可以实现日志的集中收集和分析。
总而言之，Privoxy 的强大之处不仅在于其自身的过滤能力，还在于它能够作为网络流量处理链中的一环，与其他工具灵活组合，构建出满足特定需求的复杂网络环境。
9.3 相关或替代性工具简介
Privoxy 并非网络代理和内容过滤领域的唯一玩家。市面上有许多功能类似或在特定方面更强的工具。了解这些工具，有助于我们根据具体需求选择最合适的解决方案，或者理解 Privoxy 在整个生态系统中的位置。
本节将简要介绍几种与 Privoxy 功能有交集或互补的工具：
9.3.1 浏览器扩展 (Browser Extensions)
⚝ uBlock Origin: 这是一个高效、广受欢迎的浏览器扩展，主要用于广告和追踪器屏蔽。它使用过滤规则列表（兼容 Adblock Plus 语法）直接在浏览器层面修改网页内容或阻止请求。
▮▮▮▮⚝ 与 Privoxy 对比：
▮▮▮▮▮▮▮▮优点： 安装和使用非常简单，无需系统级配置；直接在浏览器中工作，可以精确控制单个网站的行为；对网页元素的隐藏和修改能力通常比 Privoxy 基于代理的内容过滤更灵活。
▮▮▮▮▮▮▮▮缺点： 仅限于浏览器内的 HTTP/HTTPS 流量；对非浏览器应用无效；某些高级隐私功能（如修改任意头部）不如 Privoxy 全面；需要为每个浏览器单独安装和配置。
⚝ Adblock Plus (ABP): 另一个老牌的广告屏蔽浏览器扩展，功能与 uBlock Origin 类似，但通常资源占用更高。
▮▮▮▮⚝ 与 Privoxy 对比： 与 uBlock Origin 类似，是浏览器层面的解决方案。
总结： 浏览器扩展是终端用户进行广告屏蔽和基础隐私保护的便利选择。Privoxy 适用于需要对整个系统或网络中的所有 HTTP/HTTPS 流量进行统一过滤和隐私增强的场景，其能力范围和配置灵活性超越了浏览器扩展。两者可以结合使用，Privoxy 提供系统级的防护，浏览器扩展提供浏览器内的精细控制。
9.3.2 DNS 层面广告/追踪屏蔽工具
⚝ Pi-hole: 这是一个网络级的 DNS 沉洞 (DNS Sinkhole)，通过在 DNS 解析阶段阻止对已知广告和追踪服务器域名的访问来达到屏蔽目的。通常部署在家用路由器或独立的树莓派等设备上。
▮▮▮▮⚝ 与 Privoxy 对比：
▮▮▮▮▮▮▮▮优点： 在 DNS 层面工作，对所有使用该 DNS 服务器的设备都有效，无论应用类型；资源占用低；安装和管理界面友好。
▮▮▮▮▮▮▮▮缺点： 只能基于域名进行屏蔽，无法检查 URL 路径、请求头部或网页内容；对使用 IP 地址直接访问或绕过系统 DNS 的情况无效；无法修改网页内容以移除广告元素留下的空白。
⚝ AdGuard Home: 功能比 Pi-hole 更强大，除了 DNS 过滤外，还支持基于规则的 HTTP 层过滤（类似 Privoxy），并且提供更友好的 Web 管理界面。它也可以部署在路由器或独立设备上。
▮▮▮▮⚝ 与 Privoxy 对比：
▮▮▮▮▮▮▮▮优点： 结合了 DNS 和 HTTP 过滤的优势，提供更全面的网络级屏蔽；Web 界面易于管理；功能相对全面。
▮▮▮▮▮▮▮▮缺点： HTTP 过滤规则的灵活性和强大程度可能不如 Privoxy ；作为一个相对较新的项目，其过滤引擎的成熟度和社区维护的规则列表可能与 Privoxy 积累的有所不同。
总结： Pi-hole 和 AdGuard Home 提供了网络级的广告/追踪屏蔽方案，尤其适合保护家庭或小型网络中的所有设备。它们在 DNS 层面具有优势。Privoxy 则专注于 HTTP/HTTPS 代理和内容过滤，在对流量内容进行深度检查和修改方面更具特长。AdGuard Home 可以看作是一个功能上包含了 Privoxy 部分能力且更易用的网络级解决方案。
9.3.3 传统代理服务器
⚝ Squid: 这是一个功能强大的、通用的缓存和转发 HTTP/HTTPS 代理服务器。它主要用于缓存网页内容以加速访问、控制用户访问权限、记录访问日志等。Squid 也支持通过 ACL (Access Control Lists) 进行基于 URL、IP、时间的访问控制，但其内容过滤和隐私增强功能不如 Privoxy 灵活和细致。
▮▮▮▮⚝ 与 Privoxy 对比：
▮▮▮▮▮▮▮▮优点： 成熟稳定，功能全面，尤其擅长缓存和复杂的访问控制；性能通常很高，适合大型网络。
▮▮▮▮▮▮▮▮缺点： 配置复杂；内容过滤和隐私修改功能不如 Privoxy 灵活和强大；不是专门为隐私保护和内容过滤设计的。
⚝ Tinyproxy: 这是一个轻量级的、简单的 HTTP 代理服务器，主要用于基本的转发代理功能。
▮▮▮▮⚝ 与 Privoxy 对比：
▮▮▮▮▮▮▮▮优点： 非常轻量，易于安装和配置。
▮▮▮▮▮▮▮▮缺点： 功能非常有限，不支持内容过滤、隐私增强等 Privoxy 的核心功能。
总结： 传统代理服务器如 Squid 更侧重于缓存、访问控制和性能。Privoxy 则专注于内容过滤和隐私保护。在某些场景下，它们可以链式组合，例如 Squid 提供缓存和上游转发，Privoxy 提供前端的内容过滤。
选择哪个工具取决于具体需求：
⚝ 如果只需要在浏览器中屏蔽广告：uBlock Origin 是最简单有效的选择。
⚝ 如果需要为整个家庭或小型网络中的所有设备提供 DNS 层面屏蔽：Pi-hole 或 AdGuard Home 值得考虑。
⚝ 如果需要对 HTTP/HTTPS 流量进行深度内容过滤、隐私增强和精细控制，并可能与 Tor 或其他代理链式使用：Privoxy 是一个非常强大和灵活的工具。
⚝ 如果需要高性能缓存或复杂的企业级代理功能：Squid 可能是更好的选择，或者与 Privoxy 结合使用。
理解 Privoxy 在这个生态系统中的定位——一个强大的、灵活的、专注于 HTTP/HTTPS 内容过滤和隐私增强的非缓存代理——是做出明智选择的关键。
9.4 参与社区与贡献
Privoxy 是一个开源项目，它的存在和发展离不开社区的支持和贡献。无论你是初学者还是专家，都有多种方式可以参与到 Privoxy 社区中，帮助项目变得更好。
① 学习和使用文档 (Documentation)
▮▮▮▮仔细阅读官方文档是入门和深入理解 Privoxy 的基础。如果发现文档中存在错误、不清晰的地方，或者有可以改进的地方，可以向社区提出建议或直接贡献文档的修改。
② 提问与分享经验 (Ask Questions and Share Experiences)
▮▮▮▮加入 privoxy-users 邮件列表，在那里提问你在使用过程中遇到的问题。同时也乐于分享你的配置经验和解决问题的过程，帮助其他用户。活跃的用户社区是开源项目的重要组成部分。
③ 报告 Bug (Report Bugs)
▮▮▮▮在使用过程中如果发现了软件的 Bug，请务必将其报告给项目开发者。一个高质量的 Bug 报告对于开发者定位和修复问题至关重要。
▮▮▮▮▮▮▮▮高质量 Bug 报告通常包含：
▮▮▮▮▮▮▮▮❶ 遇到的具体问题描述。
▮▮▮▮▮▮▮▮❷ 重现问题的步骤。
▮▮▮▮▮▮▮▮❸ 使用的 Privoxy 版本、操作系统以及相关的环境信息。
▮▮▮▮▮▮▮▮❹ 相关的日志片段和配置文件（请注意移除敏感信息）。
④ 提交功能请求 (Submit Feature Requests)
▮▮▮▮如果你认为 Privoxy 缺少某个有用的功能，或者现有功能有改进的空间，可以在邮件列表或 Bug 跟踪系统中提出你的想法。讨论这些想法有助于开发者了解用户需求和确定项目优先级。
⑤ 贡献规则列表和过滤器 (Contribute Rule Lists and Filters)
▮▮▮▮Privoxy 的核心价值之一在于其强大的过滤规则。如果你编写了新的、有效的过滤规则（例如，针对某个特定网站的广告或追踪器），可以考虑与社区分享。这些规则可能会被整合到默认的规则列表中，惠及所有用户。可以提交 .action 或 .filter 文件片段，并在邮件列表中讨论。
⑥ 贡献代码 (Contribute Code)
▮▮▮▮如果你是 C/C++ 开发者，并且对 Privoxy 的内部实现感兴趣，可以直接参与代码贡献。可以从修复 Bug 入手，或者根据讨论实现新的功能。
▮▮▮▮▮▮▮▮代码贡献流程通常包括：
▮▮▮▮▮▮▮▮❶ 克隆项目代码仓库。
▮▮▮▮▮▮▮▮❷ 实现代码修改。
▮▮▮▮▮▮▮▮❸ 编写或更新文档。
▮▮▮▮▮▮▮▮❹ 提交补丁 (Patch) 或合并请求 (Pull Request)，供开发者审核。
⑦ 捐赠支持 (Donations)
▮▮▮▮Privoxy 是一个志愿者项目，没有商业支持。如果 Privoxy 对你非常有价值，可以考虑通过项目官网提供的渠道进行捐赠，以支持项目的托管、基础设施和开发者的辛勤工作。
参与开源社区不仅仅是单方面的贡献，也是一个学习和成长的过程。你可以与其他有经验的用户和开发者交流，学习他们的技术和解决问题的方法。
本书旨在帮助读者全面理解 Privoxy 的各个方面。希望通过本章，读者能够对 Privoxy 项目的现状、未来方向以及它在整个网络工具生态系统中的位置有清晰的认识，并被鼓励参与到这个充满活力和价值的开源社区中。
Appendix A: 附录 A：常用动作列表速查
本附录旨在为读者提供 Privoxy 中最常用过滤动作指令的快速参考指南。这些动作是 Privoxy 实现其内容过滤和隐私增强功能的基石。理解并熟练运用这些动作，是定制 Privoxy 行为的关键。
在 Privoxy 的动作文件（通常是 .action 文件）中，动作指令通常与一个或多个模式（如 URL 模式、域名模式等）关联。当请求匹配到特定模式时，相应的动作就会被执行。一个模式可以关联多个动作。
动作指令前面通常带有 + 或 - 符号：
⚝ +动作名: 表示启用或应用该动作。
⚝ -动作名: 表示禁用或取消应用该动作。
以下是 Privoxy 中一些常用动作的列表及其简要说明：
⚝ +block / -block (阻塞)
▮▮▮▮⚝ 说明: 这是最直接的动作，用于阻止对匹配到的 URL 或资源的访问。当一个请求被 +block 动作匹配时，Privoxy 会返回一个特殊的阻塞页面（通常是 403 Forbidden 或自定义页面），而不是转发请求到目标服务器。
▮▮▮▮⚝ 用途: 主要用于屏蔽广告服务器、追踪器域名或不希望访问的网站。
▮▮▮▮⚝ 示例: +block 匹配所有指向广告域名 adserver.com 的请求。
⚝ +filter / -filter (内容过滤)
▮▮▮▮⚝ 说明: 这个动作用于对匹配到的请求的响应内容（如 HTML 页面、JavaScript 文件等）应用一个或多个预定义或用户自定义的过滤器。Privoxy 内置了许多过滤器，用于移除广告脚本、修改 HTML 结构、处理弹出窗口等。
▮▮▮▮⚝ 用途: 用于修改网页内容，移除页面上的广告元素、弹出窗口或追踪代码。
▮▮▮▮⚝ 示例: +filter{ condense-whitespace } 应用 condense-whitespace 过滤器来移除 HTML 中的多余空白。
⚝ +hide-headers / -hide-headers (隐藏头部)
▮▮▮▮⚝ 说明: 这个动作用于移除或修改 HTTP 请求或响应中的特定头部字段，以增强隐私或防止信息泄露。
▮▮▮▮⚝ 用途: 隐藏如 User-Agent, Referer, Cookie 等可能暴露用户身份或访问来源的头部信息。
▮▮▮▮⚝ 示例: +hide-headers{ User-Agent Referer } 会在匹配的请求中移除 User-Agent 和 Referer 头部。
⚝ +change-x-forwarded-for / -change-x-forwarded-for (修改 X-Forwarded-For)
▮▮▮▮⚝ 说明: X-Forwarded-For 是一个非标准的 HTTP 头部，常用于标识通过代理服务器连接到 Web 服务器的客户端原始 IP 地址。+change-x-forwarded-for 可以修改或移除这个头部，以隐藏用户的真实 IP 地址。
▮▮▮▮⚝ 用途: 增强通过代理访问时的匿名性。Privoxy 可以设置为发送一个伪造的 IP 地址或直接移除该头部。
⚝ +hide-referer / -hide-referer (隐藏 Referer)
▮▮▮▮⚝ 说明: Referer (正确的拼写是 Referrer，但 HTTP 标准中是 Referer) 头部指示了当前请求是从哪个页面链接过来的。+hide-referer 用于移除或修改这个头部，防止网站追踪用户的浏览路径。
▮▮▮▮⚝ 用途: 保护用户的浏览隐私，避免泄露访问来源。通常会设置为移除 Referer 头部或将其设置为一个通用的值。
⚝ +hide-user-agent / -hide-user-agent (隐藏 User-Agent)
▮▮▮▮⚝ 说明: User-Agent 头部包含了关于用户使用的浏览器、操作系统等信息。+hide-user-agent 用于修改或移除这个头部，防止网站根据用户代理信息进行识别或追踪。
▮▮▮▮⚝ 用途: 增加匿名性，防止被特定网站检测或限制基于 User-Agent 的访问。可以将其设置为一个通用的 User-Agent 字符串。
⚝ +session-cookies / -session-cookies (会话 Cookie)
▮▮▮▮⚝ 说明: 这个动作用于将持久性 Cookie (Persistent Cookies) 转换为会话 Cookie (Session Cookies)，或完全禁用 Cookie。会话 Cookie 在浏览器关闭时会自动删除，而持久性 Cookie 会存储在用户的硬盘上。
▮▮▮▮⚝ 用途: 减少网站通过 Cookie 长期追踪用户的能力。
⚝ +force-remote-cookies / -force-remote-cookies (强制远程 Cookie)
▮▮▮▮⚝ 说明: 通常，Privoxy 会缓存一些 Cookie 信息。+force-remote-cookies 可以强制 Privoxy 总是从远程服务器获取最新的 Cookie 信息，而不是使用缓存。-force-remote-cookies 则启用 Privoxy 的 Cookie 缓存功能。
▮▮▮▮⚝ 用途: 在某些需要精确控制 Cookie 行为或调试的场景中使用。
⚝ +set-image-blocker / -set-image-blocker (设置图像阻塞器)
▮▮▮▮⚝ 说明: 这个动作用于替换匹配到的图像请求的响应。Privoxy 可以返回一个预设的小空白图片或完全阻止图像加载。
▮▮▮▮⚝ 用途: 有效屏蔽网页中的图像广告或追踪像素。
⚝ +redirect / -redirect (重定向)
▮▮▮▮⚝ 说明: 将匹配到的请求重定向到另一个 URL。
▮▮▮▮⚝ 用途: 用于将特定的请求导向另一个地址，例如将旧链接重定向到新链接，或者将广告请求重定向到一个无效地址或本地资源。
▮▮▮▮⚝ 示例: +redirect{ http://localhost/blank.gif } 将匹配到的请求重定向到一个本地的空白 GIF 图片。
⚝ +fast-redirect / -fast-redirect (快速重定向)
▮▮▮▮⚝ 说明: 类似于 +redirect，但通常用于更简单的重定向场景，例如将请求重定向到一个错误页面或空白页面，执行速度可能更快。
▮▮▮▮⚝ 用途: 快速丢弃或替换不想要的请求，如广告或追踪。
⚝ +crunch-bits / -crunch-bits (压缩位)
▮▮▮▮⚝ 说明: 这个动作尝试通过移除某些不必要的数据（例如 HTML/CSS 中的注释、多余空白等）来减小响应内容的大小。
▮▮▮▮⚝ 用途: 在带宽有限的环境下可能有助于节省流量，但现在较少使用，且可能影响页面格式。
⚝ +demote-error-page / -demote-error-page (降级错误页面)
▮▮▮▮⚝ 说明: 当 Privoxy 阻塞一个请求时，默认会显示一个 Privoxy 提供的错误页面。+demote-error-page 可以配置 Privoxy 在某些情况下显示一个更简略或不同的错误信息。
▮▮▮▮⚝ 用途: 定制用户看到的信息，使其更友好或更不显眼。
⚝ +lookup-dns / -lookup-dns (查找 DNS)
▮▮▮▮⚝ 说明: 通常 Privoxy 会让客户端浏览器自行解析域名。+lookup-dns 动作强制 Privoxy 自己执行 DNS 查找。
▮▮▮▮⚝ 用途: 在某些网络配置下可能有用，或者为了通过 Privoxy 控制 DNS 查询的行为。
⚝ +send-vanilla-request / -send-vanilla-request (发送原始请求)
▮▮▮▮⚝ 说明: 这个动作会忽略所有其他的头部修改动作，发送一个“原始的”(vanilla) 请求到目标服务器，但仍然会经过阻塞和过滤检查。
▮▮▮▮⚝ 用途: 在需要绕过某些特定的 Privoxy 头部修改规则时使用，例如测试网站是否对某些头部敏感。
了解并灵活组合这些动作，可以让你构建出强大且高度定制化的 Privoxy 过滤规则，从而有效地保护你的网络隐私，控制网络流量，并改善浏览体验。
Appendix B: 附录 B：模式匹配语法速查
本附录旨在提供 Privoxy 中模式匹配语法的快速参考和简要说明。Privoxy 的核心功能在于根据配置的规则对网络请求进行过滤和修改，而这些规则是否生效，取决于其定义的模式能否匹配到目标 URL（Uniform Resource Locator）、域名（Domain Name）、请求/响应头部（Headers）等。掌握 Privoxy 的模式匹配语法是编写有效过滤规则的基础。
Appendix B1: 模式匹配的基本概念
在 Privoxy 的动作文件（.action 文件）中，规则通常由两部分组成：模式（Pattern）和动作（Action）。模式定义了规则适用的对象，而动作定义了对匹配对象的处理方式。Privoxy 主要通过模式匹配来决定对哪些网络流量应用特定的动作。
Privoxy 的模式匹配功能强大且灵活，支持简单的字符串匹配、通配符（Wildcard）以及更复杂的正则表达式（Regular Expressions）。
Appendix B2: 基础模式匹配与通配符
Privoxy 支持直接使用字符串或结合通配符进行模式匹配。这是最常用也是最简单的匹配方式。
Appendix B2.1: 基础字符串匹配
最简单的模式是直接指定一个字符串。如果目标字符串（如 URL 的一部分）包含这个模式字符串，则匹配成功。
⚝ 示例: example.com
▮▮▮▮⚝ 这个模式会匹配任何包含 example.com 的目标，例如 http://www.example.com/index.html 或 https://sub.example.com/page。
Appendix B2.2: 使用通配符 (* 和 ?)
通配符提供了比基础字符串匹配更灵活的方式来匹配多个不同的字符串。
① 星号 (*)
▮▮▮▮⚝ * 匹配任意长度（包括零长度）的任意字符序列。
▮▮▮▮⚝ 它是最常用的通配符，非常适合匹配变化的部分或路径的任意层级。
⚝ 示例 1: *.example.com
▮▮▮▮⚝ 匹配所有 example.com 的子域名（包括 example.com 本身）。例如：www.example.com, sub.example.com, example.com。
⚝ 示例 2: http://example.com/*
▮▮▮▮⚝ 匹配 http://example.com/ 下的所有路径和文件。例如：http://example.com/, http://example.com/index.html, http://example.com/images/logo.png。
⚝ 示例 3: */ads/*
▮▮▮▮⚝ 匹配任何包含 /ads/ 路径片段的 URL。例如：http://site.com/ads/banner.gif, https://tracker.net/ads/click。
② 问号 (?)
▮▮▮▮⚝ ? 匹配任意单个字符。
▮▮▮▮⚝ 适用于匹配固定长度但未知具体字符的部分。
⚝ 示例: file??.txt
▮▮▮▮⚝ 匹配 file01.txt, fileAB.txt 等，但不匹配 file1.txt 或 file001.txt。
Appendix B2.3: 模式的起始和结束标记 (^ 和 $)
在某些情况下，你需要确保模式匹配的是目标字符串的起始或结束部分，而不是中间的任意位置。虽然这更像是正则表达式的用法，但在 Privoxy 的简单模式匹配中，^ 通常表示模式必须出现在字符串的起始，而 $ 表示模式必须出现在字符串的结束。需要注意的是，这在 Privoxy 的简单模式中并非总是像在完整正则表达式中那样严格用于锚定整个字符串的起始和结束，它更多地用于指示匹配的位置倾向。
⚝ 示例 1: ^http://
▮▮▮▮⚝ 匹配以 http:// 开头的 URL。
⚝ 示例 2: .gif$
▮▮▮▮⚝ 匹配以 .gif 结尾的 URL。
⚝ 示例 3: ^https://example.com/path/file.html$
▮▮▮▮⚝ 严格匹配 https://example.com/path/file.html 这个完整的 URL。
Appendix B3: 正则表达式匹配 (Regular Expressions)
对于更复杂的匹配需求，Privoxy 支持使用正则表达式。正则表达式提供了极其强大的模式描述能力。在 Privoxy 的动作文件 (.action) 中，正则表达式通常以 / 开头和结尾。
Appendix B3.1: 正则表达式基础语法要素
Privoxy 使用的正则表达式引擎通常与 Perl 兼容。以下是一些常用的正则表达式元字符（Metacharacters）和语法元素：
① 常用元字符
▮▮▮▮⚝ . 匹配除换行符外的任意单个字符。
▮▮▮▮⚝ * 匹配前一个元素零次或多次。
▮▮▮▮⚝ + 匹配前一个元素一次或多次。
▮▮▮▮⚝ ? 匹配前一个元素零次或一次（使其可选），或用于使 * 和 + 非贪婪匹配。
▮▮▮▮⚝ ^ 匹配字符串的开始。
▮▮▮▮⚝ $ 匹配字符串的结束。
▮▮▮▮⚝ | 或运算符，匹配左边或右边的表达式。
▮▮▮▮⚝ () 分组，可以用于捕获匹配或应用量词。
▮▮▮▮⚝ [] 字符集，匹配方括号中的任意一个字符。例如 [abc] 匹配 'a', 'b', 或 'c'。
▮▮▮▮⚝ [^...] 否定字符集，匹配不在方括号中的任意字符。例如 [^0-9] 匹配非数字字符。
▮▮▮▮⚝ \ 转义字符，用于匹配元字符本身，如 \. 匹配点号。
② 常用量词 (Quantifiers)
▮▮▮▮⚝ {n} 匹配前一个元素恰好 n 次。
▮▮▮▮⚝ {n,} 匹配前一个元素至少 n 次。
▮▮▮▮⚝ {n,m} 匹配前一个元素至少 n 次，至多 m 次。
③ 常用字符类 (Character Classes)
▮▮▮▮⚝ \d 匹配任意数字 (equivalent to [0-9])。
▮▮▮▮⚝ \D 匹配任意非数字字符 (equivalent to [^0-9])。
▮▮▮▮⚝ \w 匹配任意字母、数字或下划线 (equivalent to [a-zA-Z0-9_])。
▮▮▮▮⚝ \W 匹配任意非字母、数字或下划线字符。
▮▮▮▮⚝ \s 匹配任意空白字符（空格、制表符、换行符等）。
▮▮▮▮⚝ \S 匹配任意非空白字符。
Appendix B3.2: 在 Privoxy 中使用正则表达式
在动作文件 (.action) 中，如果模式以 / 开头和结尾，Privoxy 会将其解释为正则表达式。
⚝ 语法: /正则表达式/
⚝ 示例 1: 匹配特定图片格式
▮▮▮▮⚝ 模式: /.(png|jpe?g|gif|svg)$/i
▮▮▮▮⚝ 解释: 匹配以 .png, .jpg, .jpeg, .gif, 或 .svg 结尾的 URL。末尾的 i 是一个可选的修饰符，表示匹配不区分大小写 (case-insensitive)。
⚝ 示例 2: 匹配包含特定参数的 URL
▮▮▮▮⚝ 模式: /.*[\?&]ad=true(&|$).*/
▮▮▮▮⚝ 解释: 匹配包含 ?ad=true 或 &ad=true 参数的 URL。
▮▮▮▮▮▮▮▮⚝ .* 匹配开头的任意字符。
▮▮▮▮▮▮▮▮⚝ [\?&] 匹配 ? 或 &。? 需要转义。
▮▮▮▮▮▮▮▮⚝ ad=true 匹配字面字符串 ad=true。
▮▮▮▮▮▮▮▮⚝ (&|$) 匹配 & 或字符串的结束。
▮▮▮▮▮▮▮▮⚝ .* 匹配结尾的任意字符。
⚝ 示例 3: 匹配特定路径下的数字 ID
▮▮▮▮⚝ 模式: /^http://example.com/items/\d+$/
▮▮▮▮⚝ 解释: 严格匹配以 http://example.com/items/ 开头，后面跟着一个或多个数字，并以数字结尾的 URL。例如：http://example.com/items/12345。
Appendix B4: 模式匹配的应用范围
Privoxy 的模式匹配不仅用于匹配 URL。在某些动作（如 +change-header）中，模式可以用于匹配请求或响应头部的内容。在 +filter 动作中，模式可能用于匹配 HTML 内容。
⚝ URL 模式: 用于匹配整个请求 URL。这是最常见的应用。
⚝ Header 模式: 用于匹配请求或响应头部（例如 Referer, User-Agent, Cookie 等）的值。
⚝ Content 模式: 在配合 +filter 动作时，正则表达式可以用于匹配并修改网页内容（例如 HTML 代码）。这些模式定义在专门的 .filter 文件中。
Appendix B5: 模式匹配优先级
在动作文件 (.action) 中，规则的处理是按顺序进行的。通常，Privoxy 会应用找到的第一个匹配规则的动作。然而，对于同一个 URL，可能有多条规则的模式都能匹配。Privoxy 有一套复杂的规则优先级处理机制，其中：
⚝ 最近原则: 定义在文件后面（或通过 +include 后加载）的规则通常具有更高的优先级。
⚝ 范围原则: 更具体的模式（例如匹配完整路径）通常比更通用的模式（例如只匹配域名）具有更高的优先级。
⚝ 动作类型: 某些动作（如 +block）可能在匹配时会立即终止处理，而其他动作（如头部修改）可能会继续匹配后续规则。
理解这些优先级规则对于避免规则冲突和确保期望的动作被执行至关重要。在实践中，通常建议将更具体或需要强制执行（如屏蔽）的规则放在动作文件的后面部分，或者组织在后加载的 +include 文件中。
Appendix B6: 模式匹配速查表
| 语法元素 | 类型 | 描述 | 示例 | 匹配对象示例 |
|---|---|---|---|---|
string | 基础字符串 | 匹配包含指定字符串的任意位置。 | example.com | www.example.com/, sub.example.com/page |
* | 通配符 | 匹配任意零个或多个字符。 | *.example.com | www.example.com, example.com |
? | 通配符 | 匹配任意单个字符。 | file?.txt | file1.txt, fileA.txt |
^pattern | 位置限定 | 模式应出现在目标字符串的开始位置。 | ^http:// | http://www.example.com |
pattern$ | 位置限定 | 模式应出现在目标字符串的结束位置。 | .gif$ | image.gif |
/regex/ | 正则表达式 | 使用正则表达式进行匹配。 | /.(png|jpe?g)$/i | image.png, photo.JPG |
. | 正则元字符 | 匹配除换行符外的任意单个字符。 | /a.c/ | abc, aXc |
+ | 正则元字符 | 匹配前一个元素一次或多次。 | /a+b/ | ab, aaab |
[] | 正则元字符 | 匹配方括号中的任意一个字符。 | /[0-9]/ | 匹配任意数字 |
[^...] | 正则元字符 | 匹配不在方括号中的任意字符。 | /[^a-z]/ | 匹配任意非小写字母 |
(x|y) | 正则元字符 | 匹配 x 或 y。 | /(http|https):// | http://, https:// |
\d | 正则字符类 | 匹配任意数字。 | /\d+/ | 匹配一个或多个数字，如 123 |
\w | 正则字符类 | 匹配任意字母、数字或下划线。 | /\w+/ | 匹配一个或多个单词字符，如 user_name |
\ | 正则转义 | 转义元字符。 | /\./ | 匹配字面点号 . |
掌握这些模式匹配语法，特别是正则表达式，将使你能够编写出高度定制化和精确的 Privoxy 过滤规则，从而有效地管理你的网络流量和保护个人隐私。在编写复杂规则时，建议先在独立的正则表达式测试工具中进行验证。
Appendix C: 附录 C：示例配置文件集
本书的许多章节都详细讨论了 Privoxy 的配置指令和规则语法。虽然理论学习至关重要，但通过实际的配置文件示例来理解和应用这些知识往往更有效。本附录汇集了几个针对特定常见场景的 Privoxy 配置文件片段或完整示例，旨在帮助读者快速搭建和理解 Privoxy 在不同应用场景下的工作方式。
这些示例涵盖了将 Privoxy 作为普通正向代理、集成 Tor 实现匿名访问、以及配置 Privoxy 配合防火墙规则实现透明代理等场景。请注意，这些示例可能需要根据您的具体网络环境和需求进行调整。
Appendix C1: 普通正向代理基础配置（Basic Forward Proxy Configuration）
这是 Privoxy 最基本的应用模式，客户端（如浏览器）手动或通过 PAC 文件（Proxy Auto-Config）配置使用 Privoxy 作为 HTTP(S) 代理。
目标：配置 Privoxy 监听特定地址和端口，并允许来自局域网的客户端连接。
配置文件片段 (privoxy.cfg)：
1
# 监听地址和端口。这里配置 Privoxy 监听在本地所有网络接口的 8118 端口。
2
# 如果您希望只允许本地访问，可以使用 listen-address 127.0.0.1:8118
3
# 如果您希望允许特定局域网段访问，例如 192.168.1.0/24，可以使用 listen-address 192.168.1.1:8118
4
listen-address 0.0.0.0:8118
5
6
# 访问控制。默认情况下，Privoxy 可能只允许 localhost 访问。
7
# 使用 permit 指令允许特定 IP 地址或网段访问。
8
# 建议先 deny all，再 permit 允许需要的客户端。
9
deny all
10
permit 127.0.0.1 # 允许本机访问
11
permit 192.168.1.0/24 # 允许 192.168.1.x 网段的设备访问
12
13
# 日志配置 (可选，用于调试)
14
# logfile privoxy.log
15
# loglevel 6 # 详细日志级别，用于调试，正常运行时可降低
16
17
# 默认动作文件
18
actionsfile default.action # 使用默认的动作文件，包含了一些基础的过滤规则
19
actionsfile user.action # 用户自定义的动作文件，用于添加或修改规则
解释：
① listen-address: 指定 Privoxy 绑定的 IP 地址和端口。0.0.0.0 表示监听所有可用的网络接口。端口 8118 是 Privoxy 的默认端口。
② deny all: 默认拒绝所有客户端的连接请求。这是一个好的安全实践，后续再根据需要放行。
③ permit: 允许符合规则的 IP 地址或网段连接到 Privoxy。这里的示例允许本机 (127.0.0.1) 和 192.168.1.0/24 网段的客户端。
④ logfile 和 loglevel: 配置日志输出。logfile 指定日志文件名，loglevel 控制日志的详细程度（级别越高越详细，0 表示不记录，7 表示非常详细）。
⑤ actionsfile: 指定 Privoxy 加载的动作文件。default.action 包含 Privoxy 默认提供的过滤规则，user.action 通常用于用户自定义规则。这些文件决定了 Privoxy 如何过滤和修改流量。
使用此配置后，您需要在客户端设备的网络设置中，将 HTTP 和 HTTPS 代理（HTTP Proxy 和 HTTPS Proxy）都指向运行 Privoxy 的服务器的 IP 地址和端口（例如 192.168.1.100:8118）。
Appendix C2: 集成 Tor 实现匿名访问（Integrating Tor for Anonymous Access）
将 Privoxy 与 Tor 结合使用是一种常见的增强匿名性的方法。Privoxy 负责过滤广告和追踪器，而 Tor 负责隐藏您的真实 IP 地址。通常，Privoxy 会将流量转发到 Tor 的 SOCKS 代理（SOCKS Proxy）。
目标：配置 Privoxy 将所有或部分 HTTP(S) 流量转发到本地运行的 Tor SOCKS 代理。
前提：您需要在运行 Privoxy 的同一台机器或另一台可访问的机器上安装并运行 Tor 服务，并且 Tor 的 SOCKS 代理功能已启用并监听在特定地址和端口（Tor Browser Bundle 默认通常是 127.0.0.1:9150，独立 Tor 服务默认通常是 127.0.0.1:9050）。
配置文件片段 (privoxy.cfg)：
1
# 监听地址，允许客户端连接到 Privoxy
2
listen-address 0.0.0.0:8118 # 示例：允许所有接口连接
3
4
# 访问控制 (根据需要配置允许连接的客户端)
5
deny all
6
permit 127.0.0.1
7
permit 192.168.1.0/24 # 如果 Privoxy 在网关上运行，允许局域网设备连接
8
9
# ===============================================================
10
# 以下是与 Tor 集成相关的关键配置
11
# ===============================================================
12
13
# 将所有非本地流量转发到 Tor 的 SOCKS 代理
14
# forward-socks5 Tor_SOCKS_IP:Tor_SOCKS_Port .
15
# 示例：Tor 运行在本地，监听 9050 端口 (独立 Tor 服务)
16
forward-socks5 127.0.0.1:9050 .
17
18
# 或者，如果使用 Tor Browser Bundle (监听 9150 端口)
19
# forward-socks5 127.0.0.1:9150 .
20
21
# 阻止对本地地址的请求通过 Tor 转发
22
# 这很重要，否则访问本地资源（如路由器配置页面）可能会失败
23
dont-proxy-requests localhost
24
dont-proxy-requests 127.*.*.*
25
dont-proxy-requests 10.*.*.*
26
dont-proxy-requests 192.168.*.*
27
dont-proxy-requests 172.16.*.*
28
dont-proxy-requests 172.17.*.*
29
dont-proxy-requests 172.18.*.*
30
dont-proxy-requests 172.19.*.*
31
dont-proxy-requests 172.20.*.*
32
dont-proxy-requests 172.21.*.*
33
dont-proxy-requests 172.22.*.*
34
dont-proxy-requests 172.23.*.*
35
dont-proxy-requests 172.24.*.*
36
dont-proxy-requests 172.25.*.*
37
dont-proxy-requests 172.26.*.*
38
dont-proxy-requests 172.27.*.*
39
dont-proxy-requests 172.28.*.*
40
dont-proxy-requests 172.29.*.*
41
dont-proxy-requests 172.30.*.*
42
dont-proxy-requests 172.31.*.*
43
dont-proxy-requests fc00::/7 # IPv6 ULA
44
dont-proxy-requests fe80::/10 # IPv6 link-local
45
dont-proxy-requests ::1 # IPv6 loopback
46
47
# 处理 .onion 域名，这些域名只能通过 Tor 访问
48
# Privoxy 需要知道如何处理这些特殊的域名。
49
# forward 127.0.0.1:9050 .onion # 对于 Tor 的 SOCKS 代理，这个配置通常不是必需的，
50
# 因为 forward-socks 已经处理了域名解析。
51
# 但如果使用某些特殊的 Tor 配置，可能需要。
52
# 通常 forward-socks5 127.0.0.1:9050 . 会自动处理 .onion。
53
# 稳妥起见，可以显式配置，但注意 Tor 版本的兼容性。
54
# 新版本 Tor SOCKS 通常能解析 .onion。
解释：
① forward-socks5 127.0.0.1:9050 .: 这是核心指令。它告诉 Privoxy 将所有不匹配其他 forward 或 dont-proxy-requests 规则的请求都转发到指定的 SOCKS5 代理 (127.0.0.1 的 9050 端口)。末尾的点号. 表示这条规则适用于所有目的地。
② dont-proxy-requests: 阻止对指定的模式（通常是本地 IP 范围）的请求通过代理转发。这确保您仍然可以直接访问本地网络资源。列出的规则涵盖了常见的本地和私有 IP 地址范围。
③ forward 127.0.0.1:9050 .onion: 这个指令（通常与 forward-socks 一起使用时不是必需的，但在此列出以备参考）告诉 Privoxy 如何处理 .onion 域名。它将对 .onion 域名的请求转发到指定的地址和端口。由于 .onion 域名只能通过 Tor 网络访问，这里的地址和端口应该指向您的 Tor SOCKS 代理。
选择性转发：
如果您不想所有流量都通过 Tor，而只希望特定网站通过 Tor，可以使用动作文件（.action 文件）来实现。首先，移除 privoxy.cfg 中的全局 forward-socks5 . 指令。然后，在您的 user.action 文件中，为需要通过 Tor 的网站添加如下规则：
1
# user.action 文件片段
2
3
# 将 example.com 和其子域的流量通过 Tor 转发
4
{ +forward-socks5 127.0.0.1:9050 }
5
.example.com
6
www.anothersite.org
解释：
① { +forward-socks5 127.0.0.1:9050 }: 这是一个动作列表，其中包含一个 +forward-socks5 动作。它指示 Privoxy 将匹配此规则的请求通过指定的 SOCKS5 代理转发。
② .example.com 和 www.anothersite.org: 这是模式列表，指定了哪些 URL 或域名会应用上面的动作列表。.example.com 会匹配 example.com 本身以及所有子域（如 www.example.com, mail.example.com）。
通过这种方式，您可以精确控制哪些网站使用 Tor，哪些直接连接，或者使用其他代理。
Appendix C3: 透明代理设置（Transparent Proxy Setup）
透明代理（Transparent Proxy）允许您在不修改客户端网络设置的情况下，拦截并处理其网络流量。这通常需要结合操作系统级别的网络配置（如 Linux 上的 iptables 或 nftables）来实现流量重定向。Privoxy 本身并不直接实现“透明”，而是被配置来接收并处理那些已被防火墙规则重定向过来的流量。
目标：配置 Privoxy 监听一个端口，准备接收通过防火墙规则重定向过来的 HTTP 流量。
前提：需要操作系统支持并已配置相应的防火墙规则将 HTTP (端口 80) 和/或 HTTPS (端口 443) 流量重定向到 Privoxy 监听的端口。透明代理配置通常在网关或路由器上完成。
配置文件片段 (privoxy.cfg)：
1
# 监听地址和端口。对于透明代理，Privoxy 需要监听一个特定的端口
2
# 并通常绑定到接收流量的网络接口的 IP 或 0.0.0.0。
3
# 防火墙会将端口 80/443 的流量重定向到这个端口。
4
listen-address 0.0.0.0:8118 # 示例：监听所有接口的 8118 端口
5
6
# 启用透明代理模式。这个指令会影响 Privoxy 如何解析被重定向连接的
7
# 原始目标地址和端口。
8
transparent-proxy enable
9
10
# 访问控制。通常透明代理不需要 permit/deny，因为流量已经是
11
# 通过防火墙规则引导过来的，但如果 Privoxy 不在网关上，
12
# 或者需要限制哪些重定向过来的客户端 IP 可以被处理，可以添加。
13
# deny all # 在透明代理场景下通常不需要，除非有特殊需求
14
# permit 192.168.1.0/24 # 示例：只处理来自局域网的重定向流量
15
16
# 默认动作文件
17
actionsfile default.action
18
actionsfile user.action
解释：
① listen-address 0.0.0.0:8118: Privoxy 监听的端口。防火墙规则会将客户端原本发往公网网站 80/443 端口的流量重定向到此端口。
② transparent-proxy enable: 这个指令告诉 Privoxy 它正在接收透明重定向的连接。Privoxy 会尝试使用操作系统提供的方法（如 getsockopt with SO_ORIGINAL_DST on Linux）来获取连接的原始目标地址和端口，以便正确地将请求发送到目的地。
③ actionsfile: 同样使用动作文件进行过滤。
防火墙规则示例 (Linux - iptables):
请注意，以下是 iptables 的示例规则，不属于 Privoxy 的配置文件，但对于实现透明代理至关重要。这些规则通常在网关设备上执行。
1
# 假设内网接口为 eth0，外网接口为 eth1
2
# 假设 Privoxy 监听在 8118 端口，运行在网关设备上
3
# 排除发往 Privoxy 自身的流量，防止死循环
4
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j ! -d 192.168.1.1 --to-destination 192.168.1.1:8118 # 假设网关内网IP是192.168.1.1
5
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j ! -d 192.168.1.1 --to-destination 192.168.1.1:8118
6
7
# 更通用的排除规则，排除发往本地的流量
8
# iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8118
9
# iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 8118
10
11
# 如果 Privoxy 运行在局域网的另一台机器上 (例如 192.168.1.100)
12
# iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j DNAT --to-destination 192.168.1.100:8118
13
# iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j DNAT --to-destination 192.168.1.100:8118
14
15
# 还需要配置 FORWARD 链以及 POSTROUTING 链的 SNAT/MASQUERADE 规则，确保流量能正确进出
警告：配置透明代理和防火墙规则需要对网络有深入理解，错误配置可能导致网络中断。请务必在测试环境中谨慎操作。处理 HTTPS 透明代理需要更复杂的设置，通常涉及中间人攻击（Man-in-the-Middle）技术，这超出了 Privoxy 作为非 SSL 解密代理的能力范畴。上述示例仅重定向连接，Privoxy 只能处理 CONNECT 请求，无法检查 HTTPS 内容（除非结合 SSL 解密代理）。
Appendix C4: 组合应用示例：特定网站通过 Tor，其他直连或通过普通代理
这是一个更复杂的示例，结合了 forward、forward-socks 和动作文件。
目标：
① 将所有默认流量通过一个普通的上游 HTTP 代理（例如 192.168.1.2:8080）。
② 将对敏感网站（如特定新闻网站、论坛）的访问通过 Tor SOCKS 代理（127.0.0.1:9050）。
③ 本地地址直连，不通过任何代理。
配置文件片段 (privoxy.cfg)：
1
# 监听地址和端口
2
listen-address 0.0.0.0:8118
3
4
# 访问控制
5
deny all
6
permit 127.0.0.1
7
permit 192.168.1.0/24
8
9
# 默认转发规则：将所有非本地流量发送到上游 HTTP 代理
10
forward / 192.168.1.2:8080
11
12
# 阻止对本地地址的请求通过代理转发 (如 C2 示例所示)
13
dont-proxy-requests localhost
14
dont-proxy-requests 127.*.*.*
15
# ... 其他本地地址范围 ...
16
17
# 加载动作文件
18
actionsfile default.action
19
actionsfile user.action
用户自定义动作文件片段 (user.action)：
1
# user.action 文件片段
2
3
# 将对敏感网站 example.com 和 anothersite.org 的请求通过 Tor SOCKS 代理转发
4
# 注意：动作文件中的转发规则会覆盖 privoxy.cfg 中的全局 forward 规则
5
{ +forward-socks5 127.0.0.1:9050 }
6
.sensitive-news.com
7
.private-forum.org
8
9
# 您还可以定义其他规则，例如：
10
# 阻止访问某个恶意网站
11
{ +block }
12
.malicious-site.net
13
14
# 移除某个网站的特定头部
15
{ +hide-header{Referer} }
16
.social-tracker.com
解释：
① forward / 192.168.1.2:8080: 在 privoxy.cfg 中设置了一个默认转发规则。/ 表示匹配所有 URL，将其转发到 192.168.1.2 的 8080 端口。这是“默认”路径。
② dont-proxy-requests: 确保本地流量不走任何代理。
③ { +forward-socks5 127.0.0.1:9050 } 在 user.action 文件中：这是一个动作列表，应用于匹配的模式。当访问 .sensitive-news.com 或 .private-forum.org 时，Privoxy 会应用此动作，将请求通过 Tor SOCKS 代理转发。重要提示： 动作文件中针对特定模式设置的转发动作（如 +forward 或 +forward-socks）会覆盖 privoxy.cfg 中针对这些模式更宽泛的默认转发规则。这意味着对 .sensitive-news.com 的请求会走 Tor，而不是 192.168.1.2:8080。
④ 其他动作：示例中还展示了如何在 user.action 中添加阻塞 (+block) 或头部修改 (+hide-header) 等其他规则，这些规则会与转发规则一起按顺序处理（取决于 Privoxy 的内部处理逻辑和动作的优先级）。
通过组合 privoxy.cfg 中的全局转发设置和 .action 文件中的规则化转发及其他动作，您可以实现非常灵活和精细的流量控制和隐私保护策略。
这些示例提供了 Privoxy 配置的起点。在实际应用中，您需要根据详细需求和网络环境仔细调整 listen-address、permit/deny 规则，并创建或修改动作文件 (.action 和 .filter) 来实现所需的过滤和转发行为。始终建议在修改配置后重启 Privoxy 服务，并检查日志文件 (privoxy.log) 以确保配置正确加载且没有错误。
Appendix D: 术语汇编 (Glossary)
Appendix D1: 术语汇编
本书旨在全面解析 Privoxy，过程中涉及了众多网络、代理和隐私保护相关的概念与术语。本附录收录了书中出现的关键术语，并提供简洁明了的解释，以帮助读者更好地理解书本内容。
⚝ Privoxy：
▮▮▮▮⚝ 一个免费的、开源的、非缓存的网页代理（Web Proxy）软件，具有先进的过滤能力，用于增强在线隐私、屏蔽网页广告、管理 Cookie 以及修改网页数据和 HTTP 头部。它的设计目标是小型、快速、轻量级。
⚝ 代理服务器 (Proxy Server)：
▮▮▮▮⚝ 充当客户端（如浏览器）和服务器之间的中间人的计算机系统或应用程序。客户端的请求首先发送给代理服务器，代理服务器再将请求发送给目标服务器；目标服务器的响应也先到达代理服务器，再转发给客户端。代理可以用于多种目的，如缓存、过滤、安全、匿名等。
⚝ 非缓存代理 (Non-Caching Proxy)：
▮▮▮▮⚝ 一种不将从目标服务器获取的网页内容存储在本地以供后续请求使用的代理服务器。Privoxy 属于此类，它专注于内容过滤和修改，而不是提高访问速度。
⚝ 过滤 (Filtering)：
▮▮▮▮⚝ 在网络流量通过代理时，根据预设的规则检查并修改、阻止或允许特定内容的活动。Privoxy 的核心功能即是强大的过滤。
⚝ 动作文件 (Action Files)：
▮▮▮▮⚝ Privoxy 用于定义过滤规则和行为的文本文件集合。它们包含模式（Pattern）和相应的动作（Action），指定了当请求匹配某个模式时，Privoxy 应该执行的操作。
⚝ 规则 (Rules)：
▮▮▮▮⚝ 在动作文件中定义的，将特定模式与一个或多个动作关联起来的指令。例如，一条规则可以指定当访问某个广告域名时，阻止该请求。
⚝ 配置 (Configuration)：
▮▮▮▮⚝ 设置软件或系统参数使其按照预期方式运行的过程。Privoxy 的主要配置通过编辑其主配置文件 privoxy.cfg 和各种动作文件来实现。
⚝ HTTP：
▮▮▮▮⚝ 超文本传输协议（Hypertext Transfer Protocol），是互联网上应用最为广泛的一种网络协议，用于客户端和服务器之间传输超文本，如 HTML 文件。Privoxy 主要处理 HTTP 流量。
⚝ HTTPS：
▮▮▮▮⚝ 超文本传输安全协议（Hypertext Transfer Protocol Secure），是 HTTP 的安全版本，通过 SSL/TLS 对通信进行加密，确保数据传输的机密性和完整性。Privoxy 对 HTTPS 的处理方式与 HTTP 有所不同。
⚝ CONNECT 方法 (CONNECT Method)：
▮▮▮▮⚝ HTTP 协议中的一个方法，客户端使用它来建立一个隧道（Tunnel）连接到代理服务器，然后通过这个隧道与目标服务器建立一个加密的（通常是 SSL/TLS）连接。HTTPS 流量通常使用 CONNECT 方法。
⚝ SSL 解密 (SSL Decryption)：
▮▮▮▮⚝ 也称为 HTTPS 解密或 SSL 拦截，指代理服务器在将加密的 HTTPS 流量转发到客户端之前，对其进行解密、检查（如进行内容过滤或安全扫描）然后再重新加密的过程。Privoxy 默认不进行 SSL 解密，因此对加密流量的内容过滤能力有限。
⚝ 透明代理 (Transparent Proxy)：
▮▮▮▮⚝ 一种代理设置，其中客户端的网络流量在无需手动配置代理服务器地址和端口的情况下被重定向到代理。通常通过网络设备的规则（如路由器上的防火墙规则）实现。
⚝ privoxy.cfg：
▮▮▮▮⚝ Privoxy 的主配置文件，用于设置监听地址、端口、访问控制、日志、转发代理等全局或基础配置项。
⚝ listen-address：
▮▮▮▮⚝ privoxy.cfg 文件中的一个指令，用于指定 Privoxy 监听的网络接口和端口号。例如 listen-address 127.0.0.1:8118 表示仅在本地环回地址的 8118 端口监听。
⚝ permit/deny：
▮▮▮▮⚝ privoxy.cfg 文件中的访问控制指令，用于指定允许或拒绝哪些客户端 IP 地址连接到 Privoxy 代理。
⚝ logfile/loglevel：
▮▮▮▮⚝ privoxy.cfg 文件中的日志配置指令。logfile 指定日志文件的路径，loglevel 指定日志记录的详细程度。
⚝ forward/forward-socks：
▮▮▮▮⚝ privoxy.cfg 文件中的转发代理指令。forward 用于将请求转发到另一个 HTTP 代理，而 forward-socks 用于将请求转发到 SOCKS 代理（如 Tor）。
⚝ toggle：
▮▮▮▮⚝ privoxy.cfg 文件中的一个指令，用于全局开启或关闭 Privoxy 的某些特定功能，如过滤。也可以通过 Privoxy 的 Web 界面或控制端口动态切换。
⚝ .action file：
▮▮▮▮⚝ Privoxy 用于定义过滤规则的文本文件的后缀名，如 default.action、user.action。
⚝ 模式匹配 (Pattern Matching)：
▮▮▮▮⚝ 在动作文件中用来描述要匹配的 URL、域名、请求头部或响应内容的方法。Privoxy 支持多种模式匹配语法，包括通配符和正则表达式。
⚝ 正则表达式 (Regular Expressions)：
▮▮▮▮⚝ 一种强大的字符串模式匹配工具，使用特殊字符序列来定义搜索模式。Privoxy 支持 POSIX 扩展正则表达式，用于更灵活和复杂的模式匹配。
⚝ 动作类型 (Action Types)：
▮▮▮▮⚝ 在动作文件中与模式关联的操作类型，定义了当模式匹配时 Privoxy 应该执行的具体行为。例如，+block 是一种动作类型。
⚝ +block / -block：
▮▮▮▮⚝ 动作类型。+block 表示阻止匹配的请求或内容加载；-block 表示取消之前的 +block 动作（规则优先级更高者生效）。
⚝ +filter / -filter：
▮▮▮▮⚝ 动作类型。+filter 用于激活指定的内置或自定义过滤器，对匹配的请求或响应内容进行修改；-filter 取消激活。
⚝ +hide-headers / +change-x-forwarded-for 等：
▮▮▮▮⚝ 用于修改或移除 HTTP 请求/响应头部的动作类型。例如，+hide-headers 可以移除某些敏感头部，+change-x-forwarded-for 可以修改 X-Forwarded-For 头部以增强隐私。
⚝ +redirect：
▮▮▮▮⚝ 动作类型。将匹配的请求重定向到另一个指定的 URL。
⚝ +session-cookies / +force-remote-cookies 等：
▮▮▮▮⚝ 用于控制网站 Cookie 行为的动作类型。例如，+session-cookies 尝试将持久性 Cookie 转换为会话 Cookie。
⚝ default.action：
▮▮▮▮⚝ Privoxy 提供的默认动作文件，包含了大量预设的过滤规则，是理解 Privoxy 过滤功能的良好起点。
⚝ 广告屏蔽 (Ad Blocking)：
▮▮▮▮⚝ 利用过滤规则阻止网页上的广告内容（图片、脚本、iframe 等）加载或显示。Privoxy 是一个有效的广告屏蔽工具。
⚝ 追踪器屏蔽 (Tracker Blocking)：
▮▮▮▮⚝ 利用过滤规则阻止用于跨网站追踪用户行为的代码或请求。
⚝ User-Agent：
▮▮▮▮⚝ HTTP 请求头部的一个字段，包含关于用户使用的浏览器、操作系统等信息。修改或隐藏此头部可以增强隐私。
⚝ Referer：
▮▮▮▮⚝ HTTP 请求头部的一个字段，包含用户从哪个页面链接到当前页面的信息。移除此头部可以防止网站知道用户来自哪里。
⚝ 链式代理 (Chaining Proxies)：
▮▮▮▮⚝ 将多个代理服务器串联起来使用，请求依次通过每个代理转发，直到到达目标服务器。例如，Privoxy 可以配置为将请求转发到 Tor 的 SOCKS 代理。
⚝ SOCKS 代理 (SOCKS Proxy)：
▮▮▮▮⚝ 一种网络协议，通过代理服务器在客户端和目标服务器之间路由网络数据包。SOCKS 不像 HTTP 代理那样解析 HTTP 流量，它工作在比应用层更低的层次，可以处理各种类型的流量（TCP/UDP）。
⚝ Tor：
▮▮▮▮⚝ “洋葱路由”（The Onion Router）的简称，是一个免费软件和开放网络，旨在通过多层加密和随机路由来匿名化用户的互联网流量。Privoxy 常被配置为将其流量转发到 Tor 的 SOCKS 接口。
⚝ .filter file：
▮▮▮▮⚝ Privoxy 用于定义自定义内容过滤器的文本文件的后缀名。这些过滤器可以更细粒度地修改 HTML 等页面内容。
⚝ SSL 拦截代理 (SSL Interception Proxy)：
▮▮▮▮⚝ 参见“SSL 解密 (SSL Decryption)”。这类代理通常通过向客户端安装其自己的根证书来实现对 HTTPS 流量的解密和重新加密。
⚝ 日志 (Logs)：
▮▮▮▮⚝ 软件或系统记录的事件信息文件。Privoxy 的日志包含其启动信息、处理的请求、应用的规则以及发生的错误，是故障排除的重要依据。
⚝ 规则冲突 (Rule Conflict)：
▮▮▮▮⚝ 当多条规则匹配同一个请求或内容时，由于规则的顺序或优先级不同，可能导致不确定或非预期的结果。理解 Privoxy 处理规则的顺序对于解决冲突至关重要。
⚝ 调试 (Debugging)：
▮▮▮▮⚝ 查找和解决软件或配置中错误的过程。对于 Privoxy，调试通常涉及查看日志、检查规则、以及逐步测试不同的配置。
⚝ 性能优化 (Performance Optimization)：
▮▮▮▮⚝ 调整配置或系统环境，以提高软件运行效率和响应速度的过程。对于 Privoxy，可能涉及调整缓冲区大小、限制同时连接数或优化规则集。
⚝ 开源 (Open Source)：
▮▮▮▮⚝ 指软件的源代码是公开可用的，任何人都可以查看、修改和分发，但通常需要遵守特定的许可条款。Privoxy 是一个开源项目。
⚝ VPN：
▮▮▮▮⚝ 虚拟私人网络（Virtual Private Network），通过公共网络（如互联网）建立加密的连接，使用户可以在不受信任的网络上安全地传输数据。Privoxy 可以与 VPN 结合使用，以增强隐私和安全性。
Appendix E: 附录 E：参考文献与进一步阅读
本书旨在为读者提供一份全面且深入的 Privoxy 使用指南。本附录列出了本书撰写过程中参考的关键资料，并推荐一些重要的资源，帮助有兴趣的读者进一步深入学习 Privoxy、相关的网络技术、隐私保护概念以及更广阔的互联网安全领域知识。不断学习和实践是掌握这些技术的关键。
Appendix E1: Privoxy 官方与核心资源 (Official & Core Privoxy Resources)
这些是获取关于 Privoxy 本身最权威和最直接信息的来源。对于理解 Privoxy 的工作原理、最新功能和准确配置至关重要。
⚝ Privoxy 官方网站 (Official Website)
▮▮▮▮⚝ 网址: https://www.privoxy.org/
▮▮▮▮⚝ 内容: 这是 Privoxy 项目的主页。包含了项目新闻、下载链接、文档入口、常见问题解答 (FAQ) 等。是获取 Privoxy 软件本身和基本信息的首要途径。
▮▮▮▮⚝ 价值: 初学者应从此开始，获取软件和官方文档。高级用户可以通过新闻了解项目动态。
⚝ Privoxy 用户手册 (User Manual)
▮▮▮▮⚝ 网址: https://www.privoxy.org/user-manual/
▮▮▮▮⚝ 内容: 这是 Privoxy 最重要的官方文档，详细解释了所有配置指令、动作文件语法、模式匹配规则、过滤器编写方法等。虽然内容丰富，但可能对初学者稍显技术化。
▮▮▮▮⚝ 价值: 这是所有 Privoxy 用户的必备参考。无论是基础配置还是高级定制，都离不开查阅用户手册。
⚝ Privoxy 源代码库 (Source Code Repository)
▮▮▮▮⚝ 网址: 通常在 SourceForge 或其他开源托管平台，具体链接可在官网找到。
▮▮▮▮⚝ 内容: Privoxy 的全部源代码。
▮▮▮▮⚝ 价值: 对于希望深入了解 Privoxy 内部工作机制、贡献代码或自行编译的用户来说，这是最权威的资源。
⚝ Privoxy 邮件列表 (Mailing Lists)
▮▮▮▮⚝ 网址: 通常可以在官网上找到订阅和存档链接。
▮▮▮▮⚝ 内容: 主要包括 privoxy-users (用户讨论与求助) 和 privoxy-devel (开发者讨论)。
▮▮▮▮⚝ 价值: 在遇到手册无法解决的问题时，可以在 privoxy-users 列表中提问或搜索历史讨论。对于希望参与项目开发或了解更深层技术细节的用户，privoxy-devel 列表非常有价值。
Appendix E2: 深入理解基础技术 (Understanding Underlying Technologies)
Privoxy 是一个 HTTP/HTTPS 代理，它的功能与这些协议以及底层的网络通信紧密相关。理解这些基础知识能帮助你更好地配置和使用 Privoxy。
⚝ HTTP 协议规范 (HTTP Protocol Specifications)
▮▮▮▮⚝ 内容: 主要参考 IETF (互联网工程任务组) 发布的 RFC (Request for Comments)。特别是关于 HTTP/1.1 的 RFC 2616 (已废弃，但仍有参考价值) 以及更现代的 RFC 7230-7235 系列。对于 CONNECT 方法，RFC 7231 的 4.3.6 节是核心。
▮▮▮▮⚝ 价值: 理解 HTTP 请求头 (Request Headers)、响应头 (Response Headers)、请求方法 (Request Methods)、状态码 (Status Codes) 等是理解 Privoxy 过滤和修改规则的基础。
⚝ HTTPS/TLS/SSL 原理 (HTTPS/TLS/SSL Principles)
▮▮▮▮⚝ 内容: 了解 TLS (Transport Layer Security) / SSL (Secure Sockets Layer) 握手过程 (Handshake Process)、证书验证 (Certificate Validation)、加密通信 (Encrypted Communication) 的基本原理。
▮▮▮▮⚝ 价值: 这有助于理解为什么 Privoxy 在处理 HTTPS 流量时存在局限性，以及 CONNECT 方法的作用。
⚝ SOCKS 协议 (SOCKS Protocol)
▮▮▮▮⚝ 内容: 特别是 SOCKS5 (RFC 1928)。
▮▮▮▮⚝ 价值: 理解 SOCKS 协议有助于配置 Privoxy 进行链式代理 (Chaining Proxy)，例如与 Tor 网络集成。
⚝ HTML, CSS, JavaScript 与 DOM (Document Object Model)
▮▮▮▮⚝ 内容: 网页前端技术的基础知识。
▮▮▮▮⚝ 价值: Privoxy 的一些内容过滤 (Content Filtering) 功能（特别是使用过滤器修改页面内容）与这些技术相关。了解它们能帮助你编写更有效的过滤规则。
Appendix E3: 拓展阅读与相关领域 (Extended Reading & Related Fields)
这些资源提供了更广阔的视野，涵盖了与 Privoxy 目标相关或功能互补的技术和理念。
⚝ 网络隐私与追踪技术 (Online Privacy & Tracking Technologies)
▮▮▮▮⚝ 内容: 了解常见的在线追踪技术，如 Cookie、浏览器指纹 (Browser Fingerprinting)、网络信标 (Web Beacons) 等，以及隐私保护原则和最佳实践。
▮▮▮▮⚝ 价值: 这能帮助你理解 Privoxy 提供的隐私增强功能是为了对抗哪些具体的追踪手段，从而更好地利用这些功能。
⚝ 广告屏蔽原理与实现 (Ad Blocking Principles & Implementations)
▮▮▮▮⚝ 内容: 研究不同的广告屏蔽技术，如基于域名/URL 列表、元素隐藏 (Element Hiding)、内容脚本注入等。了解 Adblock Plus 等流行广告屏蔽工具的过滤规则语法 (Filter Rule Syntax)。
▮▮▮▮⚝ 价值: Privoxy 的过滤规则与一些广告屏蔽工具的规则有相似之处，学习这些能启发你编写更高效的广告和追踪器屏蔽规则。
⚝ 其他代理软件与网络过滤工具 (Other Proxy Software & Network Filtering Tools)
▮▮▮▮⚝ 内容: 了解如 Squid (更强大的缓存和转发代理)、Nginx (可配置为反向/正向代理)、AdGuard Home (DNS 过滤为主)、uBlock Origin/Adblock Plus (浏览器扩展) 等工具的功能和特点。
▮▮▮▮⚝ 价值: 对比了解不同的工具能帮助你选择最适合特定场景的解决方案，或者考虑如何将 Privoxy 与其他工具结合使用。
⚝ Tor 网络 (Tor Network)
▮▮▮▮⚝ 内容: 了解 Tor 的工作原理，如何提供匿名性，以及其 SOCKS 代理接口。
▮▮▮▮⚝ 价值: 这是 Privoxy 常用的链式代理目标之一。深入了解 Tor 能帮助你更好地配置 forward-socks 并理解其匿名性原理及限制。
Appendix E4: 社区与支持 (Community & Support)
积极参与相关社区能为你提供帮助，也能让你了解最新的发展和技巧。
⚝ 相关的技术论坛和问答网站 (Relevant Technical Forums & Q&A Sites)
▮▮▮▮⚝ 例如: Stack Overflow (特别是关于网络、HTTP、代理相关的问题)、Server Fault (关于服务器配置和管理)、Reddit 上相关的技术社区 (如 r/privacy, r/sysadmin 等)。
▮▮▮▮⚝ 价值: 在这些平台上搜索你遇到的问题，往往能找到解决方案。提问时详细描述你的环境和遇到的错误，更容易获得有效帮助。
⚝ 博客和技术文章 (Blogs & Technical Articles)
▮▮▮▮⚝ 内容: 许多技术博客、安全研究网站会发布关于网络代理、隐私保护、广告追踪技术或特定工具（包括 Privoxy）的使用心得、教程和分析文章。
▮▮▮▮⚝ 价值: 这些文章通常更侧重于实际应用和案例分析，是学习高级技巧和解决特定问题的良好补充。
不断探索这些资源，结合本书提供的系统知识，你将能够更全面地掌握 Privoxy，并将其作为你网络隐私保护和流量控制的强大工具。