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…