Tovanix
Tovanix

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…