Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitlab-pages.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/github.com/sebest/xff/README.md')
-rw-r--r--vendor/github.com/sebest/xff/README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/vendor/github.com/sebest/xff/README.md b/vendor/github.com/sebest/xff/README.md
new file mode 100644
index 00000000..41a518ab
--- /dev/null
+++ b/vendor/github.com/sebest/xff/README.md
@@ -0,0 +1,44 @@
+# X-Forwarded-For middleware fo Go [![godoc](http://img.shields.io/badge/godoc-reference-blue.svg?style=flat)](https://godoc.org/github.com/sebest/xff) [![Build Status](https://travis-ci.org/sebest/xff.svg?branch=master)](https://travis-ci.org/sebest/xff)
+
+Package `xff` is a `net/http` middleware/handler to parse [Forwarded HTTP Extension](http://tools.ietf.org/html/rfc7239) in Golang.
+
+## Example usage
+
+Install `xff`:
+
+ go get github.com/sebest/xff
+
+Edit `server.go`:
+
+```go
+package main
+
+import (
+ "net/http"
+
+ "github.com/sebest/xff"
+)
+
+func main() {
+ handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Write([]byte("hello from " + r.RemoteAddr + "\n"))
+ })
+
+ xffmw, _ := xff.Default()
+ http.ListenAndServe(":8080", xffmw.Handler(handler))
+}
+```
+
+Then run your server:
+
+ go run server.go
+
+The server now runs on `localhost:8080`:
+
+ $ curl -D - -H 'X-Forwarded-For: 42.42.42.42' http://localhost:8080/
+ HTTP/1.1 200 OK
+ Date: Fri, 20 Feb 2015 20:03:02 GMT
+ Content-Length: 29
+ Content-Type: text/plain; charset=utf-8
+
+ hello from 42.42.42.42:52661