@chenpu17/tcpmapping 2.0.0

package/README.md

@@ -0,0 +1,103 @@
+# TCP转发服务器
+
+一个功能强大、安全可靠的TCP端口转发服务器，支持多端口映射、WebUI管理界面和实时连接监控。
+
+## 功能特性
+
+### 核心功能
+- **TCP协议端口转发** - 将TCP请求转发到后端服务器
+- **多端口映射配置** - 同时支持多个端口转发规则
+- **动态配置管理** - 通过WebUI实时添加/删除/启动/停止端口映射
+- **连接监控** - 实时显示每个映射的连接数和流量统计
+
+### WebUI管理界面
+- 现代化响应式Web界面
+- 实时系统状态监控（映射数、连接数、运行时间）
+- 每个端口映射的连接数和流量统计
+- 映射的启动/停止控制
+
+### 安全特性
+- 强密码策略（8字符+大小写+数字）
+- 登录失败保护（5次失败锁定30分钟）
+- 会话管理（24小时自动超时）
+- bcrypt 12轮密码哈希加密
+- 自动生成的Session Secret
+
+## 快速开始
+
+### 安装
+```bash
+# 安装依赖
+npm install
+
+# 设置管理员密码
+npm run setup-password
+
+# 启动服务器
+npm start
+```
+
+### 访问
+启动后访问 **http://localhost:9999** 进入管理界面。
+
+## 配置说明
+
+编辑 `config.json` 配置端口映射：
+
+```json
+{
+  "mappings": [
+    {
+      "name": "服务名称",
+      "listen": { "host": "0.0.0.0", "port": 8080 },
+      "target": { "host": "192.168.1.100", "port": 3000 }
+    }
+  ],
+  "webui": { "enabled": true, "port": 9999, "host": "0.0.0.0" },
+  "logging": { "enabled": true, "level": "info" }
+}
+```
+
+## 项目结构
+
+```
+├── server.js           # 主服务器
+├── config.json         # 端口映射配置
+├── auth-config.json    # 认证配置（敏感）
+├── setup-password.js   # 密码设置工具
+├── package.json        # 项目配置
+├── .gitignore          # Git忽略规则
+├── public/             # Web界面
+│   ├── login.html      # 登录页面
+│   └── dashboard.html  # 管理面板
+└── docs/               # 文档目录
+    ├── API.md          # API接口文档
+    ├── 功能总结.md      # 功能清单
+    └── 安全配置说明.md  # 安全指南
+```
+
+## API接口
+
+详细API文档请参阅 [docs/API.md](docs/API.md)
+
+主要接口：
+- `GET /api/health` - 健康检查（无需认证）
+- `POST /api/login` - 登录
+- `GET /api/mappings` - 获取映射列表（含连接数统计）
+- `POST /api/mappings` - 添加映射
+- `PUT /api/mappings/:id` - 更新映射
+- `DELETE /api/mappings/:id` - 删除映射
+- `POST /api/mappings/:id/start` - 启动映射
+- `POST /api/mappings/:id/stop` - 停止映射
+- `GET /api/connections` - 获取连接状态
+- `GET /api/status` - 获取系统状态
+
+## 技术栈
+
+- **后端**: Node.js, Express.js, bcryptjs
+- **前端**: 原生HTML/CSS/JavaScript
+- **安全**: bcrypt密码哈希, Session管理
+
+## 许可证
+
+MIT License 

