深入淺出講解10種跨域解決方案【實踐】

作者：藍色的秋風

轉發鏈接：https://juejin.im/post/5e948bbbf265da47f2561705

前言

嗯。又來了，又說到跨域了，這是一個老生常談的話題，以前我覺得這種基礎文章沒有什麼好寫的，會想著你去了解底層啊，不是很簡單嗎。但是最近在開發一個 「vscode 插件」 發現，當你剛入門一樣東西的時候，你不會想這麼多，因為你對他不熟悉，當你遇到不會的東西，你就是想先找到解決方案，然後通過這個解決方案再去深入理解。就比如跨域，新人或者剛接觸的人對它並不是那麼熟悉，所以說列出一些自己積累的方案，以及一些常用的場景來給他人帶來一些解決問題的思路，這件事是有意義的。（寫完之後還發現真香。以後忘了還能回來看看）

前面小夥們是否還記得小編其實也整理了幾篇關於跨域的文章，咱們一起來回顧回顧：

《手把手教你徹底解決跨域問題：遇到Cookie與SameSite【實踐】》

《

手把手教你全套實踐解決前後端的跨域問題》

《跨域總結:從CORS到Ngnix》

其實現在的環境對於剛入門的前端來說，非常的不友好，一方面吧，很多剛新人沒有經歷過工具的變更時代，另一方面框架的迭代更新速度很快。在以前你可能掌握幾種常見的手法就好了。但是現在 webpack-dev-server、vue-cli、parcel，這些腳手架都進行了一層封裝，對於熟悉的人可能很簡單，但是對於還未入門的人來說，簡直就是一個黑盒，雖然用起來很方便，但是某一天遇到了問題，你對它不熟悉，你就會不知道所錯。（但是別慌，主流 cli 的跨域方式我都會講到）

講著講著有點偏離方向，可能我講的也並不一定是正確的。下面切入正題。

本文會以 「「What-How-Why」」 的方式來進行講解。而在在 How （如何解決跨域，將會提供標題的 11 種方案。）

「重要的說明: 在文中，web 端地址為 localhost:8000 服務端地址為 localhost:8080,這一點希望你能記住，會貫穿全文，你也可以把此處的兩端的地址代入你自己的地址。」

cors

以下所有代碼均在：https://github.com/hua1995116/node-demo/tree/master/node-cors

image-20200413192431636

一、跨域是什麼？

1.同源策略

跨域問題其實就是瀏覽器的同源策略所導致的。

❝

「同源策略」是一個重要的安全策略，它用於限制一個origin的文檔或者它加載的腳本如何能與另一個源的資源進行交互。它能幫助阻隔惡意文檔，減少可能被攻擊的媒介。

--來源 MDN

❞

當跨域時會收到以下錯誤

image-20200413205559124

2.同源示例

那麼如何才算是同源呢？先來看看 url 的組成部分

http://www.example.com:80/path/to/myfile.html?key1=value1&key2=value2#SomewhereInTheDocument

image-20200412171942421

只有當

「protocol（協議）、domain（域名）、port（端口）三者一致。」

「protocol（協議）、domain（域名）、port（端口）三者一致。」

「protocol（協議）、domain（域名）、port（端口）三者一致。」

才是同源。

以下協議、域名、端口一致。

http://www.example.com:80/a.js

http://www.example.com:80/b.js

以下這種看上去再相似也沒有用，都不是同源。

http://www.example.com:8080

http://www2.example.com:80

在這裡注意一下啊，這裡是為了突出端口的區別才寫上端口。在默認情況下 http 可以省略端口 80， https 省略 443。這別到時候鬧笑話了，你和我說 http://www.example.com:80 和 http://www.example.com 不是同源，他倆是一個東西。

http://www.example.com:80 === http://www.example.com

https://www.example.com:443 === https://www.example.com

唔，還是要說明一下。

二、如何解決跨域？

1.CORS

