Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/phette23/iis7-web-config
web.config optimizations (gzip, caching, etc.) for IIS7.5
https://github.com/phette23/iis7-web-config
Last synced: 27 days ago
JSON representation
web.config optimizations (gzip, caching, etc.) for IIS7.5
- Host: GitHub
- URL: https://github.com/phette23/iis7-web-config
- Owner: phette23
- Created: 2012-12-20T00:32:21.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2014-01-02T20:26:01.000Z (almost 11 years ago)
- Last Synced: 2024-04-14T23:15:24.550Z (7 months ago)
- Size: 137 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# web.config Tweaks for IIS7.5
This is a sample web.config file for applying performance optimizations & security tweaks in Microsoft's proprietary server software. The overall goals are:
- GZIP responses (the `httpCompression` section)
- Setup a caching framework (the `staticContent` section of static/web.config)
- Force the latest IE rendering engine (the `X-UA-Compatible` header)
- Don't unnecessarily reveal server information
Much of the code comes from the [HTML5 Boilerplate server configs](https://github.com/h5bp/server-configs/) repo, but I had to break off on my own because there are some problems with their approach. It's still an excellent project but I needed a better source of IIS defaults. I may need to revisit the H5BP project because it looks like it's [being maintained a lot better now](https://github.com/h5bp/server-configs-iis/commits/master).
## Caching is hard
What's wrong with the H5BP web.configs? They *far-future cache an appcache manifest* which is [a bad idea](https://speakerdeck.com/jaffathecake/application-cache-douchebag?slide=35 "Pertinent slide from the Appcache Douchebag deck"). That makes it impossible to update a website for the duration set in the expires header. HTML is also far-future cached which makes it impossible to update references to other resources. If you don't use an appcache (I do, sometimes), you may be fine with their web.config.
In order to cache static content _without_ caching HTML and .manifest files, I've unfortunately had to resort to using a directory structure that disables caching at the root and then enables it in subdirectory which holds all the static assets. So the root holds the server-side scripts or HTML files and the appcache, while JS, CSS, and images would all be in subdirectories which use the static/web.config in this repo.
## Testing Notes
I test using `curl` in bash. If there's a better way, I don't know it.
```bash
curl -LI http://domain.tld/path/to/file
```
Should return something like:
```
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 31991
Content-Type: text/html; charset=UTF-8
Last-Modified: Mon, 05 Jan 1904 16:20:17 GMT
Accept-Ranges: bytes
Server:
X-UA-Compatible: IE=Edge,chrome=1
Date: Mon, 16 Jun 1904 22:58:15 GMT
```
while
```bash
curl -LI http://domain.tld/path/to/static/file.png
```
Should return something like:
```
HTTP/1.1 200 OK
Cache-Control: max-age=5184000
Content-Length: 7825
Content-Type: image/png
Last-Modified: Tue, 18 Jan 1904 20:37:35 GMT
Accept-Ranges: bytes
Server:
X-UA-Compatible: IE=Edge,chrome=1
Date: Mon, 16 Jun 1904 22:59:29 GMT
```
Note the differences in the Cache-Control header.
## Caveats
- I'm not a server guy, I'm a frontend web guy. These files might suck.
- Not tested anywhere except our dev & production servers. Probably IIS7.5 specific, definitely won't work on IIS6.
- A lot of this is probably easily done through the Server Manager GUI, but I don't know how to use that thing and prefer text configuration files which can be versioned.
## License
[WTFPL](http://sam.zoy.org/wtfpl/)
The image included in the static directory is in the Public Domain (yay!) & I found it via the awesome [Noun Project](http://thenounproject.com/noun/library/#icon-No191).
[](https://github.com/igrigorik/ga-beacon)