package/bin/tcpmapping.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const APP_NAME = 'tcpmapping';
+const PID_FILE = path.join(os.tmpdir(), 'tcpmapping.pid');
+const LOG_FILE = path.join(os.tmpdir(), 'tcpmapping.log');
+const SERVER_FILE = path.join(__dirname, '..', 'server.js');
+const SETUP_PASSWORD_FILE = path.join(__dirname, '..', 'setup-password.js');
+
+// 获取命令行参数
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+// 颜色输出
+const colors = {
+  green: (text) => `\x1b[32m${text}\x1b[0m`,
+  red: (text) => `\x1b[31m${text}\x1b[0m`,
+  yellow: (text) => `\x1b[33m${text}\x1b[0m`,
+  blue: (text) => `\x1b[34m${text}\x1b[0m`,
+  cyan: (text) => `\x1b[36m${text}\x1b[0m`
+};
+
+// 检查进程是否运行
+function isRunning() {
+  if (!fs.existsSync(PID_FILE)) {
+    return false;
+  }
+
+  const pid = fs.readFileSync(PID_FILE, 'utf8').trim();
+
+  try {
+    process.kill(parseInt(pid), 0);
+    return parseInt(pid);
+  } catch (e) {
+    // 进程不存在，清理PID文件
+    fs.unlinkSync(PID_FILE);
+    return false;
+  }
+}
+
+// 启动服务
+function start() {
+  const pid = isRunning();
+  if (pid) {
+    console.log(colors.yellow(`${APP_NAME} is already running (PID: ${pid})`));
+    return;
+  }
+
+  console.log(colors.blue(`Starting ${APP_NAME}...`));
+
+  const out = fs.openSync(LOG_FILE, 'a');
+  const err = fs.openSync(LOG_FILE, 'a');
+
+  const child = spawn('node', [SERVER_FILE], {
+    detached: true,
+    stdio: ['ignore', out, err],
+    cwd: path.dirname(SERVER_FILE)
+  });
+
+  fs.writeFileSync(PID_FILE, child.pid.toString());
+  child.unref();
+
+  console.log(colors.green(`${APP_NAME} started successfully (PID: ${child.pid})`));
+  console.log(colors.cyan(`WebUI: http://localhost:9999`));
+  console.log(colors.cyan(`Log file: ${LOG_FILE}`));
+}
+
+// 停止服务
+function stop() {
+  const pid = isRunning();
+  if (!pid) {
+    console.log(colors.yellow(`${APP_NAME} is not running`));
+    return;
+  }
+
+  console.log(colors.blue(`Stopping ${APP_NAME} (PID: ${pid})...`));
+
+  try {
+    process.kill(pid, 'SIGTERM');
+
+    // 等待进程退出
+    let attempts = 0;
+    while (attempts < 10) {
+      try {
+        process.kill(pid, 0);
+        // 进程仍在运行
+        require('child_process').execSync('sleep 0.5');
+        attempts++;
+      } catch (e) {
+        // 进程已退出
+        break;
+      }
+    }
+
+    // 如果进程仍在运行，强制终止
+    try {
+      process.kill(pid, 0);
+      process.kill(pid, 'SIGKILL');
+    } catch (e) {
+      // 进程已退出
+    }
+
+    if (fs.existsSync(PID_FILE)) {
+      fs.unlinkSync(PID_FILE);
+    }
+
+    console.log(colors.green(`${APP_NAME} stopped successfully`));
+  } catch (e) {
+    console.log(colors.red(`Failed to stop ${APP_NAME}: ${e.message}`));
+  }
+}
+
+// 重启服务
+function restart() {
+  console.log(colors.blue(`Restarting ${APP_NAME}...`));
+  stop();
+  setTimeout(() => {
+    start();
+  }, 1000);
+}
+
+// 查看状态
+function status() {
+  const pid = isRunning();
+  if (pid) {
+    console.log(colors.green(`${APP_NAME} is running (PID: ${pid})`));
+
+    // 尝试获取健康状态
+    try {
+      const http = require('http');
+      const req = http.get('http://localhost:9999/api/health', { timeout: 2000 }, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => {
+          try {
+            const health = JSON.parse(data);
+            console.log(colors.cyan(`  Status: ${health.status}`));
+            console.log(colors.cyan(`  Uptime: ${Math.floor(health.uptime / 60)} minutes`));
+            console.log(colors.cyan(`  Active Mappings: ${health.activeMappings}`));
+            console.log(colors.cyan(`  Active Connections: ${health.activeConnections}`));
+          } catch (e) {}
+        });
+      });
+      req.on('error', () => {});
+      req.on('timeout', () => req.destroy());
+    } catch (e) {}
+  } else {
+    console.log(colors.red(`${APP_NAME} is not running`));
+  }
+}
+
+// 查看日志
+function logs(follow = false) {
+  if (!fs.existsSync(LOG_FILE)) {
+    console.log(colors.yellow('No log file found'));
+    return;
+  }
+
+  if (follow) {
+    console.log(colors.blue(`Tailing ${LOG_FILE}... (Ctrl+C to exit)`));
+    const tail = spawn('tail', ['-f', LOG_FILE], { stdio: 'inherit' });
+    process.on('SIGINT', () => {
+      tail.kill();
+      process.exit(0);
+    });
+  } else {
+    const content = fs.readFileSync(LOG_FILE, 'utf8');
+    const lines = content.split('\n').slice(-50);
+    console.log(lines.join('\n'));
+  }
+}
+
+// 设置密码
+function setupPassword() {
+  console.log(colors.blue('Setting up password...'));
+  const child = spawn('node', [SETUP_PASSWORD_FILE], {
+    stdio: 'inherit',
+    cwd: path.dirname(SETUP_PASSWORD_FILE)
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code);
+  });
+}
+
+// 初始化配置
+function init() {
+  const configDir = process.cwd();
+  const configFile = path.join(configDir, 'config.json');
+
+  if (fs.existsSync(configFile)) {
+    console.log(colors.yellow('config.json already exists'));
+    return;
+  }
+
+  const defaultConfig = {
+    mappings: [
+      {
+        name: "Example",
+        listen: { host: "0.0.0.0", port: 8080 },
+        target: { host: "127.0.0.1", port: 3000 }
+      }
+    ],
+    webui: { enabled: true, port: 9999, host: "0.0.0.0" },
+    logging: { enabled: true, level: "info" }
+  };
+
+  fs.writeFileSync(configFile, JSON.stringify(defaultConfig, null, 2));
+  console.log(colors.green('Created config.json'));
+  console.log(colors.cyan('Edit config.json to configure your port mappings'));
+}
+
+// 显示版本
+function version() {
+  const pkg = require(path.join(__dirname, '..', 'package.json'));
+  console.log(`${APP_NAME} v${pkg.version}`);
+}
+
+// 显示帮助
+function help() {
+  console.log(`
+${colors.cyan('TCP Mapping Server')} - TCP端口转发服务器
+
+${colors.yellow('Usage:')}
+  tcpmapping <command>
+
+${colors.yellow('Commands:')}
+  ${colors.green('start')}           Start the server in background
+  ${colors.green('stop')}            Stop the server
+  ${colors.green('restart')}         Restart the server
+  ${colors.green('status')}          Show server status
+  ${colors.green('logs')}            Show recent logs
+  ${colors.green('logs -f')}         Follow logs in real-time
+  ${colors.green('setup-password')}  Set up admin password
+  ${colors.green('init')}            Create default config.json
+  ${colors.green('version')}         Show version
+  ${colors.green('help')}            Show this help message
+
+${colors.yellow('Examples:')}
+  tcpmapping start          # Start server
+  tcpmapping status         # Check if server is running
+  tcpmapping logs -f        # Follow logs
+
+${colors.yellow('WebUI:')}
+  After starting, visit http://localhost:9999
+`);
+}
+
+// 执行命令
+switch (command) {
+  case 'start':
+    start();
+    break;
+  case 'stop':
+    stop();
+    break;
+  case 'restart':
+    restart();
+    break;
+  case 'status':
+    status();
+    break;
+  case 'logs':
+    logs(args[1] === '-f');
+    break;
+  case 'setup-password':
+  case 'passwd':
+    setupPassword();
+    break;
+  case 'init':
+    init();
+    break;
+  case 'version':
+  case '-v':
+  case '--version':
+    version();
+    break;
+  case 'help':
+  case '-h':
+  case '--help':
+  default:
+    help();
+    break;
+}

