Voltar ao blog
Janeiro 19, 2026Guias

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.

Como Instalar Proxy VLESS com Painel Marzban

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):

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

Descarregue e instale o Marzban utilizando o script de instalação oficial:

bash
# 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 ps

Passo 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