Base de Conhecimento

Langflow na VPS: como instalar e criar fluxos de IA

  • langflow, vps, ia, docker, nginx
  • Usuários acharam útil: 0

Do contêiner Docker ao Nginx com certificado: como instalar o Langflow num servidor próprio com login ligado, chave secreta definida e a porta 7860 fora da internet.

Por Redação Eleven Host · @robson.direitodigital · 21 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Langflow na VPS: como instalar e criar fluxos de IA

Capa da Redação Eleven Host para o tutorial: Langflow na VPS: como instalar e criar fluxos de IA Arte: Eleven Host

Langflow na VPS é instalar num servidor próprio a ferramenta visual de código aberto que monta agentes e fluxos de IA ligando blocos, e publicá-la com login, senha forte e HTTPS na frente.

O Langflow executa código no servidor, e o projeto publicou vários alertas críticos em 2026, todos com correção. Em 21/11/2026 a versão mais recente era a 1.13.3: instale a última versão, deixe o login ligado e não abra a porta 7860 direto para a internet.

O que é o Langflow

Pelo README do repositório oficial, o Langflow é uma plataforma para criar e publicar agentes e fluxos de trabalho com IA. A edição é visual, e a ferramenta traz servidores de API e de MCP embutidos, para que cada fluxo possa ser usado como ferramenta por outros aplicativos.

O site do projeto o apresenta como um construtor visual de pouco código e diz que ele trabalha com os principais modelos de linguagem. Entre os logotipos exibidos estão provedores como Anthropic, Mistral e Ollama, e bancos vetoriais como Qdrant e Weaviate.

A licença é a MIT, conforme o arquivo LICENSE do repositório.

Quem chama a IA de verdade

O Langflow organiza o fluxo; quem gera as respostas é o modelo do provedor que você configurar. A documentação chama essas credenciais de chaves de componente: elas autorizam os serviços que os blocos chamam e ficam por conta de quem usa. Elas ficam em variáveis globais ou vêm do ambiente, e o Langflow guarda o valor cifrado ou só uma referência. Apagar a variável no Langflow não revoga a chave: a troca ou exclusão é feita no painel do próprio provedor.

Para quem serve instalar no próprio servidor

Recomendamos considerar o Langflow num servidor quando uma pequena empresa, agência ou equipe de desenvolvimento quer montar um chatbot ou agente que outros sistemas chamam pela API, com os fluxos guardados sob o próprio controle. Uma VPS é um servidor virtual em que você instala o que precisa; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes.

Instalação própria pede um servidor, e a VPS da Eleven Host é um servidor virtual privado. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Requisitos do Langflow

A página de instalação pede, para o pacote Python, Python de 3.10 a 3.14 e o gerenciador uv. Como mínimo, cita processador de dois núcleos e 2 GB de RAM; como recomendado, processador de vários núcleos e pelo menos 4 GB de RAM.

Além do aplicativo Desktop e do código-fonte, a documentação traz o Docker e o pacote Python. Aqui o caminho principal é o Docker, com a instalação do próprio Docker no servidor feita conforme a documentação dele.

Segurança antes de instalar

A página de segurança do Langflow descreve a ferramenta como um ambiente de desenvolvimento e de execução de código: o editor pode rodar Python com acesso ao processo, aos arquivos e à rede do servidor, e alguns blocos executam código gerado por modelos de IA a partir do que o usuário digita. Ela avisa ainda que o controle de acesso aos fluxos não isola usuários entre si.

A falha CVE-2025-3248, de execução remota de código sem login, afetava versões abaixo da 1.3.0 e foi corrigida na 1.3.0, segundo o alerta do repositório. Em 2026, o projeto publicou outros alertas críticos, de execução de comandos e leitura de arquivos do servidor, o mais recente em 17/11/2026, e todos trazem versão corrigida. Em 21/11/2026, a versão estável mais nova era a 1.13.3, publicada em 17/11/2026.

Recomendamos instalar a versão mais recente e acompanhar os alertas do repositório. A documentação de autenticação avisa para não expor as portas do Langflow na internet sem proteção.

