Voltar ao blog
Janeiro 19, 2026Guias

Como Instalar Proxy VLESS com Painel Marzban

Guia completo passo a passo sobre como configurar proxy VLESS usando o painel Marzban - interface de gerenciamento moderna e amigável com suporte a múltiplos protocolos.

Como Instalar Proxy VLESS com Painel Marzban

O Marzban é um painel poderoso e moderno baseado em web para gerenciar servidores proxy Xray. Diferente de outros painéis, o Marzban oferece uma interface intuitiva, suporte a múltiplos administradores e recursos abrangentes de gerenciamento de usuários. Este guia mostrará como configurar proxy VLESS usando o Marzban no seu VPS Hiddence para acesso à internet seguro e resistente à censura.

O que é o Marzban?

O Marzban é um painel de gerenciamento de proxy de código aberto integrado ao Telegram construído especificamente para Xray-core. Ele fornece um painel limpo e moderno para criar e gerenciar usuários de proxy, monitorar tráfego e lidar com assinaturas. O Marzban suporta protocolos VLESS, VMess, Trojan e Shadowsocks.

Por que Escolher o Marzban?

  • Interface Web Moderna: Painel limpo e responsivo acessível de qualquer navegador
  • Suporte a Múltiplos Administradores: Crie múltiplas contas de administrador com diferentes permissões
  • Gerenciamento de Usuários: Criação, modificação e exclusão fáceis de usuários de proxy
  • Monitoramento de Tráfego: Estatísticas em tempo real e rastreamento de uso por usuário
  • Links de Assinatura: Geração automática de URLs de assinatura para clientes
  • Bot do Telegram: Bot integrado para gerenciamento de usuários e notificações
  • Múltiplos Protocolos: Suporta VLESS, VMess, Trojan e Shadowsocks
  • Baseado em Docker: Instalação e atualizações fáceis usando Docker

Pré-requisitos

  • Um VPS novo com Ubuntu 22.04 ou 24.04 (VPS Hiddence recomendado)
  • Acesso root ou sudo ao servidor
  • Nome de domínio apontado para o IP do seu servidor (opcional mas recomendado para TLS)
  • Conhecimento básico de linha de comando

Passo 1: Preparar o Seu Servidor

Primeiro, atualize o seu sistema e instale o Docker (o Marzban roda em contêineres Docker):

bash
# Atualizar sistema
apt update && apt upgrade -y

# Instalar Docker
curl -fsSL https://get.docker.com | sh

# Instalar Docker Compose
apt install docker-compose -y

# Verificar instalação do Docker
docker --version
docker-compose --version

Passo 2: Instalar o Marzban

Baixe e instale o Marzban usando o script de instalação oficial:

bash
# Criar diretório para o Marzban
mkdir -p /opt/marzban
cd /opt/marzban

# Baixar arquivo docker-compose
wget -O docker-compose.yml https://raw.githubusercontent.com/Gozargah/Marzban/master/docker-compose.yml

# Criar arquivo .env para configuração
wget -O .env https://raw.githubusercontent.com/Gozargah/Marzban/master/.env.example

# Editar .env para definir credenciais de administrador
nano .env
# Definir SUDO_USERNAME e SUDO_PASSWORD

# Iniciar Marzban
docker-compose up -d

# Verificar se está rodando
docker-compose ps

Passo 3: Acessar o Painel do Marzban

Abra o seu navegador e navegue até o endereço IP do seu servidor na porta 8000:

  • URL: http://SEU_IP_DO_SERVIDOR:8000
  • Faça login com o nome de usuário e senha que você definiu no arquivo .env
  • Você verá o painel do Marzban com opções para usuários, configurações e estatísticas
  • Importante: Altere a senha de administrador padrão imediatamente após o primeiro login

Passo 4: Configurar Inbound VLESS

Configure o protocolo VLESS no Marzban:

  • No painel, vá para 'Configurações do Core' ou 'Inbounds'
  • Adicione um novo inbound VLESS com estas configurações:
  • Porta: 443 (para TLS) ou qualquer porta disponível
  • Protocolo: VLESS
  • Rede: TCP ou WS (WebSocket)
  • Segurança: TLS (se usando domínio) ou Reality
  • Se usando Reality, configure SNI para um site popular como www.microsoft.com
  • Salve a configuração do inbound

Passo 5: Criar Usuários e Gerar Links

Adicione usuários de proxy e obtenha links de conexão:

  • Clique no botão 'Adicionar Usuário' no painel
  • Defina nome de usuário, limite de tráfego e data de expiração
  • Selecione o inbound VLESS que você criou
  • Clique em 'Criar' para gerar o usuário
  • Copie o link de assinatura ou código QR
  • Importe o link no seu cliente VLESS (v2rayN, v2rayNG, Hiddify, etc.)
  • Teste a conexão ativando o proxy

Melhores Práticas do Marzban

  • Ative a integração do bot do Telegram para gerenciamento fácil de usuários
  • Configure certificado SSL para acesso seguro ao painel (use proxy reverso Nginx)
  • Faça backup regular do banco de dados do Marzban (/opt/marzban/db.sqlite3)
  • Monitore o tráfego do usuário para prevenir abuso
  • Use o protocolo Reality para máxima resistência à censura
  • Mantenha o Marzban atualizado: docker-compose pull && docker-compose up -d
  • Configure o firewall para permitir apenas portas necessárias (443, 8000)
  • Use senhas fortes para contas de administrador