@chenpu17/tcpmapping 2.1.0 → 2.4.0

package/docs//345/212/237/350/203/275/346/200/273/347/273/223.md

@@ -0,0 +1,200 @@
+# TCP转发服务器 - 功能总结
+
+## ✅ 已实现的所有功能
+
+### 🎯 核心需求（完全满足）
+
+1. **✅ TCP协议端口转发**
+   - 支持TCP请求转发到后端HTTP服务器
+   - 高性能的连接处理和数据转发
+
+2. **✅ 多端口映射配置**
+   - 支持同时配置多个端口映射规则
+   - 例如：80->ip1:3000, 81->ip2:3001
+   - 每个映射独立运行，互不影响
+
+3. **✅ 配置文件管理**
+   - 通过config.json文件进行配置
+   - 支持动态加载和保存配置
+
+4. **✅ Node.js开发**
+   - 完全基于Node.js原生模块开发
+   - 无外部系统依赖
+
+### 🚀 增强功能（超出需求）
+
+#### WebUI管理界面
+- **✅ 用户认证系统**
+  - 安全的登录/登出功能
+  - 密码加密存储（bcrypt）
+  - 登录失败次数限制（5次后锁定30分钟）
+  - IP地址跟踪和审计日志
+
+- **✅ 可视化管理面板**
+  - 现代化的Web界面设计
+  - 中英文界面切换，语言偏好本地保存
+  - 深色 / 浅色主题，自动跟随系统并记住选择
+  - 响应式布局，支持移动设备
+  - 实时状态展示
+
+- **✅ 动态配置管理**
+  - 无需重启即可添加/删除端口映射
+  - 实时配置保存和加载
+  - 输入验证和错误处理
+
+#### 连接状态监控
+- **✅ 实时连接监控**
+  - 显示每个端口的连接数量
+  - 显示客户端源地址、实际监听地址和目标地址
+  - 显示数据传输量（上行/下行）
+  - 显示连接持续时长与状态
+  - 保留最近 500 条已关闭连接记录，可按映射筛选
+  - 关闭日志包含持续时长、流量与关闭原因
+
+- **✅ 系统状态展示**
+  - 总映射数量
+  - 活跃映射数量
+  - 总连接数
+  - 系统运行时间
+  - 内存使用情况
+
+#### 安全机制
+- **✅ 密码安全策略**
+  - 密码复杂度要求（8字符+大小写+数字）
+  - 密码过期机制（90天）
+  - 安全的密码哈希存储
+
+- **✅ 访问控制**
+  - 会话管理（24小时超时）
+  - 登录尝试限制
+  - 用户账户启用/禁用
+
+- **✅ 审计日志**
+  - 登录成功/失败记录
+  - 操作日志记录
+  - IP地址跟踪
+
+#### 运维功能
+- **✅ 日志级别控制**
+  - 支持error、warn、info、debug级别
+  - 日志级别过滤功能
+  - 时间戳和结构化日志
+
+- **✅ 优雅关闭**
+  - 支持Ctrl+C安全退出
+  - 自动清理连接资源
+  - 多服务器实例管理
+
+## 📁 项目结构
+
+```
+gw/
+├── server.js              # 主服务器（TCP转发 + WebUI + API）
+├── bin/tcpmapping.js      # CLI 工具（start/stop/status/logs）
+├── config.json            # 端口映射配置（示例）
+├── auth-config.json       # 认证配置（敏感，已git忽略）
+├── setup-password.js      # 密码设置工具
+├── deploy.sh              # 自动部署脚本
+├── package.json           # 项目配置和依赖
+├── README.md              # 使用说明
+├── CHANGELOG.md           # 更新日志
+├── docs/                  # 文档目录
+│   ├── API.md             # API 文档
+│   ├── 安全配置说明.md    # 安全配置指南
+│   └── 功能总结.md        # 本文件
+├── test/smoke.js          # 冒烟测试
+├── public/                # Web静态文件
+│   ├── login.html         # 登录页面
+│   ├── dashboard.html     # 管理面板
+│   └── common.js          # 多语言与主题（中英文 / 深色模式）
+└── node_modules/          # 依赖包
+```
+
+## 🛠 技术栈
+
+### 后端技术
+- **Node.js** - 运行时环境
+- **原生 net 模块** - TCP 转发与背压控制
+- **Express.js** - Web框架
+- **bcryptjs** - 密码加密
+- **express-session** - 会话管理
+
+### 前端技术
+- **原生HTML/CSS/JavaScript** - 无框架依赖
+- **现代CSS** - Flexbox/Grid布局
+- **Fetch API** - 异步请求
+- **响应式设计** - 支持多设备
+
+### 安全技术
+- **bcrypt密码哈希** - 可配置加密强度
+- **会话加固** - 登录后重建 Session ID、HttpOnly + SameSite Cookie
+- **CSRF防护** - 校验写请求的 Origin 来源
+- **输入验证** - 端口、主机名、映射名称校验
+- **XSS防护** - 前端统一转义动态内容
+- **安全响应头** - CSP、X-Frame-Options、nosniff
+
+## 🚀 部署方式
+
+### 快速部署
+```bash
+# 自动部署（推荐）
+./deploy.sh
+
+# 手动部署
+npm install
+npm run setup-password
+npm start
+```
+
+### 生产环境
+```bash
+# 设置环境变量
+export NODE_ENV=production
+export SESSION_SECRET=$(openssl rand -base64 32)
+
+# 设置文件权限
+chmod 600 auth-config.json
+
+# 启动服务
+npm start
+```
+
+## 🔒 安全特性总结
+
+1. **密码安全**：强制密码策略+加密存储
+2. **访问控制**：登录认证+会话管理
+3. **攻击防护**：登录限制+IP跟踪+审计日志
+4. **数据保护**：敏感文件保护+.gitignore配置
+5. **运行安全**：优雅关闭+错误处理+资源清理
+
+## 📊 性能特点
+
+- **高并发**：支持大量同时连接
+- **低延迟**：TCP_NODELAY + 直接转发，无额外处理
+- **背压控制**：慢速对端不会导致内存无限增长
+- **半关闭支持**：兼容使用 TCP half-close 的协议
+- **资源优化**：连接关闭、映射停止和进程退出时自动清理
+- **稳定性**：错误隔离，单个映射故障不影响其他服务
+
+## 🎉 项目亮点
+
+1. **完全满足原始需求** - 所有基础功能100%实现
+2. **大幅超出预期** - 增加了完整的Web管理系统
+3. **安全默认** - 无默认密码、默认仅本机监听、会话加固
+4. **用户体验优秀** - 现代化Web界面、自动刷新、映射在线编辑
+5. **部署简单** - 一键部署脚本、CLI工具和详细文档
+6. **质量保障** - 冒烟测试覆盖登录、CRUD、转发与统计
+
+## 🔮 未来扩展可能
+
+- [ ] HTTPS/TLS加密支持
+- [ ] 负载均衡功能
+- [ ] 性能监控图表
+- [ ] 配置备份恢复
+- [ ] 多用户权限管理
+- [ ] Docker容器化
+- [ ] 集群部署支持
+
+---
+
+**总结：这是一个功能完整、安全可靠、易于使用的企业级TCP转发服务器解决方案。**

