代理服务器（Proxy Server）产品系统Vibe Coding

随着微服务、前后端分离与本地多仓库并行开发成为常态，研发团队往往同时运行多个前端、后端与静态资源服务，端口分散、跨域与路径不一致问题日益突出。统一入口式的轻量代理层，能把分散端口收敛为可配置的路径映射，显著降低联调与演示成本，是研发效能工具链中的基础组件。

在云原生与边缘部署场景下，反向代理、路径重写、WebSocket 透传与访问管控能力持续被需要：既服务于本地开发，也可作为演示环境、内网展厅或产品能力注册体系的流量入口。相比 Nginx 等重型方案，面向研发自助配置、热更新、可 API 管理的轻量代理更易嵌入团队工作流。

行业侧，低代码交付、产品能力注册、应用部署管理等平台化能力兴起，要求代理层能对接产品详情、访客准入与运维脚本，形成「配置—转发—可观测—可审计」闭环。开源生态中 Express、http-proxy 与 SQLite 等成熟组件降低了实现门槛，使个人与中小团队也能快速交付可用的代理服务。

展望未来，代理服务将更多与身份门禁、流量审计、产品文档联动及一键演示环境结合，从「纯转发」演进为研发与演示一体化的入口网关，市场需求稳定且持续细分。

本项目提供统一入口的网络代理能力，将不同路径映射到本地或远程 HTTP 服务、静态目录或重定向目标，避免开发者记忆多端口。核心能力包括：HTTP/HTTPS 代理转发、WebSocket 代理、静态文件服务、响应路径重写、HTTP 重定向，以及配置启用/禁用与自动尾部斜杠等细节策略。

配置通过 RESTful API 与 SQLite 持久化管理，变更后热加载生效，无需重启进程；支持标签分类、分页与搜索，便于多项目配置治理。系统提供 Swagger 文档、健康检查、CORS 与 Winston 日志，便于对接与运维。

面向使用侧，首页按类型 Tab 展示代理列表（默认聚焦 HTTP 代理），支持打开代理链接与查看产品详情；可对接产品能力注册服务，按 Source Path 解析产品 ID 并拼装最新版本详情页 URL。开启访客门禁后，需邀请码注册获取凭证方可访问代理路径，并记录访客访问日志，适合演示环境受控开放。整体定位为本地开发与演示环境的统一流量入口。

我负责本项目从需求拆解到设计、实现、自测与文档交付的全流程，包括：Express 服务骨架与中间件编排；基于 SQLite 的代理配置、标签与访客相关表结构设计；HTTP/WebSocket 代理与静态、重定向、路径重写等转发策略；配置热加载；访客注册/凭证校验中间件；首页与产品详情 URL API；演示环境 Makefile/.env 与 API 用户指南、迭代设计与测试场景文档。

技术栈以 TypeScript + Node.js + Express 为主，数据层使用 SQLite，代理层采用 http-proxy / http-proxy-middleware，日志采用 Winston，接口文档由 swagger-jsdoc + swagger-ui-express 生成。架构上分层为 API 路由、代理中间件层、配置/访客服务与数据库，请求先经访客门禁（可开关）再进入动态代理匹配。

实现难点与亮点：一是多类型配置（HTTP、静态、重定向）统一模型下的优先级与路径匹配，避免 `/api` 等前缀误伤管理接口；二是路径重写需防循环并正确改写响应体；三是 WebSocket 升级与 HTTP 共用入口时的 upgrade 处理；四是配置变更热加载保证不停机生效；五是访客凭证 Cookie 与鉴权边界、产品详情与外部注册服务的稳健降级提示。这些设计使系统在轻量部署下仍具备可配置、可审计与可演示的完整能力。