Tutorial de instalação e operação do nexcore-x-ui (painel Xray)
Guia completo do Astrenix/nexcore-x-ui: instalação rápida, binário Go estático, Vue 3, reforço systemd, API REST /api/v1, CLI e solução de falhas.
- Binário Go estático com interface Vue 3 + Element Plus e Xray-core, eliminando dependência rígida da GLIBC do host.
- API REST /api/v1 estruturada para controladores externos, scripts e orquestração multinó.
- Reforço systemd (ProtectSystem=strict, NoNewPrivileges=true), diretórios 0700, banco 0600 e tokens API armazenados com hash SHA256.
- VLESS com XTLS-Reality, TCP, WebSocket e gRPC para baixa sobrecarga e conexões estáveis.
Arquitetura e recursos principais
Refatorado a partir do vaxilu/x-ui para automação em nuvem e segurança em produção, o nexcore-x-ui entrega:
- Binário Go estático com interface Vue 3 + Element Plus e Xray-core, eliminando dependência rígida da GLIBC do host.
- API REST /api/v1 estruturada para controladores externos, scripts e orquestração multinó.
- Reforço systemd (ProtectSystem=strict, NoNewPrivileges=true), diretórios 0700, banco 0600 e tokens API armazenados com hash SHA256.
- Caminhos, unidade systemd e comando CLI (nexcore-x-ui) isolados que não conflitam com o x-ui original.
Requisitos do sistema
- Sistema operacional — Linux moderno de 64 bits com systemd (recomendado Ubuntu 22.04 / 24.04 LTS limpo ou Debian 12).
- Privilégios — Requer acesso root para registrar o serviço systemd, abrir portas e proteger o diretório de dados.
- Rede — IP público com acesso ao GitHub Releases para baixar binários e firewall liberando as portas do painel e dos protocolos.
- Servidores recomendados — Combina diretamente com VPS IP nativo, VPS duplo ISP, VPS residencial ou servidores físicos da Tovanix.
Instalação em um comando e automação
Acesse o servidor via SSH como root e execute o instalador oficial para baixar o binário estático, registrar o serviço e gerar credenciais aleatórias:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
Em implantações via cloud-init ou controlador próprio, informe as variáveis de entrada segura e callback webhook antes de executar o script:
REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
A partir da v2.1.3, credenciais iniciais em texto puro não são mais gravadas em install-info.txt; aparecem apenas no banner do terminal e no systemd journal.
Recuperando credenciais iniciais de login
Se você fechou o terminal após a instalação, recupere o banner inicial pela CLI ou consultando o systemd journal:
nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"
Após o primeiro login, altere a senha gerada no painel ou com nexcore-x-ui passwd e restrinja o acesso à porta do painel no firewall.
Guia rápido da CLI nexcore-x-ui
A instalação registra o comando global nexcore-x-ui para controlar o serviço, logs, senhas, atualizações e remoção:
- nexcore-x-ui — Abre o menu interativo no terminal para ações comuns.
- nexcore-x-ui start | stop | restart | status — Inicia, para, reinicia ou verifica o status do serviço do painel.
- nexcore-x-ui creds / info — Exibe porta do painel, caminho de entrada e credenciais iniciais.
- nexcore-x-ui reset — Gera novamente usuário, senha e porta do painel de forma aleatória.
- nexcore-x-ui passwd <user> <new_password> — Define manualmente uma nova senha de acesso para o administrador informado.
- nexcore-x-ui log / log-tail — Mostra as últimas 200 linhas de log ou acompanha a saída em tempo real.
- nexcore-x-ui update — Atualiza suavemente para a versão mais recente no GitHub Releases e reinicia o serviço.
- nexcore-x-ui uninstall — Remove binários, serviço systemd e diretório de dados (faça backup antes).
Protocolos e transportes suportados
Construído sobre Xray-core, suporta credenciais por usuário, cotas de tráfego e regras de validade em:
- VLESS com XTLS-Reality, TCP, WebSocket e gRPC para baixa sobrecarga e conexões estáveis.
- VMess e Trojan para compatibilidade com clientes clássicos e domínios TLS.
- Shadowsocks e Shadowsocks-2022 para clientes leves e links rápidos de relé.
- SOCKS, HTTP e Dokodemo-door para proxy de aplicativos, encaminhamento de portas e encadeamento.
Depois de testar a entrada, passe o IP de saída pela nossa consulta gratuita de qualidade de IP para validar registros nativos e de operadora.
Diagnóstico
- Página de login do painel não abre no navegador — A porta aleatória está bloqueada no firewall ou faltou informar o caminho seguro de entrada. — Rode nexcore-x-ui status e nexcore-x-ui info para conferir porta e caminho e libere a porta TCP no firewall.
- Senha aleatória inicial perdida — Versões v2.1.3 e superiores não gravam arquivo de senha em texto puro no disco. — Execute nexcore-x-ui creds para ler o journal ou redefina com nexcore-x-ui passwd <usuario> <nova_senha>.
- Entrada ativa mas clientes não conseguem conectar — Porta do protocolo fechada, falha no handshake Reality ou relógio do servidor dessincronizado. — Revise regras TCP / UDP, sincronize o NTP do servidor e confira erros do Xray via nexcore-x-ui log-tail.
- Atualização feita pelo painel não surtiu efeito — Tempo esgotado ao baixar do GitHub Releases ou processo antigo preso. — Execute nexcore-x-ui update por SSH para acompanhar a saída completa e confirme com nexcore-x-ui status.
Perguntas frequentes
O nexcore-x-ui pode coexistir com o vaxilu/x-ui no mesmo servidor?
Sim. Binários, diretório de dados, serviço systemd e CLI são isolados; basta não repetir portas.
Atualizar o nexcore-x-ui apaga entradas ou usuários cadastrados?
Não. Tanto a atualização pelo painel quanto nexcore-x-ui update substituem só os binários preservando o banco SQLite.
Como automatizar a gestão de nós pela /api/v1?
Gere um API Token nas configurações do painel (salvo no servidor como hash SHA256) e use chamadas REST padrão para entradas, usuários e tráfego.
Páginas relacionadas: Tutorial de instalação e configuração do nexcore-s-ui (sing-box) · Guia de painéis de nós: nexcore-x-ui, nexcore-s-ui e Proxy dedicado · Solução de implantação de rede privada · VPS com IP nativo e IP residencial
Carregando…