package/docs//345/256/211/345/205/250/351/205/215/347/275/256/350/257/264/346/230/216.md

@@ -0,0 +1,154 @@
+# TCP转发服务器 - 安全配置说明
+
+## 🔐 密码安全配置
+
+### 1. 初始密码设置
+
+**⚠️ 重要：首次使用前必须设置安全密码**
+
+```bash
+# 运行密码设置工具
+npm run setup-password
+
+# 或直接运行
+node setup-password.js
+```
+
+### 2. 密码策略要求
+
+默认策略如下（可在 `~/.tcpmapping/auth-config.json` 的 `passwordPolicy` 中调整）：
+
+- ✅ 最少8个字符
+- ✅ 包含大写字母 (A-Z)
+- ✅ 包含小写字母 (a-z)
+- ✅ 包含数字 (0-9)
+- ✅ 密码有效期90天
+
+> ⚠️ 系统没有默认密码。未运行 `setup-password` 时，WebUI 管理界面不会启动。
+
+### 3. 安全功能
+
+#### 登录保护
+- 🔒 **失败次数限制**：5次失败后账户锁定30分钟
+- 📍 **IP地址跟踪**：记录登录尝试的IP地址
+- 📝 **审计日志**：记录所有登录活动
+
+#### 会话管理
+- ⏰ **会话超时**：默认24小时后自动退出（可通过 `sessionConfig.sessionTimeout` 调整）
+- 🔄 **会话重建**：登录成功后重新生成 Session ID，防止会话固定攻击
+- 🍪 **Cookie 加固**：`HttpOnly` + `SameSite=Lax`
+- 🔄 **密码过期**：90天后强制修改密码
+- 🚫 **账户禁用**：支持禁用特定用户
+
+### 4. 环境变量配置 (可选)
+
+```bash
+# 覆盖数据目录（默认 ~/.tcpmapping）
+export TCPMAPPING_DATA_DIR=/var/lib/tcpmapping
+
+# 覆盖 WebUI 监听地址和端口
+export WEBUI_HOST=127.0.0.1
+export WEBUI_PORT=9999
+
+# 覆盖会话签名密钥（建议使用足够长的随机字符串）
+export SESSION_SECRET="$(openssl rand -hex 32)"
+```
+
+### 5. 生产环境部署建议
+
+#### 基本安全措施
+1. **使用HTTPS**：在生产环境中始终使用SSL/TLS
+2. **防火墙配置**：限制Web管理端口的访问
+3. **定期更新密码**：建议每30-60天更新一次
+4. **备份配置**：定期备份`auth-config.json`文件
+
+#### 高级安全配置
+```bash
+# 生产环境下限制管理面板只允许本机访问
+# config.json: "webui": { "host": "127.0.0.1", "port": 9999 }
+
+# 通过反向代理提供 HTTPS，并限制来源 IP
+# 同时建议设置 NODE_ENV=production
+export NODE_ENV=production
+```
+
+### 6. 文件权限设置
+
+```bash
+# 设置认证配置文件的安全权限（CLI 设置密码时会自动设置为 600）
+chmod 600 ~/.tcpmapping/auth-config.json
+chmod 600 ~/.tcpmapping/.session-secret
+```
+
+### 7. 密码重置
+
+如果忘记密码，可以重新运行设置工具：
+
+```bash
+npm run reset-password
+```
+
+### 8. 安全检查清单
+
+部署前请确认：
+
+- [ ] 已运行`npm run setup-password`设置强密码（系统无默认密码）
+- [ ] `auth-config.json`文件不在版本控制中
+- [ ] `webui.host`未暴露到公网，或已通过防火墙限制来源
+- [ ] 生产环境使用HTTPS
+- [ ] 防火墙已正确配置
+- [ ] 定期备份配置文件
+- [ ] 监控登录日志
+
+### 9. 故障排除
+
+#### 常见问题
+
+**Q: 忘记密码怎么办？**
+A: 运行`npm run reset-password`重新设置密码
+
+**Q: 账户被锁定怎么办？**
+A: 等待30分钟后重试，或重启服务器清除锁定状态
+
+**Q: 密码过期提示怎么办？**
+A: 运行`npm run setup-password`更新密码
+
+#### 紧急访问
+
+系统没有后门密码，也无法通过删除配置文件获得默认密码。如果无法登录：
+
+1. 在服务器上运行 `tcpmapping setup-password` 重置管理员密码
+2. 如因多次失败被锁定，重启服务（`tcpmapping restart`）会清除锁定状态
+3. 重置后立即使用新密码登录
+
+### 10. 日志监控
+
+系统会记录以下安全事件：
+
+- 登录成功/失败
+- 账户锁定
+- 密码修改
+- 转发服务器启停与连接错误
+
+查看日志：
+```bash
+# 查看最近的安全事件
+tcpmapping logs
+
+# 实时跟踪
+tcpmapping logs -f
+
+# 日志文件位置（默认）
+# ~/.tcpmapping/tcpmapping.log
+```
+
+---
+
+## 📞 技术支持
+
+如有安全相关问题，请：
+1. 查看系统日志
+2. 检查配置文件
+3. 参考本文档的故障排除部分
+
+**记住：安全是一个持续的过程，定期检查和更新配置是必要的。** 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenpu17/tcpmapping",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "description": "TCP端口转发服务器，支持多端口映射、WebUI管理界面和实时连接监控",
   "main": "server.js",
   "bin": {
@@ -9,14 +9,17 @@
   "scripts": {
     "start": "node server.js",
     "dev": "node server.js",
+    "test": "node test/smoke.js",
     "setup-password": "node setup-password.js",
     "reset-password": "node setup-password.js"
   },
   "files": [
     "bin/",
     "public/",
+    "docs/",
     "server.js",
-    "setup-password.js"
+    "setup-password.js",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "tcp",
@@ -45,7 +48,6 @@
   "dependencies": {
     "express": "^4.18.2",
     "express-session": "^1.17.3",
-    "bcryptjs": "^2.4.3",
-    "body-parser": "^1.20.2"
+    "bcryptjs": "^2.4.3"
   }
 }