跨域資源共享(CORS) 是一種機制，它使用額外的 HTTP 頭來告訴瀏覽器 讓運行在一個 origin (domain) 上的 Web 應用被准許訪問來自不同源服務器上的指定的資源。當一個資源從與該資源本身所在的服務器

「不同的域、協議或端口」請求一個資源時，資源會發起一個「跨域 HTTP 請求」。

而在 cors 中會有 簡單請求 和 複雜請求的概念。

「瀏覽器支持情況」

當你使用 IE<=9, Opera<12, or Firefox<3.5 或者更加老的瀏覽器，這個時候請使用 JSONP 。

a.簡單請求

不會觸發 CORS 預檢請求。這樣的請求為“簡單請求”，請注意，該術語並不屬於 Fetch （其中定義了 CORS）規範。若請求滿足所有下述條件，則該請求可視為“簡單請求”：

情況一: 使用以下方法(意思就是以下請求以外的都是非簡單請求)

• GET
• HEAD
• POST

情況二: 人為設置以下集合外的請求頭

• Accept
• Accept-Language
• Content-Language
• Content-Type （需要注意額外的限制）
• DPR
• Downlink
• Save-Data
• Viewport-Width
• Width

情況三：Content-Type的值僅限於下列三者之一：(例如 application/json 為非簡單請求)

• text/plain
• multipart/form-data
• application/x-www-form-urlencoded

情況四:

請求中的任意XMLHttpRequestUpload 對象均沒有註冊任何事件監聽器；XMLHttpRequestUpload 對象可以使用 XMLHttpRequest.upload 屬性訪問。

情況五:

請求中沒有使用 ReadableStream 對象。

b.非簡單請求

除以上情況外的。

c.Node 中的解決方案

原生方式

我們來看下後端部分的解決方案。Node 中 CORS 的解決代碼.

<code>app.use(async (ctx, next) => {
  ctx.set("Access-Control-Allow-Origin", ctx.headers.origin);
  ctx.set("Access-Control-Allow-Credentials", true);
  ctx.set("Access-Control-Request-Method", "PUT,POST,GET,DELETE,OPTIONS");
  ctx.set(
    "Access-Control-Allow-Headers",
    "Origin, X-Requested-With, Content-Type, Accept, cc"
  );
  if (ctx.method === "OPTIONS") {
    ctx.status = 204;
    return;
  }
  await next();
});
複製代碼/<code>

第三方中間件

為了方便也可以直接使用中間件

<code>const cors = require("koa-cors");

app.use(cors());
複製代碼/<code>

關於 cors 的 cookie 問題

想要傳遞 cookie 需要滿足 3 個條件

1.web 請求設置withCredentials

這裡默認情況下在跨域請求，瀏覽器是不帶 cookie 的。但是我們可以通過設置 withCredentials 來進行傳遞 cookie.

<code>// 原生 xml 的設置方式
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
// axios 設置方式
axios.defaults.withCredentials = true;
複製代碼/<code>

2.Access-Control-Allow-Credentials 為 true

3.Access-Control-Allow-Origin為非 *

這裡請求的方式，在 chrome 中是能看到返回值的，但是隻要不滿足以上其一，瀏覽器會報錯，獲取不到返回值。

image-20200412201424024

<code>Access to XMLHttpRequest at 'http://127.0.0.1:8080/api/corslist' from origin 'http://127.0.0.1:8000' has been blocked by CORS policy: The value of the 'Access-Control-Allow-Credentials' header in the response is '' which must be 'true' when the request's credentials mode is 'include'. The credentials mode of requests initiated by the XMLHttpRequest is controlled by the withCredentials attribute.
複製代碼/<code>

image-20200412201411481

<code>Access to XMLHttpRequest at 'http://127.0.0.1:8080/api/corslist' from origin 'http://127.0.0.1:8000' has been blocked by CORS policy: The value of the 'Access-Control-Allow-Origin' header in the response must not be the wildcard '*' when the request's credentials mode is 'include'. The credentials mode of requests initiated by the XMLHttpRequest is controlled by the withCredentials attribute.
複製代碼/<code>

