Tovanix
Tovanix

Tutorial de instalação e configuração do nexcore-s-ui (sing-box)

Guia completo do Astrenix/nexcore-s-ui: instalação rápida sing-box, binários musl, certificados SSL Cloudflare DNS-01, API /api/v1 e CLI.

  • Frontend Vue 3 + Element Plus reescrito para gerenciar entradas, saídas, roteamento e múltiplos usuários no sing-box.
  • Binários estáticos musl para amd64, arm64 e outras arquiteturas Linux sem depender da GLIBC do host.
  • API REST /api/v1 completa com log de auditoria, compatível com controladores feitos para nexcore-x-ui.
  • Integração nativa com Cloudflare API Token para emitir e renovar certificados SSL por DNS-01 sem conflito na porta 80.

Arquitetura e recursos principais

Redesenhado a partir do alireza0/s-ui para sing-box e automação via API, o nexcore-s-ui oferece:

  • Frontend Vue 3 + Element Plus reescrito para gerenciar entradas, saídas, roteamento e múltiplos usuários no sing-box.
  • Binários estáticos musl para amd64, arm64 e outras arquiteturas Linux sem depender da GLIBC do host.
  • API REST /api/v1 completa com log de auditoria, compatível com controladores feitos para nexcore-x-ui.
  • Integração nativa com Cloudflare API Token para emitir e renovar certificados SSL por DNS-01 sem conflito na porta 80.

Requisitos de sistema e arquitetura

  • Sistema suportado — Ubuntu 24.04 LTS (validado de ponta a ponta); compatível também com Ubuntu 20.04+, Debian 11+ e CentOS Stream 8+ com systemd.
  • Arquiteturas de CPU — Binários estáticos disponíveis para amd64, arm64, 386, armv5, armv6, armv7 e s390x.
  • Privilégios — Exige acesso root para usar portas 80 / 443, gravar certificados ACME e criar interfaces tun quando configuradas.
  • Coexistência — Caminhos, serviço systemd e porta aleatória isolados permitem rodar ao lado do s-ui original.

Instalação rápida, versão fixa e reinstalação forçada

Entre via SSH como root e execute o instalador oficial. A primeira instalação cria usuário, senha e porta aleatórios:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)

Para fixar uma tag de release específica ou sobrescrever binários preservando o banco atual, passe a tag ou --force:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0

As credenciais aleatórias iniciais e a URI do painel são exibidas uma única vez ao final da instalação; salve imediatamente antes de fechar o terminal.

Configurar certificados SSL automáticos via Cloudflare DNS-01

Para Hysteria2, Trojan, AnyTLS ou entradas com TLS, configure Cloudflare DNS-01 para emissão e renovação automáticas:

  • Aponte um domínio gerenciado na Cloudflare para o servidor: Registre um domínio na Tovanix Cloud (ou use um próprio) e crie um registro A / AAAA apontando para o IP público do nó.
  • Crie um Cloudflare API Token com permissão mínima: Na Cloudflare, crie um API Token restrito à zona desejada apenas com Zone:DNS:Edit em vez de usar a chave global.
  • Informe o domínio e o Token no painel: Na tela de certificados do nexcore-s-ui selecione DNS-01, informe o domínio e o API Token e salve para automatizar emissão e renovação.

O modo DNS-01 valida a posse via registro DNS TXT, funcionando mesmo se a porta 80 estiver ocupada ou fechada.

Guia rápido da CLI nexcore-s-ui

Use o comando nexcore-s-ui para gerenciar serviço, logs, atualizações e desinstalação:

  • nexcore-s-ui — Abre o menu interativo de administração do painel.
  • nexcore-s-ui start | stop | restart | status — Inicia, para, reinicia ou checa o status do serviço nexcore-s-ui.
  • nexcore-s-ui log — Exibe logs recentes do painel e do núcleo para diagnosticar entradas ou ACME.
  • nexcore-s-ui update — Atualiza para a versão mais recente no GitHub Releases mantendo o banco de dados.
  • nexcore-s-ui uninstall — Remove binários, serviço systemd e dados locais por completo (faça backup antes).

Diagnóstico

  • Endereço do painel não responde após instalar — A porta aleatória não foi liberada no firewall ou faltou informar a URI gerada. — Confira porta e URI na saída da instalação, libere no firewall e valide com nexcore-s-ui status.
  • Falha ao emitir certificado Cloudflare DNS-01 — Falta permissão Zone:DNS:Edit no API Token para aquela zona ou o DNS ainda não propagou. — Confira o escopo do token e veja a mensagem exata do ACME executando nexcore-s-ui log.
  • Hysteria2 ou protocolos UDP não conectam — Somente TCP foi liberado no firewall deixando UDP bloqueado, ou há divergência de domínio / ALPN no certificado. — Libere tráfego UDP na porta configurada e garanta que o SNI do cliente coincida com o domínio do certificado.
  • Preciso reparar binários sem perder dados — Executar uninstall apaga tanto os binários quanto o banco de dados. — Não use uninstall; execute install.sh --force para sobrescrever binários mantendo o banco de dados intacto.

Perguntas frequentes

O nexcore-s-ui depende de uma versão específica da GLIBC no host?

Não. Os binários são compilados estaticamente com musl para várias arquiteturas Linux; Ubuntu 24.04 LTS é recomendado.

O nexcore-s-ui pode rodar junto com o alireza0/s-ui original?

Sim. Diretórios, unidade systemd e portas são isolados, permitindo coexistência sem conflito de portas.

Por que escolher Cloudflare DNS-01 em vez de HTTP-01?

DNS-01 não precisa da porta 80, suporta certificados curinga e não conflita com servidores web já instalados.

Páginas relacionadas: Tutorial de instalação e operação do nexcore-x-ui (painel Xray) · Guia de painéis de nós: nexcore-x-ui, nexcore-s-ui e Proxy dedicado · Solução de implantação de rede privada · Proxy dedicado

Carregando…