Como Instalar Proxy VLESS com Painel Marzban
Guia completo passo a passo sobre como configurar proxy VLESS utilizando o painel Marzban - interface de gestão moderna e fácil de usar com suporte multi-protocolo.

O Marzban é um painel moderno e poderoso baseado na web para gerir servidores proxy Xray. Ao contrário de outros painéis, o Marzban oferece uma interface intuitiva, suporte multi-administrador e funcionalidades abrangentes de gestão de utilizadores. Este guia mostrar-lhe-á como configurar proxy VLESS utilizando o Marzban no seu VPS Hiddence para acesso à internet seguro e resistente à censura.
O que é o Marzban?
O Marzban é um painel de gestão de proxy de código aberto e integrado com Telegram, construído especificamente para Xray-core. Fornece um painel limpo e moderno para criar e gerir utilizadores de proxy, monitorizar tráfego e gerir subscrições. O Marzban suporta os protocolos VLESS, VMess, Trojan e Shadowsocks.
Porquê Escolher o Marzban?
- Interface Web Moderna: Painel limpo e responsivo acessível a partir de qualquer navegador
- Suporte Multi-Administrador: Criar múltiplas contas de administrador com diferentes permissões
- Gestão de Utilizadores: Criação, modificação e eliminação fáceis de utilizadores de proxy
- Monitorização de Tráfego: Estatísticas em tempo real e rastreamento de utilização por utilizador
- Links de Subscrição: Geração automática de URLs de subscrição para clientes
- Bot Telegram: Bot integrado para gestão de utilizadores e notificações
- Multi-Protocolo: Suporta VLESS, VMess, Trojan e Shadowsocks
- Baseado em Docker: Instalação e atualizações fáceis utilizando Docker
Pré-requisitos
- Um VPS limpo 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 comandos
Passo 1: Preparar o Seu Servidor
Primeiro, atualize o seu sistema e instale o Docker (o Marzban funciona em contentores 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
Descarregue e instale o Marzban utilizando o script de instalação oficial:
# Criar diretório para Marzban
mkdir -p /opt/marzban
cd /opt/marzban
# Descarregar ficheiro docker-compose
wget -O docker-compose.yml https://raw.githubusercontent.com/Gozargah/Marzban/master/docker-compose.yml
# Criar ficheiro .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á em execução
docker-compose psPasso 3: Aceder ao Painel Marzban
Abra o seu navegador e navegue para o endereço IP do seu servidor na porta 8000:
- URL: http://SEU_IP_DO_SERVIDOR:8000
- Inicie sessão com o nome de utilizador e palavra-passe que definiu no ficheiro .env
- Verá o painel Marzban com opções para utilizadores, definições e estatísticas
- Importante: Altere a palavra-passe de administrador padrão imediatamente após o primeiro início de sessão
Passo 4: Configurar Inbound VLESS
Configure o protocolo VLESS no Marzban:
- No painel, vá a 'Core Settings' ou 'Inbounds'
- Adicione um novo inbound VLESS com estas definições:
- Porta: 443 (para TLS) ou qualquer porta disponível
- Protocolo: VLESS
- Rede: TCP ou WS (WebSocket)
- Segurança: TLS (se usar domínio) ou Reality
- Se usar Reality, configure SNI para um site popular como www.microsoft.com
- Guarde a configuração do inbound
Passo 5: Criar Utilizadores e Gerar Links
Adicione utilizadores de proxy e obtenha links de ligação:
- Clique no botão 'Add User' no painel
- Defina nome de utilizador, limite de tráfego e data de expiração
- Selecione o inbound VLESS que criou
- Clique em 'Create' para gerar o utilizador
- Copie o link de subscrição ou código QR
- Importe o link no seu cliente VLESS (v2rayN, v2rayNG, Hiddify, etc.)
- Teste a ligação ativando o proxy
Melhores Práticas do Marzban
- Ative a integração do bot Telegram para gestão fácil de utilizadores
- Configure certificado SSL para acesso seguro ao painel (use proxy reverso Nginx)
- Faça cópias de segurança regulares da base de dados do Marzban (/opt/marzban/db.sqlite3)
- Monitorize o tráfego dos utilizadores 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 a firewall para permitir apenas portas necessárias (443, 8000)
- Use palavras-passe fortes para contas de administrador