Skip to content

An image proxy using the Express Node.js framework

License

Notifications You must be signed in to change notification settings

uhuraapp/image-proxy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Image Proxy

NPM version Build Status Dependency Status Coverage Status

A simple Express app for proxying and manipulating images, specifically headshots.

The code is just over 100 lines, making it easy to tailor to your needs.

Getting Started

npm install
npm start
curl -I http://localhost:5000/http%3A%2F%2Fwww.opennorth.ca%2Fimg%2Fheader_logo.png/352/72

The URL structure is /:url/:width/:height. The :url parameter must be escaped/encoded. If the remote image's width or height is greater than the given :width or :height, it will be resized, maintaining aspect ratio, and cropped. If smaller, it will be padded with white pixels. The equivalent ImageMagick command for the example URL above is:

convert input.jpg -thumbnail 352x72^> -gravity center -extent 352x72 output.jpg

The Cache-Control header sets a max-age of one year.

Features

Image proxy:

  • Supports HTTP and HTTPS
  • Follows 301 and 302 redirects
  • Sets a maximum timeout for the remote server
  • Handles complex MIME types like image/jpeg; charset=utf-8
  • Optional whitelisting using regular expressions

Image manipulation:

  • Accepts a custom width and height, up to 1000x1000
  • Resizes, centers and crops the image

HTTP server:

  • No query string parameters (preferred by CloudFront)
  • Adds a Cache-Control header

If you need more features, see node-imageable and node-imageable-server.

Environment variables

  • DELAY: The timeout delay in milliseconds, after which the proxy will respond with a HTTP 504 Gateway Timeout server error. Default: 5000
  • WHITELIST: A comma-separated list of domains to whitelist, e.g. .gov,facebook.com, which will be transformed into the regular expressions /\.gov$/ and /facebook\.com$/.
  • PORT: If running the server, changes the port on which it listens. Default: 5000

Deployment

Heroku

git clone https://github.com/jpmckinney/image-proxy.git
heroku create
heroku config:set NODE_ENV=production
git push heroku master
heroku apps:open

AWS CloudFront

Create a distribution and set the "Origin Domain Name" to the domain name of your Heroku app.

Testing

npm test

Acknowledgements

This project is inspired by node-connect-image-proxy.

Copyright (c) 2013 James McKinney, released under the MIT license

About

An image proxy using the Express Node.js framework

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%