cloverzrg/portforwarder

portforwarder 镜像文档

镜像概述

portforwarder 是一款功能全面的端口转发工具，提供集中化的端口转发管理能力，支持多用户环境下的权限控制与流量监控，适用于需要精细化管理端口转发规则的场景。

核心功能与特性

• 仪表板管理：提供可视化Web界面，用于配置、监控和管理端口转发规则
• 多用户支持：支持多用户账户体系，实现用户隔离与独立权限管理
• 端口与接口权限控制：精细化控制用户对特定端口和网络接口的访问及操作权限
• 流量分析：实时采集并分析转发流量数据，提供流量统计与可视化展示
• 多网络接口支持：兼容多种网络接口配置，可在复杂网络环境中灵活部署
• 速率限制：支持对转发流量设置速率上限，有效控制带宽使用

使用场景与适用范围

• 企业网络环境中需要为不同部门或用户分配独立端口转发权限的场景
• 开发测试环境中需要临时配置端口转发并进行流量监控的场景
• 多网络接口服务器中需要集中管理端口转发规则的场景
• 对端口转发流量有带宽限制需求的网络环境

使用方法与配置说明

基本部署

Docker Run 示例：

bash
docker run -d \
  --name portforwarder \
  -p 8080:8080 \  # 仪表板访问端口
  -v /path/to/config:/app/config \  # 配置文件持久化
  -v /path/to/logs:/app/logs \  # 日志文件持久化
  --restart unless-stopped \
  portforwarder:latest

初始访问

容器启动后，通过以下地址访问管理仪表板： http://[宿主机IP]:8080

核心配置方向

1. 用户管理

   • 通过仪表板创建管理员及普通用户账户
   • 配置用户角色与权限范围

2. 端口转发规则配置

   • 添加转发规则（源端口、目标地址、目标端口）
   • 选择绑定的网络接口
   • 设置速率限制参数（如：100Mbps）

3. 权限控制

   • 为不同用户分配特定端口和接口的操作权限
   • 配置读写权限分离

注意事项

• 该镜像目前处于未发布状态（not released），生产环境使用前需确认官方正式发布版本
• 建议使用持久化存储卷保存配置和日志数据，避免容器重启后配置丢失
• 首次使用需通过初始管理员账户登录并完成基础配置

环境变量（推测）

由于镜像未正式发布，以下为基于功能特性的常用环境变量推测：

• ADMIN_USER：默认管理员用户名
• ADMIN_PASSWORD：默认管理员密码
• DASHBOARD_PORT：仪表板服务端口（默认8080）
• LOG_LEVEL：日志级别（默认info）