2015-12-21 23:25:54 +08:00
|
|
|
# frp
|
2016-02-03 18:40:46 +08:00
|
|
|
|
|
|
|
[![Build Status](https://travis-ci.org/fatedier/frp.svg)](https://travis-ci.org/fatedier/frp)
|
|
|
|
|
2016-04-06 11:43:50 +08:00
|
|
|
[README](README.md) | [中文文档](README_zh.md)
|
|
|
|
|
2016-03-14 15:26:26 +08:00
|
|
|
## What is frp?
|
|
|
|
|
2016-03-17 11:04:40 +08:00
|
|
|
frp is a fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.
|
2016-03-14 15:26:26 +08:00
|
|
|
|
2016-04-19 18:53:48 +08:00
|
|
|
## What can I do with frp?
|
|
|
|
|
|
|
|
* Expose any http service behind a NAT or firewall to the internet by a server with public IP address(Name-based Virtual Host Support).
|
|
|
|
* Expose any tcp service behind a NAT or firewall to the internet by a server with public IP address.
|
|
|
|
* Inspect all http requests/responses that are transmitted over the tunnel(future).
|
|
|
|
|
2016-03-14 15:26:26 +08:00
|
|
|
## Status
|
|
|
|
|
2016-04-06 11:43:50 +08:00
|
|
|
frp is under development and you can try it with latest release version.Master branch for releasing stable version when dev branch for developing.
|
|
|
|
|
|
|
|
**We may change any protocol and can't promise backward compatible before version 1.x.**
|
2016-03-14 15:26:26 +08:00
|
|
|
|
|
|
|
## Quick Start
|
|
|
|
|
2016-03-14 15:27:54 +08:00
|
|
|
Read the [QuickStart](doc/quick_start_en.md) | [使用文档](doc/quick_start_zh.md)
|
2016-03-14 15:26:26 +08:00
|
|
|
|
2016-04-19 18:53:48 +08:00
|
|
|
[Tcp port forwarding](doc/quick_start_en.md#Tcp-port-forwarding)
|
2016-03-14 15:26:26 +08:00
|
|
|
|
2016-04-19 18:53:48 +08:00
|
|
|
[Http port forwarding and Custom domain binding](doc/quick_start_en.md#Http-port-forwarding-and-Custom-domains-binding)
|
2016-03-14 15:26:26 +08:00
|
|
|
|
2016-04-19 18:53:48 +08:00
|
|
|
## Architecture
|
2016-03-14 15:26:26 +08:00
|
|
|
|
2016-04-19 18:53:48 +08:00
|
|
|
![architecture](doc/pic/architecture.png)
|
2016-03-14 16:18:29 +08:00
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
Interested in getting involved? We would love to help you!
|
|
|
|
|
2016-04-06 11:51:12 +08:00
|
|
|
* Take a look at our [issues list](https://github.com/fatedier/frp/issues) and consider submitting a patch
|
|
|
|
* If you have some wanderful ideas, send email to fatedier@gmail.com.
|
2016-04-06 11:43:50 +08:00
|
|
|
|
|
|
|
## Contributors
|
|
|
|
|
|
|
|
* [fatedier](https://github.com/fatedier)
|
|
|
|
* [Hurricanezwf](https://github.com/Hurricanezwf)
|
|
|
|
* [vashstorm](https://github.com/vashstorm)
|