CORS Anywhere 技术文档

CORS Anywhere 技术文档

【免费下载链接】cors-anywhere CORS Anywhere is a NodeJS reverse proxy which adds CORS headers to the proxied request. 项目地址: https://gitcode.com/gh_mirrors/co/cors-anywhere

CORS Anywhere 是一款基于 Node.js 的代理服务器工具，它为被代理的请求添加 CORS（跨源资源共享）头信息，使得前端应用可以绕过同源策略限制，访问不同域名下的资源。本文档旨在指导您如何安装、配置以及使用 CORS Anywhere。

安装指南

确保您的系统已经安装了 Node.js 和 npm。之后，可以通过以下命令安装 CORS Anywhere：

npm install cors-anywhere

对于生产环境，建议从源码构建：

git clone https://github.com/Rob--W/cors-anywhere.git
cd cors-anywhere
npm install

项目使用说明

运行本地服务

在安装完 CORS Anywhere 后，您可以启动一个本地服务，例如：

var host = process.env.HOST || '0.0.0.0';
var port = process.env.PORT || 8080;

const cors_proxy = require('cors-anywhere');
cors_proxy.createServer({
    originWhitelist: [],
    requireHeader: ['origin', 'x-requested-with'],
    removeHeaders: ['cookie', 'cookie2']
}).listen(port, host, () => {
    console.log(`CORS Anywhere运行于 ${host}:${port}`);
});

通过这个服务，您可以将请求发送到任何网站，并自动添加 CORS 头信息。如访问 http://localhost:8080/http://example.com 将会成功获取数据并携带 CORS 头。

使用示例

客户端使用非常简单，只需在目标 URL 前加上 CORS Anywhere 的地址。例如，如果你想从 JavaScript 脚本中请求一个跨域资源，可以直接这样做：

fetch('http://localhost:8080/https://api.example.com/data')
.then(response => response.json())
.then(data => console.log(data));

或者，如果你使用的是 jQuery，则可以通过设置 AJAX 预处理器来自动化这个过程：

$.ajaxPrefilter(function(options) {
    if (options.crossDomain && $.support.cors) {
        options.url = 'http://localhost:8080/' + options.url;
    }
});

项目API使用文档

CORS Anywhere 提供了一个简单的API接口，核心是通过在其URL前添加您的请求地址来实现跨域请求。例如：

• http://localhost:8080/http://example.com/path 访问 example.com 的资源。
• 对于HTTPS资源，指定端口443可自动转换为HTTPS请求，如 http://localhost:8080/example.com:443/path。

服务器配置选项

当部署自己的实例时，您可以自定义一系列配置项，如黑白名单、需要的请求头等，详情见上文描述。

安装方式总结

• 开发环境安装: npm install cors-anywhere
• 从源码部署: 克隆仓库，然后 npm install，最后根据需求配置后启动服务。

通过遵循以上步骤，您可以轻松集成 CORS Anywhere 到您的项目中，解决跨域访问的问题。记住，虽然有公共演示服务可用，但为了稳定性和安全性考虑，重要的是在生产环境中部署自己管理的实例。

【免费下载链接】cors-anywhere CORS Anywhere is a NodeJS reverse proxy which adds CORS headers to the proxied request. 项目地址: https://gitcode.com/gh_mirrors/co/cors-anywhere