使用Nginx Docker容器暴露本地Docker化Julia应用启动故障排查

故障根因 #

从启动日志可直接定位首个直接故障点，同时配置还存在3个隐藏问题：

1. SSL配置文件缺失：nginx启动时报错open() "/etc/letsencrypt/options-ssl-nginx.conf" failed，是因为宿主机的/etc/letsencrypt目录下没有对应配置文件。如果没有提前用certbot为域名app.local.hosting申请过SSL证书，不仅这个配置文件不存在，你配置里写的证书链、私钥文件也都会缺失，导致nginx启动校验不通过直接退出。
2. 反向代理地址配置错误：nginx.conf里写的proxy_pass http://localhost:8080指向的是nginx容器自身的本地端口，而非Julia应用容器，同一docker-compose网络内的服务可以直接用容器名互访，不需要走localhost。
3. 端口冲突风险：docker-compose中将nginx的80端口映射到宿主机8080端口，而Julia应用本身占用8080端口，若之前启动的Julia容器已经占用宿主机8080，会直接导致nginx端口映射失败。
4. 应用监听地址问题：Julia应用启动日志显示监听的是http://localhost:8080，也就是只监听容器内部的本地地址，即使nginx配置正确，也无法跨容器访问到应用服务。

解决方案 #

1. 修复SSL配置问题 #

• 若需要正式对外提供HTTPS服务，先在宿主机安装certbot，执行以下命令申请对应域名的证书：

  # 先停止占用80/443端口的服务
  certbot certonly --standalone -d app.local.hosting
  

  申请完成后/etc/letsencrypt目录下会自动生成所有需要的证书和配置文件。
• 若只是本地测试不需要HTTPS，可以暂时注释掉nginx.conf里所有SSL相关配置，简化后的server块如下：

  server {
    listen 80;
    server_name app.local.hosting;
  
    location /local-app {
      proxy_pass http://production-local-app:8080;
      rewrite ^/local-app(.*)$ $1 break;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
    }
  }
  

2. 修正反向代理地址 #

将nginx.conf中proxy_pass http://localhost:8080改为proxy_pass http://production-local-app:8080，docker-compose会自动处理同网络内的容器域名解析。

3. 调整端口映射 #

将docker-compose.yml中nginx的ports配置改为：

ports:
  - 80:80
  - 443:443

避免和Julia应用的8080端口冲突，如果你确实需要用8080作为公网访问入口，可以改为- 8080:80，但要提前确认宿主机8080端口未被占用。

4. 修改应用监听地址 #

修改Julia应用App.jl中App.run()方法的监听地址，从localhost改为0.0.0.0，确保容器外部可以访问到应用服务。

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