# portlocalforward

**Repository Path**: wanghost/portlocalforward

## Basic Information

- **Project Name**: portlocalforward
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-28
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 端口本地转发管理工具

一个基于 Spring Boot 和 Vue 3 的端口本地转发管理工具，支持通过 SSH 隧道将本地端口转发到远程主机。

## 核心功能

- 🔐 **SSH 隧道管理**：创建、编辑、删除 SSH 隧道配置
- 🔄 **端口转发管理**：通过 SSH 隧道实现本地端口到远程主机的转发
- 🏷️ **标签管理**：为端口转发配置添加标签，方便分类和管理
- ⚡ **批量操作**：支持批量启动、停止端口转发，批量切换 SSH 隧道
- 📊 **实时状态监控**：实时显示端口转发的连接状态

## 使用说明

### 环境依赖

- **Java**：JDK 1.8 或更高版本

> 💡 **提示**：如果 `release` 目录中已有构建好的文件，可以直接使用，无需重新构建，这是最快的应用方式。

### 系统部署

#### 方式一：快速启动（推荐首次使用）

直接使用 `release` 目录中的文件，无需构建：

1. **运行应用**
   ```bash
   cd release
   java -jar port-local-forward-api-1.0.0.jar
   ```

2. **访问应用**
   
   打开浏览器访问：`http://localhost:8080`

#### 方式二：Windows 服务方式（设置开机自启动）

支持开机自启动和后台运行。

1. **安装服务**
   ```bash
   cd release
   install.cmd
   ```
   或手动执行：
   ```bash
   port-local-forward.exe install
   port-local-forward.exe start
   ```

2. **管理服务**
   - 启动服务：`port-local-forward.exe start`
   - 停止服务：`port-local-forward.exe stop`
   - 卸载服务：`uninstall.cmd` 或 `port-local-forward.exe uninstall`

3. **访问应用**
   
   打开浏览器访问：`http://localhost:8080`

**注意**：Windows 服务方式需要管理员权限运行。

### 系统使用

#### 创建 SSH 隧道

1. 进入"SSH 隧道管理"页面
2. 点击"新增"按钮
3. 填写 SSH 连接信息（主机、端口、用户名、密码）
4. 点击"保存"

#### 创建端口转发

1. 进入"端口转发管理"页面
2. 点击"新增"按钮
3. 选择 SSH 隧道，配置本地端口和远程主机端口
4. 点击"保存"后，点击"启动"按钮开始转发

## 开发模式

### 技术栈

**后端**：Spring Boot 2.7.18 + Java 8 + H2 Database + JSch

**前端**：Vue 3 + Vite + Element Plus + Pinia + Vue-router

### 环境要求

- **Java**：JDK 1.8 或更高版本
- **Maven**：3.6 或更高版本
- **Node.js**：16 或更高版本

### 启动开发环境

**启动后端**：
```bash
cd api
mvn spring-boot:run
```
后端服务运行在 `http://localhost:8080`

**启动前端**：
```bash
cd web
npm install
npm run dev
```
前端开发服务器运行在 `http://localhost:5173`

### 构建项目

如果需要重新构建项目：

```bash
build.cmd
```

构建完成后，JAR 包和前端静态文件将输出到 `release` 目录。

### 开发工具

#### Swagger API 文档

启动应用后，访问 Swagger API 文档：

```
http://localhost:8080/swagger-ui/
```

#### H2 数据库控制台

访问 H2 数据库控制台：

- URL：`http://localhost:8080/h2-console`
- JDBC URL：`jdbc:h2:file:./data/port-local-forward`
- 用户名：`sa`
- 密码：`password`

## 许可证

MIT License