image-20200412201530087

d.前端示例

分別演示一下前端部分 簡單請求 和 非簡單請求

簡單請求

<code> 
 
複製代碼/<code>

非簡單請求

這裡我們加入了一個非集合內的 header 頭 cc 來達到非簡單請求的目的。

<code> 
 
複製代碼/<code>

image-20200412201158778

image-20200412195829232

小結

1、 在新版的 chrome 中，如果你發送了複雜請求，你卻看不到 options 請求。可以在這裡設置 chrome://flags/#out-of-blink-cors 設置成 disbale ，重啟瀏覽器。對於非簡單請求就能看到 options 請求了。

2、 一般情況下後端接口是不會開啟這個跨域頭的，除非是一些與用戶無關的不太重要的接口。

2.Node 正向代理

代理的思路為，利用服務端請求不會跨域的特性，讓接口和當前站點同域。

「代理前」

image-20200412202320482

「代理後」

image-20200412202358759

這樣，所有的資源以及請求都在一個域名下了。

a.cli 工具中的代理

1) Webpack (4.x)

在webpack中可以配置proxy來快速獲得接口代理的能力。

<code>const path = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports = {
  entry: {
    index: "./index.js"
  },
  output: {
    filename: "bundle.js",
    path: path.resolve(__dirname, "dist")
  },
  devServer: {
    port: 8000,
    proxy: {
      "/api": {
        target: "http://localhost:8080"
      }
    }
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: "index.html",
      template: "webpack.html"
    })
  ]
};
複製代碼/<code>

修改前端接口請求方式，改為不帶域名。（因為現在是同域請求了）

<code>

 
 
複製代碼/<code>

2) Vue-cli 2.x

<code>// config/index.js

...
proxyTable: {
  '/api': {
     target: 'http://localhost:8080',
  }
},
...
複製代碼/<code>

3) Vue-cli 3.x

<code>// vue.config.js 如果沒有就新建
複製代碼/<code>

<code>module.exports = {
  devServer: {
    port: 8000,
    proxy: {
      "/api": {
        target: "http://localhost:8080"
      }
    }
  }
};
複製代碼/<code>

4) Parcel (2.x)

<code>// .proxyrc
{
  "/api": {
    "target": "http://localhost:8080"
  }
}
複製代碼/<code>

看到這裡，心裡一句 xxx 就會脫口而出，一會寫配置文件，一會 proxyTable ，一會 proxy，怎麼這麼多的形式？學不動了學不動了。。。不過也不用慌，還是有方法的。以上所有配置都是有著共同的底層包 http-proxy-middleware .裡面需要用到的各種 websocket ，rewrite 等功能，直接看這個庫的配置就可以了。關於 http-proxy-middleware 這個庫的原理可以看我這篇文章 github.com/hua1995116/… 當然了。。。對於配置的位置入口還是非統一的。教一個搜索的技巧吧，上面配置寫哪裡都不用記的，想要哪個框架的 直接 google 搜索 xxx proxy 就行了。

例如 vue-cli 2 proxy 、 webpack proxy 等等....基本會搜到有官網的配置答案，通用且 nice。

b.使用自己的代理工具

cors-anywhere

「服務端」

<code>// Listen on a specific host via the HOST environment variable
var host = process.env.HOST || "0.0.0.0";
// Listen on a specific port via the PORT environment variable
var port = process.env.PORT || 7777;

var cors_proxy = require("cors-anywhere");
cors_proxy
  .createServer({
    originWhitelist: [], // Allow all origins
    requireHeader: ["origin", "x-requested-with"],
    removeHeaders: ["cookie", "cookie2"]
  })
  .listen(port, host, function() {
    console.log("Running CORS Anywhere on " + host + ":" + port);
  });
複製代碼/<code>

「前端代碼」

<code> 
 
複製代碼/<code>

「效果展示」

image-20200413161243734

「缺點」

