{"id":16735,"date":"2025-06-24T17:03:25","date_gmt":"2025-06-24T20:03:25","guid":{"rendered":"https:\/\/categoriaoutros.com.br\/?p=16735"},"modified":"2025-06-24T17:03:47","modified_gmt":"2025-06-24T20:03:47","slug":"erro-externally-managed-environment-ao-usar-pip-install-no-linux-veja-como-resolver","status":"publish","type":"post","link":"https:\/\/categoriaoutros.com.br\/?p=16735","title":{"rendered":"Erro externally-managed-environment ao usar pip install no Linux? Veja como resolver!"},"content":{"rendered":"\n

Se voc\u00ea tentou instalar um pacote Python com pip install<\/code> no seu sistema Linux e recebeu o seguinte erro:<\/p>\n\n\n\n

maria@ti01:~$ pip install getsploit
error: externally-managed-environment

\u00d7 This environment is externally managed
\u2570\u2500> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
<\/code><\/pre>\n\n\n\n
N\u00e3o se preocupe \u2014 esse erro \u00e9 normal em distribui\u00e7\u00f5es modernas como Ubuntu 22.04+<\/strong>, Debian 12+<\/strong> ou derivados, que implementam uma prote\u00e7\u00e3o chamada PEP 668<\/strong>.<\/p>\n\n\n\n
Essa prote\u00e7\u00e3o evita que pip<\/code> instale pacotes diretamente no ambiente Python do sistema<\/strong>, o que pode quebrar depend\u00eancias internas do pr\u00f3prio Linux.<\/p>\n\n\n\n
\n\n\n\n
Solu\u00e7\u00e3o 1: Use um ambiente virtual (recomendado)<\/h3>\n\n\n\n
    \n
  1. Instale o m\u00f3dulo de ambientes virtuais<\/strong> (se necess\u00e1rio): sudo apt install python3-venv python3-full<\/code><\/li>\n\n\n\n
  2. Crie um ambiente virtual em sua home<\/strong>: python3 -m venv ~\/venvs\/getsploit-env<\/code><\/li>\n\n\n\n
  3. Ative o ambiente virtual<\/strong>: source ~\/venvs\/getsploit-env\/bin\/activate<\/code><\/li>\n\n\n\n
  4. Instale o pacote desejado<\/strong>: pip install getsploit<\/code><\/li>\n\n\n\n
  5. Agora, voc\u00ea pode usar o getsploit<\/code> dentro desse ambiente. Para sair, use: deactivate<\/code><\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n
    Solu\u00e7\u00e3o 2: Use o pipx<\/code> (ideal para ferramentas de linha de comando)<\/h3>\n\n\n\n
    Se o pacote que voc\u00ea quer instalar \u00e9 um programa CLI (como o getsploit<\/code>), o pipx<\/code> \u00e9 perfeito.<\/p>\n\n\n\n
      \n
    1. Instale o pipx<\/code><\/strong>: sudo apt install pipx pipx ensurepath<\/code><\/li>\n\n\n\n
    2. Instale o pacote com pipx<\/code><\/strong>: Editarpipx install getsploit<\/code><\/li>\n<\/ol>\n\n\n\n
      O pipx<\/code> cria um ambiente virtual automaticamente e deixa o comando dispon\u00edvel globalmente. Muito pr\u00e1tico!<\/p>\n\n\n\n
      \n\n\n\n
      Solu\u00e7\u00e3o 3 (n\u00e3o recomendada): For\u00e7ar com --break-system-packages<\/code><\/h3>\n\n\n\n
      Se voc\u00ea realmente precisa instalar diretamente no sistema<\/strong> (o que n\u00e3o \u00e9 aconselh\u00e1vel), pode for\u00e7ar o pip:<\/p>\n\n\n\n
      pip install getsploit --break-system-packages
      <\/code><\/pre>\n\n\n\n
      Aten\u00e7\u00e3o:<\/strong> Isso pode causar conflitos ou corromper o Python do sistema. Use com cautela.<\/p>\n\n\n\n
      \n\n\n\n
      Conclus\u00e3o<\/h3>\n\n\n\n
      O erro externally-managed-environment<\/code> \u00e9 uma medida de seguran\u00e7a das distribui\u00e7\u00f5es Linux modernas para proteger o ambiente Python do sistema. Em vez de lutar contra ele, use:<\/p>\n\n\n\n