要让 Apache 通过 mod_ext_filter 调用 Python 脚本实时处理响应体，必须关闭 EnableSendfile Off 和 EnableMMAP Off，严格按 FilterDeclare→FilterProvider→FilterChain→SetOutputFilter 顺序配置，并确保 Python 脚本无缓冲读写、异常回退原始字节，同时设置 timeout 和 logStderr。
要让 Apache 通过 mod_ext_filter 调用 Python 脚本实时处理响应体，关键不是“写个脚本能跑”，而是确保整个数据流不中断、不截断、不绕过——Apache 默认对图片等静态资源启用内核级传输机制，会直接跳过你的过滤器。
必须关闭 sendfile 和 mmap
这是 90% 没生效的根源。Apache 对 .jpg、.png 等文件默认走 sendfile() 或 mmap()，响应体根本不经过用户态，Python 脚本根本不会被调用。
-
EnableSendfile Off—— 放在全局配置或虚拟主机块里，不能只写在 filter 定义中 -
EnableMMAP Off—— 同样需显式关闭，否则仍可能绕过 filter - 改完后重启 Apache，并用
curl -I /test.jpg确认响应头不含X-Sendfile或类似字段
正确声明并绑定过滤器链
mod_ext_filter 不是“配了命令就自动生效”，它依赖三步严格顺序：声明 → 提供 → 启用。漏掉任意一环都静默失败。
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 先用
FilterDeclare mywatermark定义过滤器名 - 再用
FilterProvider mywatermark resp=Content-Type $image/jpeg绑定 MIME 类型（注意大小写和完整值，image/jpg≠image/jpeg） - 接着用
FilterChain mywatermark激活调度器 - 最后用
<FilesMatch "\.(jpg|jpeg|png)$"> SetOutputFilter mywatermark </FilesMatch>在上下文中启用
Python 脚本必须严守二进制流契约
Apache 把响应体原始字节通过 stdin 传入，期望你原样或修改后从 stdout 输出——任何额外输出、缓冲延迟、中途退出都会导致浏览器收到乱码或“损坏图像”。
立即学习“Python免费学习笔记（深入）”；
- 开头加
#!/usr/bin/env python3 -u（-u强制无缓冲） - 读取用
sys.stdin.buffer.read()，别用sys.stdin.read() - 水印失败时（如 PIL 打不开损坏图），必须 fallback 输出原始输入字节，不能空输出或抛异常
- 测试时先脱离 Apache：运行
cat test.jpg | ./watermark.py > out.jpg，比对输入输出字节长度是否一致
加超时和错误日志，防止单请求拖垮服务
每个请求都会 fork 一个新 Python 进程，PIL 处理一张 2MB 图片在普通服务器上常耗 300–800ms。10 并发就可能卡死 worker。
- 必须设置
ExtFilterDefine ... timeout=5（单位秒），避免 hang 住整个连接 - 加上
ExtFilterOptions logStderr，把 Python 的 stderr 写进 Apache 错误日志，这是定位崩溃的唯一线索 - 线上高并发场景不建议直接用 Python/PIL；更现实的做法是前置 CDN 水印，或改用 Nginx + Lua（如
lua-resty-image）