無法專遞 cookie，原因是因為這個是一個代理庫，作者覺得中間傳遞 cookie 太不安全了。https://github.com/Rob--W/cors-anywhere/issues/208#issuecomment-575254153

c.charles

介紹

這是一個測試、開發的神器。介紹與使用

利用 charles 進行跨域，本質就是請求的攔截與代理。

在 tools/map remote 中設置代理

image-20200412232733437

image-20200412232724518

前端代碼

<code>

 
 
複製代碼/<code>

後端代碼

<code>router.get("/api/corslist", async ctx => {
  ctx.body = {
    data: [{ name: "秋風的筆記" }]
  };
});

router.post("/api/login", async ctx => {
  ctx.cookies.set("token", token, {
    expires: new Date(+new Date() + 1000 * 60 * 60 * 24 * 7)
  });
  ctx.body = {
    msg: "成功",
    code: 0
  };
});
複製代碼/<code>

效果

訪問 http://localhost:8000/charles

image-20200412232231554

image-20200412232752837

完美解決。

唔。這裡又有一個注意點。在 Mac mojave 10.14 中會出現 charles 抓不到本地包的情況。這個時候需要自定義一個域名，然後配置hosts指定到127.0.0.1。然後修改訪問方式 http://localhost.charlesproxy.com:8000/charles。

image-20200412233258107

image-20200412233317027

3.Nginx 反向代理

介紹

Nginx 則是通過反向代理的方式，（這裡也需要自定義一個域名）這裡就是保證我當前域，能獲取到靜態資源和接口，不關心是怎麼獲取的。nginx 安裝教程《「轉」Nginx系列教程大綱彙總-值得收藏》

image-20200412233536522

配置下 hosts

127.0.0.1 local.test

配置 nginx

<code>server {
        listen 80;
        server_name local.test;
        location /api {
            proxy_pass http://localhost:8080;
        }
        location / {
            proxy_pass http://localhost:8000;
        }
}
複製代碼/<code>

啟動 nginx

sudo nginx

重啟 nginx

sudo nginx -s reload

實現

前端代碼

<code> 
複製代碼/<code>

後端代碼

<code>router.get("/api/corslist", async ctx => {
  ctx.body = {
    data: [{ name: "秋風的筆記" }]
  };
});

router.post("/api/login", async ctx => {
  ctx.cookies.set("token", token, {
    expires: new Date(+new Date() + 1000 * 60 * 60 * 24 * 7)
  });
  ctx.body = {
    msg: "成功",
    code: 0
  };
});
複製代碼/<code>

效果

訪問 http://local.test/charles

瀏覽器顯示

image-20200413000229326

4.JSONP

JSONP 主要就是利用了>

「使用限制」

僅支持 GET 方法，如果想使用完整的 REST 接口，請使用 CORS 或者其他代理方式。

「流程解析」

1.前端定義解析函數（例如 jsonpCallback=function(){....}）

2.通過 params 形式包裝請求參數，並且聲明執行函數(例如 cb=jsonpCallback)

3.後端獲取前端聲明的執行函數（jsonpCallback），並以帶上參數並調用執行函數的方式傳遞給前端。

「使用示例」

後端實現

<code>const Koa = require("koa");
const fs = require("fs");
const app = new Koa();

app.use(async (ctx, next) => {
  if (ctx.path === "/api/jsonp") {
    const { cb, msg } = ctx.query;
    ctx.body = `${cb}(${JSON.stringify({ msg })})`;
    return;
  }
});

app.listen(8080);
複製代碼/<code>

普通 js 示例

<code> 
 
複製代碼/<code>

JQuery Ajax 示例

<code> 
 
複製代碼/<code>

「原理解析」

其實這就是 js 的魔法

我們先來看最簡單的 js 調用。嗯，很自然的調用。

<code> 
 
複製代碼/<code>

我們稍稍改造一下，外鏈的形式。

<code> 
 

// http://localhost:8080/api/a.js jsonpCallback({a:1});
複製代碼/<code>

