基于SpringBoot實現(xiàn)圖片防盜鏈的兩種方式

更新時間：2025年02月06日 09:49:23 作者：救救孩子把

出于安全和性能的考慮,我們希望服務器返回的圖片資源僅在指定網(wǎng)站內(nèi)展示,防止爬蟲或其它站點直接引用圖片地址進行下載或展示,進而消耗服務器資源,所以本文給大家介紹了基于SpringBoot實現(xiàn)圖片防盜鏈的兩種方式,需要的朋友可以參考下

1. 實現(xiàn)目的

出于安全和性能的考慮，我們希望服務器返回的圖片資源僅在指定網(wǎng)站內(nèi)展示，防止爬蟲或其它站點直接引用圖片地址進行下載或展示，進而消耗服務器資源。簡單來說，即在請求圖片時通過檢查 HTTP 請求頭中的 Referer 來判斷請求來源是否合法。

2. 簡易實現(xiàn)方案

2.1 攔截器基本實現(xiàn)

在第一種方案中，代碼寫死了允許訪問的域名（例如 “baidudu.com”），主要步驟如下：

判斷 URL 后綴
當請求 URL 以 “.jpg”、“.png”、“.jpeg” 等圖片格式結尾時，再進行后續(xù)判斷。
檢查 Referer
從請求頭中取出 Referer，若不為空且包含預設允許的域名，則放行；否則返回 403 錯誤碼，從而拒絕訪問。

例如：

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    String requestUrl = request.getRequestURL().toString();
    if (requestUrl.endsWith(".jpg") || requestUrl.endsWith(".png") || requestUrl.endsWith(".jpeg")) {
        String referer = request.getHeader("Referer");
        if (referer != null && referer.contains("baidudu.com")) {
            return true;
        } else {
            response.sendError(HttpServletResponse.SC_FORBIDDEN);
            return false;
        }
    }
    return true;
}

注冊攔截器時，采用 Spring Boot 的 WebMvcConfigurer 接口將該攔截器應用于所有請求路徑。

3. 靈活配置實現(xiàn)方案

為了使防盜鏈的配置更加靈活，可以將配置項（例如是否開啟防盜鏈、是否允許瀏覽器直接訪問、白名單域名等）寫在 application.yml 中，并利用配置類映射到 Java 對象中。

3.1 配置文件示例

在 application.yml 中定義如下配置：

img-protect:
  enabled: true
  allowBrowser: false
  allowReferer: baidudu.com

3.2 映射配置類

利用 @ConfigurationProperties 將配置項映射到 Java 類中，方便后續(xù)使用：

@Component
@ConfigurationProperties("img-protect")
public class ImgProtectConfig {
    private boolean enabled;
    private boolean allowBrowser;
    private String allowReferer;
    // getter/setter 略
}

3.3 攔截器實現(xiàn)細節(jié)

在新版攔截器中，通過注入上述配置類，實現(xiàn)如下邏輯：

若防盜鏈功能未開啟，則直接放行。
對圖片資源請求（通過 URL 后綴判斷）：
- 如果 Referer 為空且允許瀏覽器直接訪問（allowBrowser 為 true），則放行；
- 如果 Referer 不為空，則調(diào)用輔助方法判斷 Referer 是否包含配置中允許的域名（允許多個域名，逗號分隔）；
- 否則返回 403。

例如：

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    if (!imgProtectConfig.getEnabled()){
        return true;
    }
    String requestUrl = request.getRequestURL().toString();
    if (requestUrl.endsWith(".jpg") || requestUrl.endsWith(".png") || requestUrl.endsWith(".jpeg")) {
        String referer = request.getHeader("Referer");
        if (referer == null && imgProtectConfig.getAllowBrowser()){
            return true;
        } else if (referer != null && isAllowedDomain(referer)) {
            return true;
        } else {
            response.sendError(HttpServletResponse.SC_FORBIDDEN);
            return false;
        }
    }
    return true;
}

其中 isAllowedDomain 方法遍歷配置中允許的多個域名進行比對。