Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including tilestrata-proxy with all npm packages installed. Try it out:

require("tilestrata/package.json"); // tilestrata is a peer dependency. var tilestrataProxy = require("tilestrata-proxy")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

tilestrata-proxy v0.5.1

A TileStrata plugin for proxying remote tiles


NPM version Build Status Coverage Status

A TileStrata plugin for proxying tile requests. Commonly this is needed when you have a beefy vector tile server, and want rendering to happen on cheaper, more-lightweight boxes for scaling purposes.

Sample Usage

var tilestrata = require('tilestrata');
var vtileraster = require('tilestrata-vtile-raster');
var proxy = require('tilestrata-proxy');
var strata = tilestrata();

// route that proxies from an upstream server
strata.layer('vtiles').route('t.pbf').use(proxy({uri: '{z}/{x}/{y}.mvt'}));

// rasterize the vector tiles
    xml: '/home/ybon/Code/maps/thankyou/mapnik.xml',
    tileSize: 256,
    metatile: 1,
    bufferSize: 128,
    tilesource: ['vtiles', 't.pbf']


The plugin will automatically decompress gzipped content by default regardless of the client's Accept-Encoding header. This is due to the fact that proxied content is often used as part of a pipeline (it's not served directly to the client). This isn't always the case though. Decompression behavior is configurable:

// always decompress gzipped content
proxy({decompress: 'always'});

// decompress only if the client does not support compression
proxy({decompress: 'client'});

// never decompress gzipped content
proxy({decompress: 'never'});

To specify custom request headers, use the headers option:

    uri: '...',
    headers: {
        'User-Agent': 'TileStrata/' + tilestrata.version

Other Options

// spread requests across different subdomains ala leaflet
.use(proxy({uri: 'http://{s}{z}/{x}/{y}.png', subdomains: 'abc'}));
.use(proxy({uri: 'http://{s}{z}/{x}/{y}.png', subdomains: ['a', 'b', 'c']}));

// request arbitrary urls
.use(proxy({uri: tile => {
    // note: if you return a falsy value this will cause a 404 Not Found to be returned
    return '' + tile.z + '/' + tile.x + '/' + tile.y + '.png';


Before submitting pull requests, please update the tests and make sure they all pass.

$ npm test


Copyright © 2015–2017 Yohan Boniface & Contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free