Como preparar as variáveis de ambiente

As imagens Docker oficiais já vêm com o login automático desligado. Com LANGFLOW_AUTO_LOGIN=false, a variável LANGFLOW_SUPERUSER_PASSWORD é obrigatória: sem ela o Langflow não inicia, e ela não pode ser a senha antiga langflow. O usuário padrão é langflow, que pode ser trocado por LANGFLOW_SUPERUSER.

A LANGFLOW_SECRET_KEY cifra dados sensíveis, como as chaves de API, e assina os tokens de login. A documentação recomenda definir a sua em produção e mostra este comando para gerar o valor:

python3 -c "from secrets import token_urlsafe; print(f'LANGFLOW_SECRET_KEY={token_urlsafe(32)}')"

Um exemplo de arquivo /opt/langflow/langflow.env, com opções que a documentação recomenda para produção, para conferir no seu servidor (troque a senha e cole a chave gerada):

LANGFLOW_AUTO_LOGIN=false

LANGFLOW_SUPERUSER_PASSWORD=troque-por-uma-senha-forte

LANGFLOW_SECRET_KEY=cole-aqui-o-valor-gerado

LANGFLOW_CONFIG_DIR=/app/langflow

LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true

LANGFLOW_ENABLE_SIGNUP=false

LANGFLOW_NEW_USER_IS_ACTIVE=false

LANGFLOW_ENABLE_SUPERUSER_CLI=false

LANGFLOW_ACCESS_SECURE=true

LANGFLOW_REFRESH_SECURE=true

A pasta precisa existir antes do arquivo. Um exemplo de comando para criá-la e deixar o arquivo legível só pelo dono:

sudo mkdir -p /opt/langflow

sudo nano /opt/langflow/langflow.env

sudo chmod 600 /opt/langflow/langflow.env

As duas últimas variáveis, segundo a documentação, valem para uso com HTTPS; por isso, o primeiro login fica para depois do certificado. A página de autenticação também recomenda restringir os blocos que executam código quando houver usuários sem confiança, com LANGFLOW_ALLOW_CUSTOM_COMPONENTS=false ou LANGFLOW_BLOCK_CODE_INTERPRETER_COMPONENTS=true.

Como instalar o Langflow com Docker

O início rápido da documentação usa a imagem langflowai/langflow:latest com a porta 7860. Pela própria documentação, sem banco externo e sem LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true, os dados do SQLite ficam dentro do contêiner e se perdem se ele for removido; apontar LANGFLOW_CONFIG_DIR para um volume guarda também a chave secreta e os arquivos enviados.

Um exemplo de comando, com volume nomeado, porta aberta só no próprio servidor (127.0.0.1) e a versão fixa, para conferir no seu servidor; confira antes a tag mais recente publicada da imagem:

sudo docker run -d --name langflow --restart unless-stopped -p 127.0.0.1:7860:7860 -v langflow-data:/app/langflow --env-file /opt/langflow/langflow.env langflowai/langflow:1.13.3

Com a porta presa ao 127.0.0.1, o painel ainda não abre de fora: quem dá acesso é o Nginx, no passo seguinte.

E o PostgreSQL?

Para guardar os dados num PostgreSQL em vez do SQLite, a documentação mostra um exemplo de Docker Compose com dois serviços, o langflow e um postgres, ligados pela variável LANGFLOW_DATABASE_URL, no formato postgresql://langflow:langflow@postgres:5432/langflow. Troque a senha do exemplo antes de usar.

Sem Docker, com uv

No pacote Python, a documentação cria um ambiente com uv venv, instala com uv pip install langflow e inicia com uv run langflow run --env-file .env, no endereço padrão http://127.0.0.1:7860.

Como publicar atrás do Nginx com HTTPS

O guia de Nginx e SSL do Langflow deixa o Langflow ouvindo em 127.0.0.1:7860 e coloca o Nginx na frente. O registro A do domínio precisa apontar para o servidor antes do certificado. Um exemplo de comando para instalar o Nginx no Ubuntu ou Debian, para conferir no seu servidor:

sudo apt update

sudo apt install nginx

