wuchangming/node-mitmproxy

node-mitmproxy is an extensible man-in-the-middle(MITM) proxy server for HTTP/HTTPS base on Node.js.

node-mitmproxy 3.x

node-mitmproxy是一个基于nodejs，支持http/https的中间人(MITM)代理，便于渗透测试和开发调试。

1、特性

1、支持https
2、支持配置的方式启动，也支持以模块的方式引入到代码中

2、安装

windows

    npm install node-mitmproxy -g

Mac

    sudo npm install node-mitmproxy -g

3、使用

关于配置文件

简单配置：

simpleConfig.js

module.exports = {
    sslConnectInterceptor: (req, cltSocket, head) => true,
    requestInterceptor: (rOptions, req, res, ssl, next) => {
        console.log(`正在访问：${rOptions.protocol}//${rOptions.hostname}:${rOptions.port}`);
        console.log('cookie:', rOptions.headers.cookie);
        res.end('hello node-mitmproxy!');
        next();
    }
};

效果图：

详细配置说明
更多例子

启动方式

node-mitmproxy -c simpleConfig.js

安装node-mitmproxy CA根证书

生成CA根证书的默认路径：%用户名%/node-mitmproxy

PC下安装根证书方式

Mac

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/node-mitmproxy/node-mitmproxy.ca.crt

windows

注: 证书需要安装到 ** 受信任的根证书目录 ** 下
参考 issues#3

start %HOMEPATH%/node-mitmproxy/node-mitmproxy.ca.crt

以nodejs模块的方式引用到代码中

var mitmproxy = require('node-mitmproxy');

mitmproxy.createProxy({
    sslConnectInterceptor: (req, cltSocket, head) => true,
    requestInterceptor: (rOptions, req, res, ssl, next) => {
        console.log(`正在访问：${rOptions.protocol}//${rOptions.hostname}:${rOptions.port}`);
        console.log('cookie:', rOptions.headers.cookie);
        res.end('Hello node-mitmproxy!');
        next();
    },
    responseInterceptor: (req, res, proxyReq, proxyRes, ssl, next) => {
        next();
    }
});

4、配置详细说明

port

启动端口（默认：6789）

    port: 6789

sslConnectInterceptor

判断该connnect请求是否需要代理，传入参数参考http connnect 。

    sslConnectInterceptor: (clientReq, clientSocket, head) => true,

requestInterceptor

拦截客户端请求/响应

参数说明：
1、requestOptions：客户端请求参数
2、clientReq: 客户端请求，参考http.IncomingMessage
3、clientRes: 客户端响应，参考http.ServerResponse
4、ssl: 该请求是否为https
5、next: 回调函数，执行完拦截逻辑后调用该方法

    requestInterceptor: (requestOptions, clientReq, clientRes, ssl, next) => {
        next();
    }

responseInterceptor

拦截服务端请求/响应
参数说明：

1、clientReq: 客户端请求，参考http.IncomingMessage
2、clientRes: 客户端响应，参考http.ServerResponse
3、proxyReq: 服务端请求，参考http.IncomingMessage
4、proxyRes: 服务端响应，参考http.ServerResponse
5、ssl: 该请求是否为https
6、next: 回调函数，执行完拦截逻辑后调用该方法

    responseInterceptor: (clientReq, clientRes, proxyReq, proxyRes, ssl, next) => {
        next();
    }

caCertPath

CA根证书路径(ps: 无特殊情况无需配置)
默认：%HOMEPATH%/node-mitmproxy/node-mitmproxy.ca.crt

caCertPath: 'xxxx/xxxx.crt'

caKeyPath

CA根证书密钥路径(ps: 无特殊情况无需配置)
默认：%HOMEPATH%/node-mitmproxy/node-mitmproxy.ca.key.pem

caKeyPath: 'xxxx/xxxx.pem'

5、更多

关于伪造https证书的逻辑图

node-mitmproxy's Issues

mac os 下生成ca证书报错

