为何基于Caddy容器的简单Dockerfile运行失败？

问题详情 #

我配置了Caddy和Docker，但访问localhost时提示“The site can't be reached”，无法正常访问。以下是我的配置和操作步骤：

Caddy配置文件 #

localhost {
        root * /testDir
        file_server
        reverse_proxy /api/* localhost:3000
}

Dockerfile #

FROM caddy:2.7.6-alpine

EXPOSE 80

EXPOSE 443

COPY Caddyfile /etc/caddy/Caddyfile

COPY testDir /testDir

CMD ["caddy", "run"]

构建与运行命令 #

构建命令：

docker build -t testcaddy .

运行命令：

docker run -p 80:80 -p 443:443 -d testcaddy

已确认容器内Caddyfile和testDir路径均正确，但访问失败。

解决步骤 #

1. 查看容器日志定位错误 #

先获取容器运行日志，找到具体故障原因：

# 先列出容器获取ID
docker ps
# 查看日志
docker logs <容器ID或容器名称>

2. 修正HTTPS自动配置问题 #

Caddy默认会为localhost自动申请HTTPS证书，但容器环境下可能无法完成ACME验证流程导致启动失败。两种解决方式：

• 改用HTTP测试：修改Caddyfile指定HTTP协议和端口

  http://localhost:80 {
          root * /testDir
          file_server
          reverse_proxy /api/* localhost:3000
  }
  

• 使用自签名证书：添加tls internal指令，浏览器会提示不安全但可正常访问

  localhost {
          root * /testDir
          file_server
          reverse_proxy /api/* localhost:3000
          tls internal
  }
  

3. 检查反向代理目标的可达性 #

配置中reverse_proxy /api/* localhost:3000的localhost是容器内部的localhost：

• 如果后端服务在宿主机运行，Docker Desktop环境可替换为host.docker.internal:3000；Linux环境需要用宿主机的局域网IP
• 如果后端在另一个容器，需确保两个容器在同一网络，并使用容器名称或IP作为目标

4. 容器内部测试Caddy可用性 #

进入容器内部，用curl测试Caddy是否正常响应：

docker exec -it <容器ID> curl http://localhost

如果能返回内容，说明问题出在宿主机端口映射或网络；如果不能，说明Caddy未正常启动。

5. 检查宿主机端口占用情况 #

宿主机80/443端口可能被其他服务占用，导致映射失效：

# Linux/macOS
lsof -i :80
lsof -i :443

# Windows
netstat -ano | findstr ":80"
netstat -ano | findstr ":443"

若端口被占用，可停止对应服务，或修改Docker运行命令的端口映射，例如-p 8080:80 -p 8443:443。

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