MacOS Monterey下Docker容器化Deno应用无法访问localhost问题

环境与问题描述 #

• 系统：MacOS Monterey
• Dockerfile内容：

FROM denoland/deno:1.29.1

EXPOSE 4200

WORKDIR /app

ADD . /app

RUN deno cache ./src/index.ts

CMD ["run", "--allow-net", "--allow-read", "./src/index.ts"]

• Deno业务代码（src/index.ts）：

const handler = (request: Request) => {
  return new Response("heyo", { status: 200 });
};
DenoServer.serve(handler, { hostname: HOST, port: PORT });

• 容器运行命令：docker run --publish 4200:4200 frontend
• 异常现象：本地直接运行Deno应用可正常访问localhost:4200，但Docker容器启动后，执行curl http://localhost:4200返回curl: (52) Empty reply from server；容器状态显示运行中，但访问容器IP也无法建立连接。

问题根源与修复方案 #

1. 服务监听地址错误（核心问题） #

代码中hostname: HOST未正确配置时，默认会绑定容器内部的127.0.0.1（回环地址），导致服务仅能在容器内部访问，外部端口映射无法穿透到服务。同时原代码中的DenoServer是错误写法，Deno标准API应为Deno.serve()。

修复：
将监听地址改为0.0.0.0，让服务监听容器所有网络接口：

const handler = (request: Request) => {
  return new Response("heyo", { status: 200 });
};
Deno.serve(handler, { hostname: "0.0.0.0", port: 4200 });

2. 环境变量配置优化（可选） #

若需通过环境变量动态指定地址和端口，可在Dockerfile中添加环境变量定义，并在代码中读取：

• 修改Dockerfile：

FROM denoland/deno:1.29.1

EXPOSE 4200

WORKDIR /app

# 配置环境变量，指定默认监听地址和端口
ENV HOST=0.0.0.0
ENV PORT=4200

ADD . /app

RUN deno cache ./src/index.ts

CMD ["run", "--allow-net", "--allow-read", "./src/index.ts"]

• 对应修改Deno代码：

// 读取环境变量，默认兜底值
const HOST = Deno.env.get("HOST") || "0.0.0.0";
const PORT = Number(Deno.env.get("PORT")) || 4200;

const handler = (request: Request) => {
  return new Response("heyo", { status: 200 });
};
Deno.serve(handler, { hostname: HOST, port: PORT });

3. 容器内服务状态验证 #

可进入容器内部，确认服务是否正常监听目标端口：

# 获取运行中容器的ID
docker ps
# 进入容器终端
docker exec -it <容器ID> /bin/sh
# 检查端口监听状态
netstat -tulpn | grep 4200

若输出显示服务监听0.0.0.0:4200，则说明配置正确，外部可通过localhost:4200访问。

内容的提问来源于stack exchange，提问作者bzach