doc: update

This commit is contained in:
fatedier 2016-04-06 11:43:50 +08:00
parent bc176b90f1
commit d091e0eac9
4 changed files with 61 additions and 5 deletions

View File

@ -2,13 +2,17 @@
[![Build Status](https://travis-ci.org/fatedier/frp.svg)](https://travis-ci.org/fatedier/frp) [![Build Status](https://travis-ci.org/fatedier/frp.svg)](https://travis-ci.org/fatedier/frp)
[README](README.md) | [中文文档](README_zh.md)
## What is frp? ## What is frp?
frp is a fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet. frp is a fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.
## Status ## Status
frp is under development and you can try it with available version 0.3.0. 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.**
## Quick Start ## Quick Start
@ -31,3 +35,9 @@ Interested in getting involved? We would love to help you!
For simple bug fixes, just submit a PR with the fix and we can discuss the fix directly in the PR. If the fix is more complex, start with an issue. For simple bug fixes, just submit a PR with the fix and we can discuss the fix directly in the PR. If the fix is more complex, start with an issue.
If you have some wanderful ideas, send email to fatedier@gmail.com. If you have some wanderful ideas, send email to fatedier@gmail.com.
## Contributors
* [fatedier](https://github.com/fatedier)
* [Hurricanezwf](https://github.com/Hurricanezwf)
* [vashstorm](https://github.com/vashstorm)

40
README_zh.md Normal file
View File

@ -0,0 +1,40 @@
# frp
[![Build Status](https://travis-ci.org/fatedier/frp.svg)](https://travis-ci.org/fatedier/frp)
[README](README.md) | [中文文档](README_zh.md)
>frp 是一个高性能的反向代理应用,可以帮助你轻松的进行内网穿透,对外网提供服务。
## 开发状态
frp 目前正在前期开发阶段master分支用于发布稳定版本dev分支用于开发您可以尝试下载最新的 release 版本进行测试。
**在 1.x 版本以前,交互协议都可能会被改变,不能保证向后兼容。**
## 快速开始
[QuickStart](doc/quick_start_en.md) | [使用文档](doc/quick_start_zh.md)
## 架构
![architecture](doc/pic/architecture.png)
## frp 的作用?
* 利用处于内网或防火墙后的机器对外网环境提供http服务。针对http的优化正在开发中
* 利用处于内网或防火墙后的机器对外网环境提供tcp服务。
* 可查看通过代理的所有http请求和响应信息。待开发
## 贡献代码
如果您对这个项目感兴趣,并且想要参与其中,我们非常欢迎!
* 如果您需要提交问题,可以通过 [issue](https://github.com/fatedier/frp/issues) 来完成。
* 如果您有新的功能需求,可以反馈至 fatedier@gmail.com 共同讨论。
## 贡献者
* [fatedier](https://github.com/fatedier)
* [Hurricanezwf](https://github.com/Hurricanezwf)
* [vashstorm](https://github.com/vashstorm)

View File

@ -44,7 +44,7 @@ log_level = info
# test is the custom name of proxy and there can be many proxies with unique name in one configure file # test is the custom name of proxy and there can be many proxies with unique name in one configure file
[test] [test]
passwd = 123 auth_token = 123
bind_addr = 0.0.0.0 bind_addr = 0.0.0.0
# finally we connect to server A by this port # finally we connect to server A by this port
listen_port = 6000 listen_port = 6000
@ -59,10 +59,13 @@ server_addr = x.x.x.x
server_port = 7000 server_port = 7000
log_file = ./frpc.log log_file = ./frpc.log
log_level = info log_level = info
# for authentication
auth_token = 123
# test is proxy name same with configure in frps.ini # test is proxy name same with configure in frps.ini
[test] [test]
passwd = 123
# local port which need to be transferred # local port which need to be transferred
local_port = 22 local_port = 22
# if use_encryption equals true, messages between frpc and frps will be encrypted, default is false
use_encryption = true
``` ```

View File

@ -42,7 +42,7 @@ log_level = info
# test 为代理的自定义名称可以有多个不能重复和frpc中名称对应 # test 为代理的自定义名称可以有多个不能重复和frpc中名称对应
[test] [test]
passwd = 123 auth_token = 123
bind_addr = 0.0.0.0 bind_addr = 0.0.0.0
# 最后将通过此端口访问后端服务 # 最后将通过此端口访问后端服务
listen_port = 6000 listen_port = 6000
@ -57,10 +57,13 @@ server_addr = x.x.x.x
server_port = 7000 server_port = 7000
log_file = ./frpc.log log_file = ./frpc.log
log_level = info log_level = info
# 用于身份验证
auth_token = 123
# test需要和 frps.ini 中配置一致 # test需要和 frps.ini 中配置一致
[test] [test]
passwd = 123
# 需要转发的本地端口 # 需要转发的本地端口
local_port = 22 local_port = 22
# 启用加密frpc与frps之间通信加密默认为 false
use_encryption = true
``` ```