快速开始

通过几个简单的步骤,快速了解如何使用端口转发面板

1. 创建端口转发

在"端口转发"页面,您可以:

  • 填写本地端口(要监听的端口)
  • 填写目标地址(要转发到的地址)
  • 填写目标端口(要转发到的端口)
  • 选择协议类型(TCP或HTTPS)

2. 管理转发

在转发列表中,您可以:

  • 查看转发状态(运行中/已停止)
  • 启动/停止转发
  • 查看流量统计
  • 删除不需要的转发

3. 监控系统

在仪表盘中,您可以查看:

  • CPU、内存、磁盘使用率
  • 实时网络流量
  • 端口使用情况

API认证

了解如何获取和使用API令牌进行身份验证

获取API令牌

在使用API之前,您需要先获取API令牌:

  1. 进入系统设置页面
  2. 找到"API令牌管理"部分
  3. 点击"创建令牌"按钮
  4. 填写令牌描述并选择有效期
  5. 保存生成的令牌(令牌只显示一次)
请求头示例
X-API-Token: your_token_here

所有API请求都需要在请求头中包含API令牌

API测试工具

下载API测试工具,快速开始测试API功能

API测试工具

下载我们的API测试工具,快速验证API功能,无需编写代码即可测试所有API接口。
支持Windows系统,解压即可使用。

主要功能:

  • ✓ 可视化界面操作
  • ✓ 支持所有API接口测试
  • ✓ 自动保存配置
  • ✓ 实时显示请求结果
下载测试工具

文件大小:约 15MB | 版本:v1.0.0

转发管理API

通过API管理端口转发

GET /api/v1/forwards

获取所有端口转发列表

响应示例
{
    "status": "success",
    "data": [
        {
            "local_port": 80,
            "target_host": "example.com",
            "target_port": 80,
            "protocol": "tcp",
            "status": "active"
        }
    ]
}
POST /api/v1/forwards

创建新的端口转发

请求参数

参数名 类型 必填 说明
local_port number 本地端口(1-65535)
target_host string 目标主机地址
target_port number 目标端口(1-65535)
protocol string 协议类型(tcp/https),默认tcp
请求示例
{
    "local_port": 80,
    "target_host": "example.com",
    "target_port": 80,
    "protocol": "tcp"
}
DELETE /api/v1/forwards/{local_port}

删除指定端口的转发

响应示例
{
    "status": "success",
    "message": "转发已删除"
}

示例代码

各种编程语言的API调用示例

Python
import requests

class PortForwardClient:
    def __init__(self, base_url, api_token):
        self.base_url = base_url
        self.headers = {'X-API-Token': api_token}
    
    def get_forwards(self):
        """获取所有转发"""
        response = requests.get(
            f'{self.base_url}/api/v1/forwards',
            headers=self.headers
        )
        return response.json()
    
    def create_forward(self, local_port, target_host, target_port, protocol='tcp'):
        """创建新的转发"""
        data = {
            'local_port': local_port,
            'target_host': target_host,
            'target_port': target_port,
            'protocol': protocol
        }
        response = requests.post(
            f'{self.base_url}/api/v1/forwards',
            headers=self.headers,
            json=data
        )
        return response.json()
    
    def delete_forward(self, local_port):
        """删除转发"""
        response = requests.delete(
            f'{self.base_url}/api/v1/forwards/{local_port}',
            headers=self.headers
        )
        return response.json()

# 使用示例
client = PortForwardClient('http://your-server:5000', 'your-api-token')

# 获取所有转发
forwards = client.get_forwards()
print(forwards)

# 创建转发
result = client.create_forward(80, 'example.com', 80)
print(result)

# 删除转发
result = client.delete_forward(80)
print(result)
Shell
#!/bin/bash

# 配置
API_TOKEN="your-api-token"
SERVER_URL="http://your-server:5000"

