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.

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):
# 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 --versionPasso 2: Instalar o Marzban
Baixe e instale o Marzban usando o script de instalação oficial:
# 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 psPasso 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