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

服务器 2025/10/31 佚名

3 2 1

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

1.天地图矢量：http://t{0-6}.tianditu.com/DataServer"htmlcode">

// 采用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=1d 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就是上面配置负载均衡的服务组名称。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

nginx,代理解决跨域,nginx代理天地图跨域