MacBook-Pro:~ chke$ node-mitmproxy createCA
undefined
internal/validators.js:125
throw new ERR_INVALID_ARG_TYPE(name, 'string', value);
^

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received type undefined
at validateString (internal/validators.js:125:11)
at Object.resolve (path.js:1080:7)
at Object. (/usr/local/lib/node_modules/node-mitmproxy/lib/bin/index.js:21:23)
at Module._compile (internal/modules/cjs/loader.js:721:30)
at Object.Module._extensions..js (internal/modules/cjs/loader.js:732:10)
at Module.load (internal/modules/cjs/loader.js:620:32)
at tryModuleLoad (internal/modules/cjs/loader.js:560:12)
at Function.Module._load (internal/modules/cjs/loader.js:552:3)
at Function.Module.runMain (internal/modules/cjs/loader.js:774:12)
at executeUserCode (internal/bootstrap/node.js:342:17)

IOS 13 无法使用

IOS 13 在通用-描述文件-xx 信任后，访问网页出现

求助~

not support NTLM-Authentication

iOS10.3.1，新生成的根证书问题

新生成的跟证书无法被信任，Certificate Unknown

Frame 44: 73 bytes on wire (584 bits), 73 bytes captured (584 bits) on interface 0
Ethernet II, Src: Hillston_ff:08:09 (00:1c:54:ff:08:09), Dst: Apple_80:79:5d (ac:bc:32:80:79:5d)
    Destination: Apple_80:79:5d (ac:bc:32:80:79:5d)
    Source: Hillston_ff:08:09 (00:1c:54:ff:08:09)
        Address: Hillston_ff:08:09 (00:1c:54:ff:08:09)
        .... ..0. .... .... .... .... = LG bit: Globally unique address (factory default)
        .... ...0 .... .... .... .... = IG bit: Individual address (unicast)
    Type: IPv4 (0x0800)
Internet Protocol Version 4, Src: 192.168.27.55, Dst: 192.168.87.121
Transmission Control Protocol, Src Port: 56239 (56239), Dst Port: 9888 (9888), Seq: 486, Ack: 1974, Len: 7
Hypertext Transfer Protocol
    [Proxy-Connect-Hostname: m.baidu.com]
    [Proxy-Connect-Port: 443]
Secure Sockets Layer
    TLSv1.2 Record Layer: Alert (Level: Fatal, Description: Certificate Unknown)
        Content Type: Alert (21)
        Version: TLS 1.2 (0x0303)
        Length: 2
        Alert Message
            Level: Fatal (2)
            Description: Certificate Unknown (46)

关于node-mitmproxy在Android手机端访问https的问题

http没有问题，部分https返回正常，但部分https会报错，错误如下

(node:19245) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: Cannot read public key. OID is not RSA.

//js 配置如下
sslConnectInterceptor: (req, cltSocket, head) => true,
caCertPath: '/Users/mac/node-mitmproxy/node-mitmproxy.ca.crt',
caKeyPath: '/Users/mac/node-mitmproxy/node-mitmproxy.ca.key.pem',

Android手机已经安装了对应的证书crt

windows下无法使用

安装的是0.1.0 版本
启动后，浏览器代理设置到127.0.0.1:6789，不能使用

1. chrome中提示无效的证书
2. 打不开cnodejs.org

好你，请问怎么得到https服务器的response中body的内容呢？

作者你好，请问怎么从https服务器响应的response中得到返回的内容呢？我试了很多种方法都不行。
在res.on("data", (chunk)=>{})得到的内容都是乱码。
我的目标服务器返回的是一个JSON字串，使用Fidder能看到返回的内容，但是使用您的模块不知道怎么取得response的body内容，还希望能解惑，谢谢。

how can i use other res as response？

我想请求一个地址例如
https://xxx.abc.com/ckd/
然后在responseInterceptor把我�透明传输本地的一个响应过来

