一、安装

请按照您的操作系统的步骤进行操作。

1、苹果系统

macOS上安装mitmproxy的推荐方法是使用Homebrew

brew install mitmproxy

或者,您可以在mitmproxy.org上下载独立的二进制文件。

2、Linux

Linux上安装mitmproxy推荐的方法是下载的独立二进制代码mitmproxy.org

一些Linux发行版通过其本机软件包存储库提供社区支持的mitmproxy软件包(例如,Arch Linux,Debian,Ubuntu,Kali Linux,OpenSUSE等)。我们不参与下游包装工作的维护,它们通常落后于当前的mitmproxy版本。请直接与资源库维护者联系以解决本机软件包的问题。

3、Windos

WSL(适用于Linux的Windows子系统)完全支持所有mitmproxy工具。我们建议 安装WSL,然后按照Linux上的mitmproxy安装说明进行操作。

我们还为除mitmproxy控制台应用程序(仅在WSL下运行)以外的所有工具分发了本机Windows软件包。要在Windows上安装mitmproxy,请从mitmproxy.org下载安装程序。安装后,您将在开始菜单中找到mitmwebmitmdump的快捷方式。这两个可执行文件都添加到您的PATH中,并且可以从命令行调用。

二、进阶安装

1、开发设置

如果您想直接从源代码或GitHub master分支安装mitmproxy,请参阅 GitHub上的自述文件

2、通过Python软件包索引(PyPI)安装

如果您的mitmproxy插件需要安装其他Python软件包,则可以从PyPI安装mitmproxy

虽然1周围有很多选项,但我们建议使用pipx进行安装:

  • 安装最新版本的Python(我们至少需要3.6)。
  • 安装pipx。
  • pipx install mitmproxy

要安装其他Python软件包,请运行pipx inject mitmproxy <your-package-name>

3、Docker映像

您可以使用来自DockerHub的官方mitmproxy映像 。

二进制程序包的安全注意事项

我们预编译的二进制软件包和Docker映像包括一个自包含的Python 3环境,支持ALPNHTTP/2OpenSSL最新版本,以及其他编译和安装起来会很麻烦的依赖项。

二进制软件包中的依赖项在发布时被冻结,并且不能就地更新。这意味着我们必须捕获可能存在的任何错误或安全问题。通常,我们不会仅仅为了更新依赖关系而发布新的二进制程序包(尽管如果我们意识到一个非常严重的问题,我们可能会这样做)。如果您使用我们的二进制软件包,请确保定期进行更新以确保所有内容都保持最新。

作为一般原则,mitmproxy不会“phone home”,因此不会进行任何更新检查。

如果您熟悉Python生态系统,则可能知道有多种安装Python软件包的方法。它们中的大多数(pip,virtualenv,pipenv等)应该可以正常工作,但是我们没有能力为其提供支持。