Socks5/HTTP 代理工具，支持 MITM 和二次开发。用于家庭网关限制小朋友上网，域名/地址/设备拦截。

• HTTP 代理 + Socks5（可开启 TLS）代理
• 域名拦截、URL 正则匹配、MAC 地址定向拦截
• 按时间段和星期拦截
• macOS 客户端，支持配置分流规则

快速开始

方式一：npx 直接启动（无需安装）

npx block-proxy

方式二：全局安装后启动

npm install -g block-proxy
block-proxy

方式三：带自定义 MITM 规则启动

编写 rule.js（参考 example/rule.js），通过 -c 参数加载：

npx block-proxy -c rule.js

规则文件导出规则组对象，每个规则组包含一组拦截规则，支持 beforeSendRequest 和 beforeSendResponse 两种类型。

方式四：Docker（推荐长期运行）

docker run --init -d --restart=unless-stopped \
  -e TZ=Asia/Shanghai --network=host \
  --name block-proxy \
  crpi-x1zji86f6jpcd7t1.cn-hangzhou.personal.cr.aliyuncs.com/lijing00333/block-proxy:latest

首次启动后访问 http://代理IP:8003 进入后台配置面板。访问http://代理IP:8001 查看机器运行水位。

端口说明

端口	说明	可否关闭
8001	HTTP 代理端口	不可
8002	Socks5 over TLS 代理端口	可
8003	后台配置面板	可

开发

pnpm i
npm run dev       # 开发模式（含 React HMR，端口 3000）
npm run start     # 生产启动
npm run proxy     # 仅启动代理，不开后台面板

更多文档

详见 Useage.md —— 服务端部署、HTTP/SOCKS5 代理配置、MITM 证书安装、拦截规则、macOS 客户端使用等完整用户手册。

License

MIT