安装教程

一、安装

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

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下载安装程序。安装后，您将在开始菜单中找到mitmweb和mitmdump的快捷方式。这两个可执行文件都添加到您的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环境，支持ALPN和HTTP/2的OpenSSL最新版本，以及其他编译和安装起来会很麻烦的依赖项。

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

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

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