tlan16/cors-anywhere

docker-cors-anywhere 镜像文档

镜像概述

docker-cors-anywhere 是一个轻量级的跨域资源共享(CORS)代理服务镜像，旨在解决前端应用或无服务器架构开发中常见的CORS限制问题。该镜像基于Node.js运行时，集成了成熟的 cors-anywhere npm包（与官方服务 https://cors-anywhere.herokuapp.com/ 使用相同核心组件），可快速搭建本地CORS代理服务，实现跨域请求转发。

核心功能与特性

• CORS问题解决方案：通过代理转发跨域请求，自动添加必要的CORS响应头（如 Access-Control-Allow-Origin、Access-Control-Allow-Methods 等），绕过浏览器的同源策略限制。
• 兼容性强：基于 cors-anywhere 开源组件，支持主流浏览器的CORS规范，与官方Heroku服务功能一致。
• 轻量高效：Node.js基础镜像确保资源占用低，启动速度快，适合本地开发和测试环境。
• 配置灵活：支持通过环境变量自定义端口、访问白名单等核心参数（基于 cors-anywhere 原生配置能力）。

使用场景

• 前端开发调试：在本地开发前端应用时，需请求第三方API（如公共服务、后端测试接口）但存在CORS限制的场景。
• 无服务器应用：Serverless架构中，前端直接调用跨域服务时的跨域问题解决。
• 快速验证场景：无需修改目标服务器配置，临时绕过CORS限制验证API功能。

使用方法与配置说明

基本启动命令

通过Docker CLI直接启动容器，默认监听8080端口：

bash
docker run -d -p 8080:8080 --name cors-proxy docker.xuanyuan.run/docker-cors-anywhere

• -d：后台运行容器
• -p 8080:8080：端口映射（主机端口:容器端口）
• --name cors-proxy：自定义容器名称（可选）

代理服务使用方式

启动服务后，通过以下方式使用代理转发跨域请求：

1. 原始跨域请求URL：https://api.example.com/data
2. 通过代理的请求URL：http://localhost:8080/https://api.example.com/data
   （格式：http://[代理服务地址]/[目标请求完整URL]）

浏览器/应用直接请求代理URL，即可获取带CORS头的响应。

自定义配置（环境变量）

基于 cors-anywhere 原生支持，可通过环境变量调整服务行为：

示例：限制仅本地3000端口应用访问

bash
docker run -d \
  -p 3001:3001 \
  -e CORSANYWHERE_PORT=3001 \
  -e CORSANYWHERE_WHITELIST="http://localhost:3000" \
  --name cors-proxy-restricted \
  docker.xuanyuan.run/docker-cors-anywhere

Docker Compose 配置示例

创建 docker-compose.yml 文件快速部署：

yaml
version: '3'
services:
  cors-proxy:
    image: docker.xuanyuan.run/docker-cors-anywhere
    ports:
      - "8080:8080"  # 主机端口:容器端口
    environment:
      - CORSANYWHERE_WHITELIST="http://localhost:3000,http://127.0.0.1:5173"  # 允许Vite/React等开发服务器
    restart: unless-stopped  # 异常退出后自动重启

启动命令：

bash
docker-compose up -d

注意事项

• 该镜像主要用于开发/测试环境，生产环境使用需谨慎（建议配合访问控制策略限制使用范围）。
• 完整配置参数可参考 cors-anywhere 官方文档：https://github.com/Rob--W/cors-anywhere