我們再改造一下，我們把這個外鏈的 js 就當做是一個動態的接口，因為本身資源和接口一樣，是一個請求，也包含各種參數，也可以動態化返回。

<code> 
 

// http://localhost:8080/api/a.js jsonpCallback({a:123});
複製代碼/<code>

你仔細品，細細品，是不是 jsonp 有的優勢就是>

5.Websocket

WebSocket 規範定義了一種 API，可在網絡瀏覽器和服務器之間建立“套接字”連接。簡單地說：客戶端和服務器之間存在持久的連接，而且雙方都可以隨時開始發送數據。詳細教程可以看 https://www.html5rocks.com/zh/tutorials/websockets/basics/

這種方式本質沒有使用了 HTTP, 因此也沒有跨域的限制，沒有什麼過多的解釋直接上代碼吧。

前端部分

<code> 
複製代碼/<code>

後端部分

<code>const WebSocket = require("ws");
const server = new WebSocket.Server({ port: 8080 });
server.on("connection", function(socket) {
  socket.on("message", function(data) {
    socket.send(data);
  });
});
複製代碼/<code>

6.window.postMessage

「window.postMessage()」 方法可以安全地實現跨源通信。通常，對於兩個不同頁面的腳本，只有當執行它們的頁面位於具有相同的協議（通常為 https），端口號（443 為 https 的默認值），以及主機 (兩個頁面的模數 Document.domain設置為相同的值) 時，這兩個腳本才能相互通信。「window.postMessage()」 方法提供了一種受控機制來規避此限制，只要正確的使用，這種方法就很安全。

用途

1.頁面和其打開的新窗口的數據傳遞

2.多窗口之間消息傳遞

3.頁面與嵌套的 iframe 消息傳遞

用法

詳細用法看 https://developer.mozilla.org/zh-CN/docs/Web/API/Window/postMessage

otherWindow.postMessage(message, targetOrigin, [transfer]);

• otherWindow: 其他窗口的一個引用，比如 iframe 的 contentWindow 屬性、執行window.open返回的窗口對象、或者是命名過或數值索引的window.frames。
• message: 將要發送到其他 window 的數據。
• targetOrigin: 通過窗口的 origin 屬性來指定哪些窗口能接收到消息事件.
• transfer(可選) : 是一串和 message 同時傳遞的 Transferable 對象. 這些對象的所有權將被轉移給消息的接收方，而發送一方將不再保有所有權

示例

index.html

<code>
 
複製代碼/<code>

another.html

<code>
hello
 
複製代碼/<code>

7.document.domain + Iframe

從第 7 種到第 9 種方式，我覺得別人的寫的已經很好了，為了完整性，我就拿別人的了。如有雷同....（不對，就是雷同....）不要說不出來。

「該方式只能用於二級域名相同的情況下，比如 a.test.com 和 b.test.com 適用於該方式」。 只需要給頁面添加 document.domain ='test.com' 表示二級域名都相同就可以實現跨域。

<code>www.   baidu.  com     .
三級域  二級域   頂級域   根域
複製代碼/<code>

<code>// a.test.com

  helloa
  
   

複製代碼/<code>

<code>// b.test.com

  hellob
   

複製代碼/<code>

8.window.location.hash + Iframe

實現原理

原理就是通過 url 帶 hash ，通過一個非跨域的中間頁面來傳遞數據。

實現流程

一開始 a.html 給 c.html 傳一個 hash 值，然後 c.html 收到 hash 值後，再把 hash 值傳遞給 b.html，最後 b.html 將結果放到 a.html 的 hash 值中。 同樣的，a.html 和 b.htm l 是同域的，都是 http://localhost:8000，而 c.html 是http://localhost:8080

<code>// a.html

 
複製代碼/<code>

<code>// b.html
 
複製代碼/<code>

<code>// c.html

 
複製代碼/<code>

9.window.name + Iframe

window 對象的 name 屬性是一個很特別的屬性，當該 window 的 location 變化，然後重新加載，它的 name 屬性可以依然保持不變。