package/config.json

@@ -0,0 +1,46 @@
+{
+  "mappings": [
+    {
+      "name": "Dify",
+      "listen": {
+        "host": "0.0.0.0",
+        "port": 5588
+      },
+      "target": {
+        "host": "113.45.34.202",
+        "port": 5588
+      }
+    },
+    {
+      "name": "语音助手",
+      "listen": {
+        "host": "0.0.0.0",
+        "port": 3443
+      },
+      "target": {
+        "host": "115.120.49.208",
+        "port": 443
+      }
+    },
+    {
+      "name": "语音助手",
+      "listen": {
+        "host": "0.0.0.0",
+        "port": 443
+      },
+      "target": {
+        "host": "115.120.49.208",
+        "port": 443
+      }
+    }
+  ],
+  "webui": {
+    "enabled": true,
+    "port": 9999,
+    "host": "0.0.0.0"
+  },
+  "logging": {
+    "enabled": true,
+    "level": "info"
+  }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@chenpu17/tcpmapping",
+  "version": "2.0.0",
+  "description": "TCP端口转发服务器，支持多端口映射、WebUI管理界面和实时连接监控",
+  "main": "server.js",
+  "bin": {
+    "tcpmapping": "./bin/tcpmapping.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node server.js",
+    "setup-password": "node setup-password.js",
+    "reset-password": "node setup-password.js"
+  },
+  "files": [
+    "bin/",
+    "public/",
+    "server.js",
+    "setup-password.js",
+    "config.json"
+  ],
+  "keywords": [
+    "tcp",
+    "proxy",
+    "forward",
+    "port-forward",
+    "port-mapping",
+    "server",
+    "webui",
+    "cli",
+    "nodejs"
+  ],
+  "author": "chenpu17",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chenpu17/TcpMapping.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chenpu17/TcpMapping/issues"
+  },
+  "homepage": "https://github.com/chenpu17/TcpMapping#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "express-session": "^1.17.3",
+    "bcryptjs": "^2.4.3",
+    "body-parser": "^1.20.2"
+  }
+}