dev: false "reachable from the network" warning when `devServer.host` is a `*.localhost` subdomain

Aberta Para iniciantes
#1,644 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

  • #1649 de @paoValle — fechado sem integrar

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
84/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
node.js, typescript
Domínio
cli, networking

Direção de pesquisa

Encontre a implementação de listen e as duas verificações que usam LOOPBACK_HOSTS.has(hostname), responsáveis pelo aviso e pela indicação Network:. Leia essas verificações e procure testes existentes que cubram a classificação de hosts ou a saída do servidor de desenvolvimento. Trate os subdomínios de .localhost como endereços de loopback nos dois lugares; o trabalho estará concluído quando eles não acionarem mais o aviso de rede nem aparecerem como URLs de rede.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Environment
  • @nuxt/cli: 4.0.1
  • nuxt: 4.6.2
  • Node.js: 24.21.0
  • OS: macOS
Reproduction
// nuxt.config.ts
export default defineNuxtConfig({
  devServer: { host: 'my-app.localhost' },
})
nuxt dev
Describe the bug

The CLI prints:

The dev server is reachable from the network without authentication: anyone who can connect can read the app, build errors and source code.

The server is not reachable from the network. my-app.localhost resolves to loopback only (dns.lookup('my-app.localhost', { all: true }) returns ::1 and 127.0.0.1), so the listener is bound to loopback just like with localhost.

Per RFC 6761 §6.3, localhost and every name under .localhost resolve to loopback. Browsers resolve them that way without DNS and treat them as secure contexts. *.localhost names are a common way to run several local apps side by side.

Cause

In listen the warning only checks an exact-match set:

const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '::1'])
// ...
if (announce && (anyHost || !LOOPBACK_HOSTS.has(hostname))) logger.warn('The dev server is reachable from the network ...')

my-app.localhost is not in the set, so it is treated as a public host. The same check also drives the Network: hint shown under the URLs.

Suggested fix

Treat any .localhost name as loopback, e.g.:

const isLoopbackHost = host => LOOPBACK_HOSTS.has(host) || host.endsWith('.localhost')

and use it in both places that currently call LOOPBACK_HOSTS.has(hostname).

Workaround

Leave devServer.host unset and pass --publicURL http://my-app.localhost:3000 to nuxt dev, so the CLI shows that URL without the warning.

Linguagem predominante
TypeScript
Estrelas
402
Forks
125
Merge médio
2d 9h
PRs com merge (30d)
37

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de nuxt/cli

Todas as issues de nuxt/cli

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.