nginx代理天地图做缓存解决跨域问题

作为一个GISer开发者，天地图是经常在项目中以底图的形式出现，其加载地址如：

1. 天地图矢量：http://t{0-6}.tianditu.com/DataServer?T=vec_w&x={x}&y={y}&l={z}
2. 天地图影像：http://t{0-6}.tianditu.com/DataServer?T=img_w&x={x}&y={y}&l={z}
3. 天地图地形：http://t{0-6}.tianditu.com/DataServer?T=ter_w&x={x}&y={y}&l={z}

其中t{0-6}是天地图提供的7个服务器名称t0,t1,t2....

下面是我以openlayers加载天地图过程中遇到跨域问题

1、错误的产生条件

// 采用openlayers加载天地图
var layer = new ol.layer.Tile({
    source: new ol.source.XYZ({
        // crossOrigin: 'Anonymous', // 是否请求跨域操作
        url: url // 天地图地址
    })
});                

如果没有用到crossOrigin属性就不会产生跨域问题，一般这个参数也不会设置。

这个参数使用场景如下官网所述：

The crossOrigin attribute for loaded images. Note that you must provide a crossOrigin value if you are using the WebGL renderer or if you want to access pixel data with the Canvas renderer. See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

查阅MDN文档（https://developer.mozilla.org/zh-CN/docs/Web/HTML/CORS_settings_attributes），可以发现crossOrigin有两个取值

在开发过程中，往往需要本地运行开发版，服务器运行生产版。当两个版本在同一个浏览器中访问时，设置了crossOrigin就会出现跨域问题，如下图所示的错误，

has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

注：只有天地图设置了crossOrigin之后会出现这个问题，谷歌底图是不会出现的，原因是：

天地图在返回的request header的Origin属性设置成当前访问的IP，而google底图Origin属性设置的是*，意味着不同IP的系统在浏览器缓存了google瓦片之后依然能访问google底图。

2、错误解决的方法

2.1  简单暴力的方法

简单暴力的解决方法就是清除浏览器的缓存图片，在同一时刻，只查看一个其中的一个系统，如果要查看另一个系统，必须事先清除浏览器图片缓存

2.2  删除CrossOrigin属性

重新审视一遍地图需求，判断是否真的需要crossOrigin属性，如果不需要，就根本不会出现这个问题

2.3  nginx代理解决

如果前面的方法都感觉不合适，那就用nginx来代理解决吧，它可以解决跨域问题，也可以将瓦片缓存至本地，加快访问速度。

直接上配置文件哈。

#user  nobody;
worker_processes  4;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;
    
    client_max_body_size 20M;
    
　　 # 关键代码块1
    proxy_temp_path ../proxy_cache/tianditu_temp;
    proxy_cache_path ../proxy_cache/tianditu levels=1:2 keys_zone=cache_one:200m inactive=100d max_size=30g;
    upstream tianditu_server {
        server t0.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t1.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t2.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t3.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t4.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t5.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
        server t6.tianditu.com weight=1 max_fails=2 fail_timeout=30s;
    }
    
    server {
        listen       8088;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

　　　　 # 关键代码块2
        location /DataServer {
            more_set_headers 'Access-Control-Allow-Origin: *';
            add_header Access-Control-Allow-Headers X-Requested-With;
            add_header Access-Control-Allow-Methods GET,POST,OPTIONS;
            
            proxy_cache cache_one;
            proxy_cache_key $uri$is_args$args;
            proxy_pass http://tianditu_server/DataServer;
        }
    }

}

下面解释一下配置文件：

关键代码块1：

1、采用nginx upstream 配置一组服务地址，做负载均衡用，其效果优于openlayers顺序遍历t0至t6

2、设置了代理缓存临时地址和缓存地址，这里可以采用相对路径

关键代码块2

匹配到DataServer之后，需要

1、设置跨域header，这里用了一个新的nginx模块——headers-more，需要在编译nginx时加入，如果是windows下用nginx，可以用这个网站的安装包：https://openresty.org，它预编译了很多nginx实用模块

2、用proxy_pass将地址代理到 http://tianditu_server/DataServer 地址上，其中tianditu_server就是上面配置负载均衡的服务组名称。

补充：

最近访问天地图老出现503错误，然后过几分钟之前就正常了，这估计是天地图服务器承载不了过多请求，然后就抛出了503错误，所以为长久打算，还是有必要在自己的服务器上搭建一个nginx做代理缓存。