其中 a.html 和 b.html 是同域的，都是http://localhost:8000，而 c.html 是http://localhost:8080

<code>// a.html

 
複製代碼/<code>

b.html 為中間代理頁，與 a.html 同域，內容為空。

<code>// b.html

複製代碼/<code>

<code>// c.html
 
複製代碼/<code>

通過 iframe 的 src 屬性由外域轉向本地域，跨域數據即由 iframe 的 window.name 從外域傳遞到本地域。這個就巧妙地繞過了瀏覽器的跨域訪問限制，但同時它又是安全操作。

10.瀏覽器開啟跨域（終極方案）

其實講下其實跨域問題是瀏覽器策略，源頭是他，那麼能否能關閉這個功能呢？

答案是肯定的。

「注意事項: 因為瀏覽器是眾多 web 頁面入口。我們是否也可以像客戶端那種，就是用一個單獨的專門宿主瀏覽器，來打開調試我們的開發頁面。例如這裡以 chrome canary 為例，這個是我專門調試頁面的瀏覽器，不會用它來訪問其他 web url。因此它也相對於安全一些。當然這個方式，只限於當你真的被跨域折磨地崩潰的時候才建議使用以下。使用後，請以正常的方式將他打開，以免你不小心用這個模式幹了其他的事。」

Windows

<code>找到你安裝的目錄
.\Google\Chrome\Application\chrome.exe --disable-web-security --user-data-dir=xxxx
複製代碼/<code>

Mac

~/Downloads/chrome-data 這個目錄可以自定義.

<code>/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary  --disable-web-security --user-data-dir=~/Downloads/chrome-data
複製代碼/<code>

效果展示

image-20200413143102377

嗯，使用起來很香，但是再次提醒，一般情況千萬別輕易使用這個方式，這個方式好比七傷拳，使用的好威力無比，使用不好，很容易傷到自己。

三、為什麼需要跨域？

在最一開始，我們知道了，跨域只存在於瀏覽器端。而瀏覽器為 web 提供訪問入口。我們在可以瀏覽器內打開很多頁面。正是這樣的開放形態，所以我們需要對他有所限制。就比如林子大了，什麼鳥都有，我們需要有一個統一的規範來進行約定才能保障這個安全性。

1.限制不同源的請求

這裡還是用最常用的方式來講解，例如用戶登錄 a 網站，同時新開 tab 打開了 b 網站，如果不限制同源， b 可以像 a 網站發起任何請求，會讓不法分子有機可趁。

2.限制 dom 操作

我舉個例子吧, 你先登錄下 www.baidu.com ,然後訪問我這個網址。

https://zerolty.com/node-demo/index.html

image-20200413190413758

你會發現，這個和真實的百度一模一樣，如果再把域名搞的相似一些，是不是很容易被騙，如果可以進行 dom 操作...那麼大家的信息在這種釣魚網站眼裡都是一顆顆小白菜，等著被收割。

❝

可以在 http 返回頭 添加X-Frame-Options: SAMEORIGIN 防止被別人添加至 iframe。

❞

寫在最後

以上最常用的就是前 4 種方式，特別是第 2 種非常常見，我裡面也提到了多種示例，大家可以慢慢消化一下。希望未來有更加安全的方式來限制 web ，解決跨域的頭疼，哈哈哈哈。

「有一個不成熟的想法，可以搞這麼一個瀏覽器，只讓訪問內網/本地網絡，專門給開發者用來調試頁面用，對於靜態資源可以配置白名單，這樣是不是就沒有跨域問題了，23333。上述如有錯誤，請第一時間指出，我會進行修改，以免給大家來誤導。」

推薦跨域解決相關文章

《手把手教你徹底解決跨域問題：遇到Cookie與SameSite【實踐】》

《手把手教你全套實踐解決前後端的跨域問題》

《跨域總結:從CORS到Ngnix》

《「轉」Nginx系列教程大綱彙總-值得收藏》

作者：藍色的秋風
轉發鏈接：https://juejin.im/post/5e948bbbf265da47f2561705