# jfp

**Repository Path**: java-tony/jfp

## Basic Information

- **Project Name**: jfp
- **Description**: Java Forward Proxy，基于java实现正向代理服务。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-12
- **Last Updated**: 2025-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jfp

#### 介绍
Java Forward Proxy，jfp，基于java实现正向代理，已实现HTTPS和HTTP正向代理。

正向代理，意思是一个位于客户端和原始服务器(origin server)之间的服务器，为了从原始服务器取得内容，客户端向代理发送一个请求并指定目标(原始服务器)，然后代理向原始服务器转交请求并将获得的内容返回给客户端，客户端才能使用正向代理。

正向代理中的客户端知道目标服务器的地址，目标服务器不知道实际客户端，只知道哪个代理服务器访问了它，即正向代理可以对目标服务器屏蔽或隐藏客户端的信息。

比如你电脑想访问的一个受限网站（https://www.limit.com），但是你的网络有限制，无法直接访问这个网站（位于某个服务器），你可以通过如下步骤实现正向代理访问：
1. 找一台可以访问这个网站的另外一台服务器（代理服务器，一般是带独立外网IP(域名)/端口的服务器），在上面部署该代理程序(配置好代理端口，启动程序，防火墙需要放开代理端口)。
2. 你电脑如果是window，可以在"网络和Internet"里找到代理配置，配置代理服务器地址（IP/域名）和端口并启用，然后你电脑浏览器就可以直接输入受限网站（https://www.limit.com）访问。
3. 访问过程：window系统会发送请求到”地址（IP/域名）和端口“对应的代理服务器，代理服务器上代理程序通过服务中转方式访问受限网站转发返回数据到你电脑。
4. 即你电脑的请求都发到代理服务器的代理服务上，代理服务转发请求信息到目标服务器（受限网站）并转发返回数据到你电脑。

#### 软件架构
软件架构说明
Spring Boot运行控制、配置管理）+Vert.x（服务管理、代理）

#### 安装教程

1.  在需要安装代理程序的代理服务器（带外网IP、端口）上安装jdk8+或jre8+
2.  上传部署包，修改配置文件[application.yml](src/main/resources/application.yml)里端口后，linux下使用脚本[start.sh](src/bin/start.sh)启动程序。
3.  linux下直接执行命令启动（其中最后的start参数会自动后台隐藏运行，如果不需要后台运行可以改为run参数或者去掉start参数）：java -server -Dfile.encoding=utf-8 -Dspring.config.location=./application.yml -Xms512m -Xmx1024m -jar jfp-1.0.0-SNAPSHOT.jar start
4.  windows下直接执行命令启动（其中最后的start参数会自动后台隐藏运行，如果不需要后台运行可以改为run参数或者去掉start参数）：java -server -Dfile.encoding=utf-8 -Dspring.config.location=./application.yml -Xms512m -Xmx1024m -jar jfp-1.0.0-SNAPSHOT.jar
5.  确保代理服务器上的端口防火墙放行。
6.  linux下如果是start参数启动的执行脚本停止服务[stop.sh](src/bin/stop.sh)
7. window下如果是start参数启动的，停止服务可以先通过java -jar jfp-1.0.0-SNAPSHOT.jar list查看vertxId，然后通过java -jar jfp-1.0.0-SNAPSHOT.jar stop vertxId停止。
8. window下如果最后是run参数或者jar后面不带run/start参数启动的，直接关闭cmd窗口或者ctr+c停止服务。
#### 使用说明

1.  确保代理服务器上的端口防火墙放行后，在window等电脑上配置代理IP(域名)、端口。
2.  在浏览器上输入本地网受限代理服务器访问不受限网站地址愉快地冲浪。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)