evg4b/uncors

镜像概述

evg4b/uncors是一个轻量的开发用HTTP/HTTPS代理镜像，核心功能是替换CORS（跨域资源共享）头，解决本地开发时的跨域访问限制问题。该工具适用于开发测试场景，不建议在生产环境使用。

核心功能

• CORS头替换：消除跨域访问障碍
• 通配符主机映射：灵活配置代理目标
• HTTPS支持：自动生成证书，支持加密代理
• 响应模拟：快速模拟API返回结果
• Lua脚本处理：通过脚本自定义请求/响应逻辑
• 静态文件服务：本地静态资源托管
• 响应缓存：提升重复请求效率
• 请求重写：修改请求参数或路径
• HAR流量记录：保存请求响应数据用于分析

使用场景

• 前端开发：本地项目访问远程API时解决跨域问题
• 测试验证：模拟不同API响应，快速验证前端逻辑
• 本地调试：结合静态文件服务与API代理，简化开发流程

配置说明

通过命令行参数配置代理规则及功能开关，以下是Docker部署示例：

Docker运行示例

基础代理映射

将本地http://local.github.com代理到https://github.com：

bash
docker run -p 80:3000 evg4b/uncors --from 'http://local.github.com' --to 'https://github.com'

本地端口代理到远程API

将本地8080端口请求代理到远程API：

bash
docker run -p 8080:3000 evg4b/uncors --from 'http://localhost:8080' --to 'https://api.example.com'

[!Caution] 修改CORS头可能引入安全风险，该工具仅用于开发测试场景，未经过生产级安全审查，请勿在生产环境或公开网络中使用。