Windows开发环境下如何让Hugo Server实现端口共享？

1. 修正Dockerfile冗余配置 #

你的Dockerfile存在重复安装Hugo和Node.js的问题，会导致镜像体积冗余且可能引发依赖冲突，修改后版本如下：

FROM golang:bullseye

WORKDIR /src

RUN apt-get update -y && \
    apt-get install -y --no-install-recommends ca-certificates curl && \
    # 仅保留指定版本的Hugo deb包安装
    curl -L https://github.com/gohugoio/hugo/releases/download/v0.96.0/hugo_0.96.0_Linux-64bit.deb -o hugo.deb && \
    apt install ./hugo.deb && \
    rm hugo.deb && \
    # 通过nodesource安装指定版本Node.js，避免重复安装
    curl -sL https://deb.nodesource.com/setup_17.x | bash - && \
    apt-get install -y nodejs && \
    # 清理缓存减小镜像体积
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

2. 调整docker-compose.yml配置 #

确保Hugo Server绑定正确地址和端口，同时修正目录映射逻辑：

version : '3.7'

services:
  site:
    restart: unless-stopped
    env_file: 
      - .env
    build:
      context: ./
      dockerfile: Dockerfile
    volumes:
      # 绑定本地项目根目录到容器工作目录，确保代码实时同步
      - type: bind
        source: .
        target: /src
    tmpfs: /src/tmp
    # 显式指定绑定地址和端口，消除歧义
    command: hugo -D server --bind 0.0.0.0 --port 1313
    ports: 
      - 1313:1313

若你的Hugo项目文件单独存放在本地src目录下，将source: .改回source: ./src即可。

3. 修复devcontainer.json配置（解决根目录显示问题） #

使用docker-compose时必须指定关联服务和工作目录，否则容器会默认进入根目录。修改后配置如下：

{
    "name": "Hugo Site",
    // 指定docker-compose文件路径（相对于devcontainer目录）
    "dockerComposeFile": ["../docker-compose.yml"],
    // 关联docker-compose中定义的服务名称
    "service": "site",
    // 容器内工作目录，与Dockerfile保持一致
    "workspaceFolder": "/src",
    // 转发端口，与docker-compose配置匹配
    "forwardPorts": [1313]
}

4. 验证Hugo服务状态的方法 #

• 进入容器终端，执行 ps aux | grep hugo 查看Hugo进程是否存在
• 查看容器日志：执行 docker logs <容器名称/ID>，或在VS Code容器面板直接查看日志，确认Hugo是否正常启动并监听1313端口

5. 访问Hugo Server的注意事项 #

• Windows主机浏览器直接访问 http://localhost:1313 即可，WSL2 Docker会自动完成端口转发
• 若仍无法访问，在WSL2终端执行 sudo ufw allow 1313 开放端口
• 检查端口占用：Windows下执行 netstat -ano | findstr :1313，WSL2下执行 lsof -i :1313，确认无其他程序占用1313端口

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