const mitmproxyConfig = {
  sslConnectInterceptor: (req, cltSocket, head) => {
    console.log('head', head)
    return true
  },
  requestInterceptor: (rOptions, req, res, ssl, next) => {
    console.log(`正在访问：${rOptions.protocol}//${rOptions.hostname}:${rOptions.port}`)
    console.log('cookie:', rOptions.headers.cookie)

    // res.end('Hello node-mitmproxy!')
    next()
  },
  responseInterceptor: (req, res, proxyReq, proxyRes, ssl, next) => {
    req.pipe(request('http://localhost:9850/ckd')).pipe(res)
    next()
  },
}

mitmproxy.createProxy(mitmproxyConfig)

但是这样的话一直报错 uncaughtException: Error: write after end

我怎么能做到这一点呢

NSURLSession/NSURLConnection HTTP load failed (kCFStreamErrorDomainSSL, -9802)

Safari 通过代理访问https://github.com,

报错：
4/12/16 9:52:51.191 PM com.apple.WebKit.Networking[76466]: NSURLSession/NSURLConnection HTTP load failed (kCFStreamErrorDomainSSL, -9802)

Error: read ECONNRESET

错误信息：

events.js:167
      throw er; // Unhandled 'error' event
      ^

Error: read ECONNRESET
    at TCP.onread (net.js:656:25)
Emitted 'error' event at:
    at Socket.onerror (_stream_readable.js:687:12)
    at Socket.emit (events.js:182:13)
    at emitErrorNT (internal/streams/destroy.js:82:8)
    at emitErrorAndCloseNT (internal/streams/destroy.js:50:3)

复现场景：
在开启代理后，在百度随便搜索字符，奔溃

版本：3.1.0

怎么拦截客户端请求并修改参数

现在想拦截一个客户端发起的api，想手动更改里面的参数。
并把相应代码写在requestInterceptor里.
req.write没有这个方法

如何获取POST请求的body

在responseInterceptor中要怎么获取POST请求的body

how can i use it with request

throught this package , i am able to hook https request . but can i use request package to send a request through an existing proxy server?

based on your demo code:

var mitmproxy = require('node-mitmproxy');

mitmproxy.createProxy({
    sslConnectInterceptor: (req, cltSocket, head) => true,
    requestInterceptor: (rOptions, req, res, ssl, next) => {
        console.log(`正在访问：${rOptions.protocol}//${rOptions.hostname}:${rOptions.port}`);
        console.log('cookie:', rOptions.headers.cookie);
        res.end('Hello node-mitmproxy!');
        next();
    },
    responseInterceptor: (req, res, proxyReq, proxyRes, ssl, next) => {
        next();
    }
});

在浏览器的设置中查看‘’管理证书‘’，该证书已经在‘’受信任的颁发机构‘’里面，但是访问‘’https://localhost:6789‘’还是不行

它并没有反馈‘’使用了不受支持的协议‘’，只是说‘’localhost 意外终止了连接。‘’

为什么我按照你那个simple 配置，https无法访问

老大，有没有什么企鹅群呢？

如题

未支持 WebSocket connection: wss

为什么https时responseInterceptor中得到客户端IP（req.socket中得到）总是127.0.0.1呢？

想在responseInterceptor中得到代理客户端的IP，在http时能通过req.socket中得到，但是在https时，得到的全是127.0.0.1了，无法得到客户端的IP。

请问怎么在https时得到请求客户端的IP信息？

生成的CA证书可否默认放在~/.node-mitmproxy下

目前是默认放在~/node-mitmproxy下，在Mac上类似这种文件一般会放在~/.node-mitmproxy下，这样作为隐藏文件，在ls的时候能保证目录的干净。虽然没有什么大的影响，但强迫症患者会有点难受

UBUNTU下证书不可用

该怎么搞。还有如果想再通过另一个代理发送请求怎么办

这个安装只能用全局安装吗？

不能单独安装在某个包里 ？

证书在哪里呢

install -g 之后到处都没有找到证书
node-mitmproxy createCA 命令也报错，好像并没有这个命令

为什么我拦截的时候是乱码，你拦截的时候就是正常的，有什么特殊处理吗？