Skip to content

Commit

Permalink
0.2.0 release docs
Browse files Browse the repository at this point in the history
  • Loading branch information
daguej committed Oct 10, 2013
1 parent 7338ee0 commit 064a731
Show file tree
Hide file tree
Showing 3 changed files with 27 additions and 2 deletions.
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
CHANGELOG
=========

0.2.0 (2013-10-10)

- Added `options` parameter, ability to disable strict protocol checks. Thanks to kylegetson.

0.1.2 (2013-08-01)

- Removed a `console.log` call that was accidentally left in.

0.1.1 (2013-07-31)

- Initial release.
13 changes: 12 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,15 @@ You can do the same with `net` (raw TCP streams), `https`, and `spdy`. It will

var proxiedSpdy = require('proxywrap').proxy(require('spdy').server);

**Warning:** *All* traffic to your proxied server MUST use the PROXY protocol. If the first five bytes received aren't `PROXY`, the connection will be dropped. Obviously, the node server accepting PROXY connections should not be exposed directly to the internet; only the proxy (whether ELB, HAProxy, or something else) should be able to connect to node.
**Warning:** By default, *all* traffic to your proxied server MUST use the PROXY protocol. If the first five bytes received aren't `PROXY`, the connection will be dropped. Obviously, the node server accepting PROXY connections should not be exposed directly to the internet; only the proxy (whether ELB, HAProxy, or something else) should be able to connect to node.

API
---

### `proxy(Server[, options])`

Wraps something that inherits from the `net` module, exposing a `Server` and `createServer`. Returns the same module patched to support the PROXY protocol.

Options:

- `strict` (default `true`): Incoming connections MUST use the PROXY protocol. If the first five bytes received aren't `PROXY`, the connection will be dropped. Disabling this option will allow connections that don't use the PROXY protocol (so long as the first bytes sent aren't `PROXY`). Disabling this option poses a security risk; it should be enabled in production.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "proxywrap",
"version": "0.1.2",
"version": "0.2.0",
"description": "Wraps node's Server interfaces to be compatible with the PROXY protocol",
"main": "proxywrap.js",
"engines": { "node": ">= 0.10.0" },
Expand Down

0 comments on commit 064a731

Please sign in to comment.