# 获取转发列表
get_forwards() {
    curl -H "X-API-Token: $API_TOKEN" \
         "$SERVER_URL/api/v1/forwards"
}

# 创建转发
create_forward() {
    local local_port=$1
    local target_host=$2
    local target_port=$3
    local protocol=${4:-tcp}
    
    curl -X POST \
         -H "X-API-Token: $API_TOKEN" \
         -H "Content-Type: application/json" \
         -d "{
             \"local_port\": $local_port,
             \"target_host\": \"$target_host\",
             \"target_port\": $target_port,
             \"protocol\": \"$protocol\"
         }" \
         "$SERVER_URL/api/v1/forwards"
}

# 删除转发
delete_forward() {
    local local_port=$1
    
    curl -X DELETE \
         -H "X-API-Token: $API_TOKEN" \
         "$SERVER_URL/api/v1/forwards/$local_port"
}

# 使用示例
echo "获取所有转发:"
get_forwards

echo -e "\n创建新转发:"
create_forward 80 "example.com" 80

echo -e "\n删除转发:"
delete_forward 80

基础使用

详细了解端口转发面板的基本功能和使用法

仪表盘

在仪表盘中,您可以:

  • 系统监控:实时显示CPU、内存、磁盘使用率
  • 网络流量:监控实时上传和下载速度
  • 图表展示:直观展示系统资源使用趋势
  • 端口统计:查看已用和可用端口数量

端口转发

在端口转发页面,您可以:

  • 创建转发:设置本地端口、目标地址和端口
  • 管理转发:启动、停止、删除转发
  • 流量统计:查看每个端口的流量使用情况
  • 批量操作:支持重置所有转发

系统设置

在系统设置中,您可以:

  • 异常通知:配置邮件通知,及时获知系统异常
  • API管理:创建和管理API令牌
  • 阈值设置:自定义系统资源告警阈值

功能介绍

端口转发管理面板的核心功能

端口转发

  • 多协议支持:支持TCP和HTTPS协议
  • 流量监控:实时统计每个端口的流量
  • 状态管理:可随时启动/停止转发
  • 批量操作:支持一键重置所有转发

系统监控

  • 资源监控:CPU、内存、磁盘使用率
  • 流量统计:实时网络流量监控
  • 图表展示:直观的数据可视化
  • 历史记录:查看历史使用趋势

异常通知

  • 邮件通知:系统异常时发送邮件提醒
  • 阈值设置:自定义告警触发条件
  • 实时预警:及时发现系统问题
  • 通知测试:支持发送测试通知

API接口

  • 完整API:支持所有管理功能
  • 安全认证:基于令牌的身份验证
  • 示例代码:多语言调用示例
  • 接口文档:详细的API说明

常见问题

常见问题解答

Q: 端口使用数与转发列表不一致怎么办?

A: 如果发现可用端口数量比转发列表显示的转发数量少,或者转发列表显示不完整,可以:

  • 点击面板上的"重置所有转发"按钮
  • 这将清理所有转发记录并重置端口使用数
  • 重置后可重新添加需要的转发

注意:重置操作会删除所有现有转发,请谨慎操作!

Q: 如何重置所有端口转发?

A: 在端口转发页面,点击"重置所有转发"按钮即可。此操作会删除所有转发配置,请谨慎操作。

Q: 为什么端口转发失败?

A: 常见原因包括:

  • 端口已被其他程序占用
  • 防火墙阻止了端口访问
  • 目标地址无法连接
  • 系统资源不足

Q: 如何查看端口流量统计?

A: 在转发列表中,每个端口都会显示实时的上传和下载流量统计。

Q: 如何设置异常通知?

A: 在系统设置页面,启用异常通知,填写接收邮箱并设置告警阈值即可。

更新日志

版本更新记录

当前版本 v1.0.0

2024-03-26

  • ✨ 这是最新版本,暂无更新
  • 🚀 包含所有最新功能
  • 💪 性能稳定可靠