Um exemplo de arquivo em /etc/nginx/sites-available/langflow, montado com as diretivas que o guia lista, trocando o domínio pelo seu:

server {

listen 80;

server_name langflow.exemplo.com.br;

client_max_body_size 100M;

location / {

proxy_pass http://127.0.0.1:7860/;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_read_timeout 300s;

proxy_buffering off;

}

}

Depois, um exemplo para ativar o site, testar e recarregar:

sudo ln -s /etc/nginx/sites-available/langflow /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

Para o certificado, o guia usa o Certbot com o plugin do Nginx, que grava as linhas do certificado na configuração:

sudo apt install certbot python3-certbot-nginx -y

sudo certbot --nginx -d langflow.exemplo.com.br

Abra então https://langflow.exemplo.com.br e entre com o usuário (por padrão, langflow) e a senha do arquivo de variáveis. O guia diz que, montado assim, o acesso direto à porta 7860 vindo de fora deve falhar, e esse é um bom teste para fazer. Outro exemplo de Nginx está em React na VPS: como publicar seu app com Nginx. Quem prefere não abrir o painel na internet pode deixá-lo acessível só por VPN, como em OpenVPN na VPS: como criar sua VPN passo a passo.

Primeiros passos dentro do Langflow

Recomendamos começar por um fluxo simples: cadastrar a chave do provedor de IA numa variável global, montar um chatbot com poucos blocos e testar no próprio editor antes de chamar o fluxo de fora. Com o login automático desligado, rodar um fluxo pela API exige uma chave de API do Langflow, enviada no cabeçalho x-api-key; ela tem os mesmos privilégios de quem a criou.

Checklist do Langflow na VPS

  • versão mais recente instalada e alertas do repositório acompanhados;
  • LANGFLOW_AUTO_LOGIN=false e senha forte do superusuário;
  • LANGFLOW_SECRET_KEY própria, guardada em lugar privado;
  • arquivo de variáveis com chmod 600;
  • volume ou PostgreSQL para os dados não ficarem só no contêiner;
  • porta 7860 presa ao 127.0.0.1;
  • Nginx na frente e certificado emitido com o domínio já apontado;
  • cadastro aberto desligado e contas só para pessoas de confiança;
  • chaves dos provedores em variáveis globais.

Como atualizar o Langflow

Pela documentação do Langflow sobre Docker, a atualização é baixar a nova tag com docker pull, parar e remover o contêiner antigo e subir outro com o mesmo volume e a tag nova. No Docker Compose, a documentação indica trocar a tag e rodar docker compose pull e docker compose up -d.

A documentação pede backup antes de atualizar e lembra que essa cópia contém a chave secreta, por isso deve ficar em lugar privado: sem a chave original, o Langflow não decifra as credenciais salvas. No pacote Python, o comando é uv pip install langflow -U; a partir da 1.11.x, a documentação traz um procedimento à parte, em ambiente novo e com backup, porque a atualização no lugar pode deixar pacotes incompatíveis.

Uma anotação dos fluxos publicados

Recomendamos anotar o nome de cada fluxo, a data em que entrou no ar e o sistema que o chama.

Pesquise se o nome desejado está livre e registre o domínio na Eleven Host. Buscar domínio

Perguntas frequentes

O Langflow é gratuito?

O código é aberto, sob licença MIT, e pode ser instalado no próprio servidor. Os provedores de IA chamados pelos fluxos têm regras e cobranças próprias: confira com cada um.

Qual é a porta padrão do Langflow?

A 7860. No exemplo acima, ela fica presa ao 127.0.0.1, e o acesso de fora passa pelo Nginx com HTTPS.

Preciso de PostgreSQL?

Não obrigatoriamente. Com o SQLite, guarde os dados num volume; o PostgreSQL entra pela variável LANGFLOW_DATABASE_URL.

A CVE-2025-3248 ainda é um risco?

Ela afetava versões abaixo da 1.3.0 e foi corrigida na 1.3.0. Como houve outros alertas críticos em 2026, use a versão mais recente e acompanhe os alertas do repositório.

Esta resposta lhe foi útil?

Artigos Relacionados