Before-server@2 - TCP代理调试工具

一个基于Next.js的现代化TCP代理(支持HTTP/FTP/DNS/SMTP/WebSocket/SSE)调试工具，提供请求拦截、日志记录和实时监控功能，助力开发调试效率提升。

2.0版本全面拥抱Ai编码。

1.0版本看这里：https://github.com/zy445566/before-server/blob/v1.0/README.md

✨ 核心功能

• 多代理管理 - 同时运行多个代理服务
• 实时日志 - 即时查看请求/响应数据
• 高级过滤 - 按时间/状态码/方法筛选
• Docker支持 - 一键容器化部署

🚀 快速开始

开发模式

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 访问 http://localhost:3000

生产环境

npm run build && npm start

🐳 Docker部署

# 构建镜像
docker build -t before-server .

# 运行容器 (映射管理界面+代理端口范围)
docker run -d \
  -p 3000:3000 \
  -p 30000-30100:30000-30100 \
  -v $(pwd)/proxies.config.json:/app/proxies.config.json:ro \
  -e PROXY_CONFIG_PATH=proxies.config.json \
  --name before-server \
  before-server

🏗️ 项目结构

.
├── lib/              # 核心代理逻辑
│   └── proxyManager.ts  # 代理管理器
├── pages/            # Next.js页面
│   ├── api/          # API路由
│   └── logs/         # 日志查看
├── components/       # UI组件
│   ├── ProxyForm.tsx # 代理配置表单
│   └── LogViewer.tsx # 日志查看器
└── public/           # 静态资源

💻 开发指南

技术栈

• 前端: Next.js 14 + TypeScript
• 后端: Node.js原生HTTP模块
• 工具链:
  • Docker容器化
  • ESLint + Prettier代码规范
  • Jest单元测试

贡献流程

1. Fork项目
2. 创建特性分支 (git checkout -b feature/xxx)
3. 提交变更 (git commit -am 'Add some feature')
4. 推送分支 (git push origin feature/xxx)
5. 创建Pull Request

⚙️ 启动时根据配置文件创建代理

应用启动时会尝试读取配置文件并自动创建代理，默认路径为项目根目录 proxies.config.json。也可通过环境变量 PROXY_CONFIG_PATH 指定其他路径。

1. 参考配置：

{
  "proxies": [
    { "targetUrl": "http://example.com:80", "port": 10000 },
    { "targetUrl": "https://api.example.com", "port": 10001 }
  ]
}

说明：

• targetUrl 必填，示例：http://host:80 或 https://host（未指定端口时，https 默认 443，http 默认 80）。
• port 可选；不填则随机分配空闲端口。
• 若某条配置解析失败，会记录错误但不会影响其他条目及整体启动。

在 Docker 中使用配置文件示例：

docker run -d \
  -p 3000:3000 \
  -p 30000-30100:30000-30100 \
  -v $(pwd)/proxies.config.json:/app/proxies.config.json:ro \
  -e PROXY_CONFIG_PATH=proxies.config.json \
  --name before-server \
  before-server

提示：

• 首次访问页面时，前端会调用 /api/proxies/list，从而触发服务端模块加载并初始化配置中的代理。
• 可通过 API 继续创建/关闭代理；配置仅在启动阶段读取一次。

📜 许可证

MIT License © 2025 zy445566