GCloud容器中Nginx代理下tileserver-gl数据预览异常问题

问题描述 #

• 在GCloud容器环境运行Tileserver-GL，原本可正常访问页面并查看数据预览
• 按照官方文档配置Nginx边车代理后，可通过代理访问应用页面，但数据预览消失
• 本地Docker Compose搭建相同架构（Nginx与应用分容器）运行正常
• 当前nginx.conf配置：

server {
    # Listen at port 8080
    listen 8080; 

    # Server at localhost
    server_name _;

    location / {
        proxy_pass   http://127.0.0.1:8888;

        # Various Headers to Ensure Tileserver-GL Generated URLs Visible
        proxy_set_header X-Forwarded-Host $host; 
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;

        }
}

可能原因与解决方案 #

1. Host头传递错误导致Tile URL生成异常 #

GCloud环境中，外部访问端口（如80/443）与容器内部端口（8080/8888）不一致，$http_host会包含容器内部端口，导致Tileserver-GL生成的Tile URL带有不可访问的内部端口。

解决方式：
将proxy_set_header Host $http_host;修改为proxy_set_header Host $host;，确保传递的是外部访问的主机名（不含端口）：

proxy_set_header Host $host;

2. Tileserver-GL未正确识别外部访问URL #

Tileserver-GL默认基于请求头生成Tile资源的URL，若GCloud存在负载均衡或反向代理，可能导致应用无法获取正确的外部访问地址。

解决方式：
在Tileserver-GL容器的启动配置中添加PUBLIC_URL环境变量，指定实际的外部访问地址（例如https://your-gcloud-domain.com/），或者在启动命令中添加--public-url参数：

# 环境变量方式
PUBLIC_URL=https://your-gcloud-domain.com/

# 启动命令参数方式
tileserver-gl --public-url https://your-gcloud-domain.com/

3. 检查Nginx请求日志定位问题 #

添加日志配置到nginx.conf，查看Tile资源请求的状态与错误信息：

server {
    listen 8080;
    server_name _;

    # 添加日志配置
    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;

    location / {
        proxy_pass   http://127.0.0.1:8888;
        proxy_set_header X-Forwarded-Host $host; 
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $host;
    }
}

通过查看日志，确认Tile请求是否返回404/502等错误，进一步定位问题。

4. 确认Pod内容器网络连通性 #

在GCloud的Pod中进入Nginx边车容器，测试与Tileserver-GL容器的连通性：

# 进入Nginx容器
kubectl exec -it <pod-name> -c <nginx-container-name> -- bash

# 测试8888端口连通性
curl http://127.0.0.1:8888/health

若请求失败，需检查Pod内容器的网络配置是否正常（Pod内默认共享网络命名空间，localhost应可访问）。

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