nodejs / nodejs/node

Node.js v24 fails to establish HTTPS connections over IPv6/IPv4 fallback in Docker Desktop on Windows (ENETUNREACH)

Open
#64,652 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
122k
Forks
37.3k
Avg merge
4d 2h
Merged PRs (30d)
283

Description

Version

Node.js version: v24.16.0

Platform
Operating system: Windows 11  Docker: Docker Desktop (latest)  Container images tested: node:24-alpine node:24-bookworm node:22-bookworm  Network: Docker Desktop IPv4 only networking enabled
Subsystem

It was a n8n Container in Docker Desktop.

What steps will reproduce the bug?

Run:

docker run --rm node:24-bookworm node -e "require('https').get('https://login.microsoftonline.com',r=>console.log(r.statusCode)).on('error',console.error)"

or

docker run --rm node:24-alpine node -e "require('https').get('https://login.microsoftonline.com',r=>console.log(r.statusCode)).on('error',console.error)"

How often does it reproduce? Is there a required condition?

Always

What is the expected behavior? Why is that the expected behavior?

The HTTPS request should succeed.

Node 22 returns HTTP 302.

What do you see instead?

AggregateError [ENETUNREACH]

connect ENETUNREACH 2603:1027:...

Node attempts multiple IPv6 addresses and never falls back to IPv4.

Additional information

Additional investigation:

  • nslookup login.microsoftonline.com returns both IPv4 (A) and IPv6 (AAAA) records.
  • DNS resolution inside the container is working correctly.
  • Direct TCP connections to IPv4 addresses succeed.

Example:

node -e "require('net').connect({host:'20.190.159.130',port:443}).on('connect',()=>console.log('OK')).on('error',console.error)"

returns:

OK

However:

node -e "require('https').get('https://login.microsoftonline.com',r=>console.log(r.statusCode)).on('error',console.error)"

fails with ENETUNREACH.

Testing official Node images:

node:22-bookworm
-> HTTP 302 (works)

node:24-bookworm
-> ENETUNREACH

node:24-alpine
-> ENETUNREACH

The same behavior was observed in the official n8n Docker image, which currently ships with Node.js 24.

Rebuilding n8n using Node.js 22 completely resolves the issue.

This appears to be related to address selection or Happy Eyeballs behavior.

Node 24 seems to only attempt IPv6 connections although IPv4 connectivity is available and works.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the HTTPS command in node:24-bookworm and node:24-alpine, then compare it with node:22-bookworm in Docker Desktop on Windows. Start by investigating Node 24 address selection or Happy Eyeballs behavior when both A and AAAA records exist. Done means the request succeeds over available IPv4 connectivity instead of ending with ENETUNREACH.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, javascript, node.js
Domain
networking
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.