# mitmproxy-plugins

**Repository Path**: yanjingtu/mitmproxy-plugins

## Basic Information

- **Project Name**: mitmproxy-plugins
- **Description**: 基于mitmproxy（一个python的https代理框架）的一些扩展，大部分其实可能有更好的方案
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mitmproxy-plugins

一组基于 [mitmproxy](https://mitmproxy.org/) 的实用代理插件，按规则在请求阶段短路拦截或做访问控制，并对放行流量做全量流式转发（不缓存完整 body）。

## 插件列表

| 插件 | 目录 | 功能 |
| --- | --- | --- |
| 通用广告 / 追踪拦截 | [`adblock/`](adblock/) | 按 URL 规则（裸域名 / 路径子串 / 正则）拦截广告与追踪请求，命中即返回 204/403/透明 GIF，名单热重载 |
| bilibili 视频访问控制 | [`bilibili/`](bilibili/) | 按 UP主 UID 白名单拦截不在名单内的 bilibili 视频请求（播放页 / playurl 接口 / CDN 媒体流），白名单热重载 |

## 共同特性

- **请求级短路拦截**：命中即直接构造响应，不发起上游连接、不接收响应 body。
- **名单热重载**：规则 / 白名单文件修改后自动重新加载（按 mtime，最多每秒检查一次），无需重启 mitmproxy。
- **全量流式转发**：其余响应全部 `flow.response.stream = True` 逐块转发，内存占用极低。
- **兼容旧版 Python 与 mitmproxy**：Python 3.4+，`http.Response` / `http.HTTPResponse` 兼容 shim，已通过 <6 的旧版 mitmproxy。

## 环境要求

```bash
pip install mitmproxy
```

> 插件涉及的站点基本都是 HTTPS，客户端需安装 mitmproxy 的 CA 证书才能解密流量、匹配具体 URL：<https://docs.mitmproxy.org/stable/concepts-certificates/>

## 快速启动

```bash
# 仅加载广告拦截
mitmdump -s adblock/adblock.py

# 仅加载 bilibili 白名单
mitmdump -s bilibili/bilibili_guard.py

# 同时加载
mitmdump -s bilibili/bilibili_guard.py -s adblock/adblock.py
```

各插件的详细用法、配置项与规则语法见各自目录下的 `README.md`。