全部產品
Search
文件中心

ApsaraVideo VOD:點播CDN常見問題

更新時間:Aug 08, 2026

本文為您介紹ApsaraVideo for VODCDN相關常見問題。

問題分類

購買和計費

無法訪問/訪問異常

添加網域名稱/網域名稱解析

緩衝相關

回源/來源站點

HTTPS相關

重新整理/預熱

安全相關

如何查看新購買的加速資源套件(ApsaraVideo for VOD流量包)?

說明

僅支援查詢當前有效資源套件及失效時間未超一年的資源套件的使用明細。

  1. 登入費用與成本

  2. 在左側導覽列選擇資源執行個體管理

  3. 資源執行個體管理頁面,資源維度選擇資源套件,可以查看資源套件使用明細。

    您可以設定產品名稱ApsaraVideo for VOD,或者設定生效時間、狀態等其他過濾條件來查詢資源套件。

為什麼監控查詢流量、用量查詢流量與日誌統計流量有差異?

問題現象

為什麼通過ApsaraVideo for VOD控制台(或者OpenAPI)的監控查詢資源用量查詢(實際計費流量)功能查到的加速網域名稱使用的流量資料與通過日誌統計的流量資料有差異?(通過日誌統計的流量資料通常會比通過監控查詢流量或者用量查詢流量查詢的資料更小一些。)

可能原因

日誌統計流量是統計日誌中response size欄位記錄的流量資料,只統計了應用程式層產生的流量,但實際產生的網路流量(網路層統計的流量)通常比應用程式層流量要高出7%~15%。主要原因是網路層流量比應用程式層流量多了以下兩個流量消耗:

  • TCP/IP包頭:應用程式層流量在開始網路傳輸之前,需要先使用TCP協議(傳輸層)封裝為TCP資料包,再使用IP協議(網路層)封裝為IP資料包,IP資料包最大為1500位元組,這其中包含了20位元組TCP協議包頭和20位元組IP協議包頭,這兩個協議包頭也會產生網路流量,但由於應用程式層無法統計到這兩個包頭的流量,因此日誌統計流量裡不包含這40位元組。這部分包頭消耗的網路流量至少佔通過日誌統計流量的2.74%(按最大IP資料包1500位元組,其中TCP/IP包頭40位元組,應用程式層資料1460位元組),應用程式層資料越小佔比越大,通常在3%左右。

  • TCP重傳由於互連網中網路情況較為複雜,在出現網路擁堵、裝置故障等情況下就會出現丟包,通常有3%~10%的資料會被互連網丟棄,資料包被丟棄後的重傳動作是由作業系統核心層的協議棧處理的,無法記錄到應用程式層日誌中,因此這部分也會產生額外的網路消耗。

基於以上兩個額外的網路流量消耗,在行業慣例中,會在基於日誌中response size欄位統計出的應用程式層流量的基礎上,再加上7%~15%的網路消耗來得出實際的計費流量資料(即:體現在費用賬單上的資料)。ApsaraVideo for VODCDN中取平均值10%作為網路消耗流量,因此實際的計費流量(也包括監控查詢流量)是通過日誌統計流量的1.1倍(即:TCP係數1.1)。

來源站點不在中國內地,使用中國內地CDN節點加速如何收費?

當您的來源站點在中國香港、中國澳門、中國台灣或海外時,使用中國內地CDN節點加速時,按照中國內地CDN加速服務標準收費。

由於CDN收費只針對CDN節點的下行流量收費,因此您使用中國內地的CDN加速服務,而來源站點在海外,CDN的收費仍然按中國內地CDN加速服務標準收費,但是這樣會影響加速效能。因為中國內地CDN節點回源訪問海外來源站點時,可能會出現延遲。如果您的來源站點和使用者都在海外,則建議您開啟Global Acceleration服務。

購買ApsaraVideo for VOD套餐包後,資源套件可以在CDN、OSS中使用嗎?

不可以。ApsaraVideo for VOD是一款獨立計費的產品,在使用過程中,會產生儲存、轉碼、流量或頻寬的消費。ApsaraVideo for VOD套餐包內的各項資源套件(即流量包、儲存包、高清轉碼包)僅限於抵扣ApsaraVideo for VOD產品內產生的資源消耗,無法在CDN、OSS等同類型資源消耗產品中使用。

已經購買了ApsaraVideo for VOD流量包,為什麼依然產生流量費用?

ApsaraVideo for VOD流量包生效條件為已配置加速網域名稱,且加速服務的計費方式選擇為按流量計費。ApsaraVideo for VOD流量包生效後,僅用於優先抵扣加速流量,不包含儲存流出流量。當超出所購流量包抵扣額度的用量後,產生的流量將計入隨用隨付產生後付費賬單。當產生流量計費時,請確認是否存在以下情況:

  • 已配置加速網域名稱

    • 網域名稱未完全配置成功,導致不能正常抵扣資源套件。例如僅添加了網域名稱,未成功配置CNAME等,請確保網域名稱為正常运行的狀態。有關網域名稱的配置,請參見ApsaraVideo for VOD快速入門

    • 已經成功配置了加速網域名稱,但訪問ApsaraVideo for VOD中的資源時直接使用OSS地址,未使用加速網域名稱地址訪問,從而產生了儲存流出流量費用,計費詳情請參見儲存流出流量計費

    • 實際使用的加速流量已經超出所購買的流量包規格,導致產生額外的流量費用。您可以續約資源套件,請參見資源套件續約

  • 未配置加速網域名稱

    ApsaraVideo for VOD未配置加速網域名稱時,預設返回OSS回源地址,通過該類型地址播放或下載ApsaraVideo for VOD中的資源,將產生儲存流出流量費用。

被攻擊或惡意盜刷產生的流量和請求是否收費?

客戶流量被惡意盜刷或者被攻擊而產生突髮帶寬增高,因為實際消耗了ApsaraVideo for VOD的頻寬資源,所以您需要自行承擔攻擊產生的流量頻寬費用。

您可以提升視頻的安全性或設定頻寬峰值預警,來應對流量被惡意盜刷或者被攻擊。

  • 開啟視頻安全相關功能

    如果您的業務有潛在的被攻擊風險,建議提升視頻的安全性來增加視頻被攻擊的難度。ApsaraVideo for VOD提供了一套完善的Alibaba Content Security Service保護機制,可用於防止視頻內容不被盜鏈、非法下載和傳播,可以滿足不同業務情境的安全需求。具體詳情,請參見視頻安全概述

  • 開啟頻寬峰值監控

    設定網域名稱的頻寬上限閾值,當達到設定的頻寬閾值之後,您將會收到簡訊通知。詳情請參見頻寬峰值監控

CDN節點在響應4xx狀態代碼的情況下是否會產生費用?

會。您的加速網域名稱可能會受到攻擊或者被惡意盜刷流量,面對類似問題的時候,您可以給加速網域名稱配置Referer防盜鏈、URL鑒權、遠程鑒權、IP黑/白名單、UA黑/白名單等存取控制功能,命中存取控制規則的惡意請求將會收到CDN節點響應的4xx狀態代碼,從而阻止惡意請求對您資源的訪問。在該情況下,CDN節點處理惡意訪問請求的過程中需要消耗CPU處理資源,CDN節點響應惡意請求4xx狀態代碼的過程中需要消耗流量頻寬資源,因此您仍然需要承擔CDN節點響應4xx狀態代碼的情況下產生的流量頻寬費用。有關ApsaraVideo for VOD的流量計費詳情,請參見加速服務計費

使用配置好的網域名稱訪問ApsaraVideo for VOD資源返回404

Web伺服器返回HTTP 404狀態代碼時,會自動跳轉到404頁面。由於網頁URL建置規則改變、網頁檔案更名或移動位置、匯入連結拼字錯誤等,導致原來的URL地址無法訪問。當Web伺服器接收到類似請求時,會返回一個404狀態代碼,告訴瀏覽器需要請求的資源並不存在。

說明

請確保資源所在的儲存與網域名稱的匹配關係,若同地區下存在多個儲存,且只有一個網域名稱時,對於其他未綁定網域名稱的儲存資源,點播控制台會優先返回上述地區下的CDN地址。

定位CDN訪問異常是CDN節點問題還是來源站點問題

  1. 訪問阿里崑崙使用者診斷工具,確認本網正常。

  2. 在本地hosts檔案中添加來源站點的解析,進行網站訪問測試。如果訪問來源站點時出現異常,說明是您的來源站點存在問題。請聯絡網站管理員進行修複。

    # Copyright (c) 1993-2009 Microsoft Corp.
    #
    # This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
    #
    # This file contains the mappings of IP addresses to host names. Each
    # entry should be kept on an individual line. The IP address should
    # be placed in the first column followed by the corresponding host name.
    # The IP address and the host name should be separated by at least one
    # space.
    #
    # Additionally, comments (such as these) may be inserted on individual
    # lines or following the machine name denoted by a '#' symbol.
    #
    # For example:
    #
    #      xxx.xxx.xxx.xxx     xxx.com          # source server
    #      xxx.xxx.xxx.xxx     xxx                              # x client host
    # localhost name resolution is handled within DNS itself.
    #    127.0.0.1       localhost
    #    ::1             localhost
    1xxx.xxx.xxx7 www.xxx.com
  3. 備忘上一步添加的本地hosts解析,通過ping命令測試添加的加速網域名稱,如果能ping通,說明CDN節點正常。

    C:\Users\xxx>ping www.xxx.com
    正在 Ping xxx.com [1xx.xxx.xxx.x] 具有 32 位元組的資料:
    來自 1xx.xxx.xxx.x 的回複: 位元組=32 時間=3ms TTL=54
    來自 1xx.xxx.xxx.x 的回複: 位元組=32 時間=3ms TTL=54
    來自 1xx.xxx.xxx.x 的回複: 位元組=32 時間=3ms TTL=54
    來自 1xx.xxx.xxx.x 的回複: 位元組=32 時間=4ms TTL=54
    1xx.xxx.xxx.x 的 Ping 統計資訊:
        資料包: 已發送 = 4,已接收 = 4,丟失 = 0 (0% 丟失),
    往返行程的估計時間(以毫秒為單位):
        最短 = 3ms,最長 = 4ms,平均 = 3ms

ApsaraVideo for VOD播放出現卡頓及 4008/4009 報錯如何排查?

出現播放卡頓或 4008/4009 報錯時,可按以下步驟排查:

  1. 使用播放連結偵查工具自助診斷視頻播放鏈路。

  2. 確認用戶端網路環境(如 4G)是否穩定,下行頻寬是否不低於視頻碼率,建議切換網路進行測試。

  3. 檢查播放 URL 或 TS 分區地址是否可正常訪問,排除 CDN 節點響應異常。

  4. 若為加密 HLS 播放情境,檢查播放器配置中的 loadDataTimeout 參數是否設定過短。

  5. 通過瀏覽器開發人員模式查看請求詳情,確認是否存在特定分區載入逾時(對應 4008 錯誤)或返回 0 位元組(對應 4009 錯誤)的情況。

開通Global Acceleration後沒有提高海外使用者的訪問速度

可通過以下幾點進行排查:

  • 當海外使用者訪問時,查看訪問請求中網域名稱解析的IP地址,判斷海外節點的配置是否生效。

  • 海外節點配置後的效果還和訪問的請求熱度有關。只有海外節點的請求熱度較高時,才能有效提升訪問速度。如果請求數量很低,則會有較少的請求能夠命中緩衝,在這種情況下,即使增加海外節點也無法明顯地提高海外使用者的訪問速度。

ApsaraVideo for VOD中加速網域名稱已開啟試看功能但MP4視頻試看不生效

ApsaraVideo for VOD的試看功能支援的檔案格式為MP4、HLS。其中,MP4視頻的Meta資訊必須在檔案頭部,不支援Meta資訊在尾部的MP4視頻。通過ApsaraVideo for VOD服務轉碼封裝格式為MP4的時候,會將Meta資訊放置在檔案頭部。您可以通過將此類MP4視頻進行轉碼來解決試看不生效的問題,轉碼詳情請參見音視頻轉碼

內網播放ApsaraVideo for VOD需允許存取網路原則

ApsaraVideo for VOD CDN 不支援內網服務。內網環境需通過以下方案之一訪問ApsaraVideo for VOD:

  1. 允許存取網域名稱:開通公網出站訪問,允許存取 API 網域名稱 vod.<RegionId>.aliyuncs.com:443 及 CDN 加速網域名稱。無需維護動態 IP。

  2. 擷取 CDN 節點 IP:調用 DescribeUserVipsByDomain 介面擷取 CDN L1 節點 IP,並加入防火牆白名單。由於 CDN 節點 IP 為動態分配,需定期重新整理白名單。

  3. 使用 OSS 內網網域名稱:使用 outin-<bucket_id>.oss-<RegionId>-internal.aliyuncs.com 替換加速網域名稱,繞過 CDN 直接存取來源站點。

ApsaraVideo for VOD支援配置泛網域名稱加速嗎?

ApsaraVideo for VOD支援通過 AddVodDomain API 添加泛網域名稱,泛網域名稱需以英文句號(.)開頭,如:.aliyundoc.com

添加網域名稱時提示“該網域名稱的根網域名稱已被其他帳號佔用”錯誤

在ApsaraVideo for VOD控制台添加網域名稱失敗並報錯該網域名稱的根網域名稱已被其他帳號佔用,錯誤資訊為The root name of your domain is reserved by other account,please contact our Business Advisors,則表明該網域名稱的根網域名稱已被其他阿里雲帳號添加到阿里雲CDN或全站加速或ApsaraVideo for VOD控制台上。

如果您無法自行解決,請您提交工單。關於如何提交工單,請參見聯絡我們

添加網域名稱時提示“This domain name is exist already”錯誤

在ApsaraVideo for VOD控制台添加網域名稱失敗並報錯This domain name is exist already,則表明該網域名稱已經被添加到阿里雲的其他雲產品中。

加速網域名稱不允許重複添加,出現上述提示時,請檢查您的網域名稱是否已經添加到其他雲產品中,例如ApsaraVideo for Live、全站加速、SCDN和視頻監控等。

如果您無法自行解決,請您提交工單。關於如何提交工單,請參見聯絡我們

如何測試CNAME解析是否正常?

不推薦使用 ping 命令驗證,ping 命令返回的解析資訊可能不準確。應使用 nslookup 或 dig 等查詢工具驗證。

  • Windows

    在Windows系統的命令提示字元(CMD)或PowerShell中,執行以下命令查詢CNAME記錄:

    nslookup -type=CNAME <加速網域名稱>

    如果返回的結果和CDN提供的CNAME值相等,則證明CNAME解析生效。

    PS C:\Users\admin> nslookup -type=cname cdn.xxx.com
    伺服器:UnKnown
    Address: 100.xxx
    非權威應答:
    cdn.xxx.com       canonical name = cdn.xxx.com.w.alikunlun.com
  • Linux/Mac OS

    在Linux或Mac OS系統的終端(Terminal)中,使用 dig 命令驗證:

    • 僅查詢CNAME目標地址(推薦):

      dig +short <加速網域名稱> CNAME

      如果返回的結果和CDN提供的CNAME值相等,則證明CNAME解析生效。結果樣本如下:

      dig +short cdn.example.com CNAME
      cdn.example.com.w.alikunlun.com.
    • 查詢網域名稱詳細資料:

      dig <加速網域名稱> CNAME

      如果螢幕中ANSWER SECTION的CNAME值和CDN提供的CNAME值相等,則證明CNAME解析生效。

      xxx ~ % dig cdn.xxx.com CNAME
      ; &lt;&lt;&gt;> DiG 9.10.6 &lt;&lt;&gt;> cdn.xxx.com CNAME
      ;; global options: +cmd
      ;; Got answer:
      ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62811
      ;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
      ;; OPT PSEUDOSECTION:
      ; EDNS: version: 0, flags:; udp: 4000
      ;; QUESTION SECTION:
      ;cdn.normanjing.com.                IN      CNAME
      ;; ANSWER SECTION:
      cdn.normanjing.com.     600     IN      CNAME   cdn.xxx.com.w.alikunlun.com.
      ;; Query time: 67 msec
      ;; SERVER: 30.30.xxx)
      ;; WHEN: Wed Sep 24 19:05:30 CST 2025
      ;; MSG SIZE  rcvd: 92

新添加的加速網域名稱審核未通過

所有接入ApsaraVideo for VOD的網域名稱都要經過內容審核,若您的網域名稱接入ApsaraVideo for VOD失敗,可能是您的網域名稱不符合接入規則,關於網域名稱接入的標準及使用限制,請參見網域名稱准入標準

如果您的網域名稱審核未通過,請在ApsaraVideo for VOD控制台進入配置管理 > 分发加速配置 > 域名管理的網域名稱列表頁查看未通過原因,並將審核失敗的網域名稱刪除後,根據網域名稱審核未通過的原因,調整網站內容,重新添加網域名稱等待審核即可。

如何提升ApsaraVideo for VOD快取命中率

如果發生命中率過低的情況意味著使用者的每次請求都會通過CDN回源,公網鏈路的不穩定可能導致加速的效果反而變差。您可以通過預熱URL、配置資源緩衝規則、過濾URL中可變參數提升ApsaraVideo for VOD的快取命中率。

具體方案如下:

策略

影響因素與應用情境

配置方法

業務高峰前預熱熱門資源

影響因素:營運大型活動或新版本安裝包發布前,沒有提前將資源預熱到CDN節點,大量資源需要從來源站點擷取,導致CDN快取命中率低。

應用情境:

  • 營運活動

    營運一個大型活動時,提前將活動頁涉及到的靜態資源預熱至CDN節點,活動開始後使用者訪問的所有靜態資源均已緩衝至CDN加速節點,由加速節點直接響應。

  • 安裝包發布

    新版本安裝包或升級包發布前,提前將資源預熱至CDN加速節點,產品正式上線後,海量使用者的下載請求將直接由CDN加速節點響應,提升下載速度,大幅度降低來源站點壓力,提升使用者體驗。

重新整理預熱

合理配置緩衝到期時間

影響因素:

  • CDN上未配置緩衝策略,所有使用者請求都需要回來源站點。

  • CDN上配置的緩衝到期時間過短,緩衝資源頻繁到期,導致快取命中率低。

應用情境:使用者在來源站點發布了靜態資源,CDN節點沒有將資源緩衝下來,或者CDN節點上緩衝的資源很快就失效了。

配置建議:

  • 對於不經常更新的靜態檔案(如圖片類型、應用下載類型等),建議您將緩衝到期時間設定為1個月以上。

  • 對於頻繁更新的靜態檔案(如JS、CSS、MP4等),您可以根據實際業務情況設定緩衝到期時間。

  • 對於動態檔案(如PHP、JSP、ASP等),建議您將緩衝到期時間設定為0s,即不緩衝。

緩衝配置

去除URL中問號後的參數緩衝

影響因素:當URL請求中帶有queryString或其他可變參數時,訪問同一個資源的不同URL(URL攜帶的參數不同)會重新回源,導致CDN快取命中率低。

應用情境:希望通過不同的URL(URL攜帶的參數不同),可以訪問到同一個資源。

過濾參數

大檔案設定分區回源策略

影響因素:使用者下載安裝包可能下載一半就停止下載,或者觀看視頻只看了一部分就停止觀看,即使用者只需要訪問資源檔指定範圍內的部分內容,但是CDN節點會向來源站點請求整個檔案,從而使得CDN節點從來源站點下載的內容大於響應給使用者的內容,導致快取命中率低。

應用情境:使用者下載應用安裝包或者觀看視頻資源。

配置Range回源

在ApsaraVideo for VOD配置加速網域名稱後加速資源訪問速度較慢

加速網域名稱主要是通過在現有網路中增加一層新的緩衝節點,將網站伺服器的資源發布到最接近使用者的網路節點,使得使用者側用戶端在請求時直接存取到就近的CDN節點並命中該資源,減少回源情況,提高網站訪問速度。因此,造成訪問慢的可能原因可以簡單歸納為以下幾個類型:

  • 用戶端本網因素,例如用戶端下行頻寬不足、配置錯誤等。

  • 用戶端到CDN節點之間的網路不佳,網路延遲較高。

  • CDN節點異常,響應速度慢。

  • 資源內容比較大,導致下載比較耗時。

  • CDN回源到來源站點時,回源網路不佳。

  • 來源站點本身響應速度慢。

請求加速資源時出現跨域問題並提示“The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin”

請求加速資源失敗並報錯The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin,瀏覽器開發人員工具的 Console 面板顯示 CORS 跨域錯誤:請求的 origin(https://vr-mc01.xxx)與回應標頭 Access-Control-Allow-Origin 的值(https://vr-web01.xxx)不一致,導致資源載入失敗(net::ERR_FAILED),並引發後續 JS 執行階段錯誤。從上述報錯內容可以看出,CDN響應的Access-Control-Allow-Origin跨域頭的Value值,和用戶端請求的Origin跨域頭不一致,導致瀏覽器沒有響應這個請求。例如,請求跨域頭為“Origin:http://網域名稱A”,但是響應的跨域頭為“Access-Control-Allow-Origin:http://網域名稱B”。

出現該問題的原因有以下三種情況:

  • CDN配置的跨域頭和用戶端請求的Origin不一致

  • 來源站點配置的跨域頭被CDN緩衝

  • 瀏覽器緩衝

在ApsaraVideo for VOD中綁定了網域名稱,但是轉碼回調的地址中卻沒有HTTPS?

ApsaraVideo for VOD的回調返回目前不支援HTTPS,若已經在ApsaraVideo for VOD中正確配置了HTTPS認證,可以在收到回調訊息後,把資源的HTTP地址替換成HTTPS地址。

說明

截圖和封面的回調會攜帶HTTPS地址,轉碼回調會返回HTTP地址。

配置加速網域名稱後如何對檔案進行同名更新

可以從控制台或是OpenAPI提交重新整理請求,如何重新整理,請參見重新整理預熱。同一個ID每天最多提交2000個重新整理請求,每次最多隻能提交1000條,支援目錄重新整理,重新整理目錄共100個。API相關介面請參見重新整理預熱API

使用重新整理預熱功能後訪問的資源並未更新

可通過以下幾項措施排查處理:

  • 嘗試清理瀏覽器緩衝,然後重新整理頁面,查看資源是否更新。

  • 將網站網域名稱直接繫結來源站(通過修改本地host的方式),直接存取來源站點,檢查來源站點的資源是否更新。如果資源沒有更新,請更新來源站點的資源,再使用CDN加速。

  • 登入ApsaraVideo for VOD控制台,檢查重新整理預熱任務是否執行完畢,如果沒有執行完畢,建議重新執行任務。

如何屏蔽惡意IP訪問

可通過配置IP黑名單,將惡意IP設定為需要屏蔽和拒絕訪問的IP地址。詳情請參見配置IP黑白名單

配置IP黑名單後被添加的IP仍可請求訪問

請檢查點播控制台中配置的IP地址是否正確,如果需要精準限制用戶端IP地址,則需要配置XFF IP地址到黑白名單地址。XFF IP擷取方式請參見擷取用戶端真實IP

說明
  • CDN作為服務端,無法控制用戶端的訪問,配置IP黑名單後,該IP地址請求發送到CDN,會返回錯誤碼403,您可以查看日誌。查看日誌的方法,請參見日誌下載

  • 返回錯誤碼403時,會產生流量費用。403沒有實際資源的流出流量,只有回應標頭流量,涉及的費用較低,具體請參見CDN節點在響應4xx狀態代碼的情況下是否會產生費用?

由於防盜鏈異常導致訪問ApsaraVideo for VOD加速資源時返回403錯誤

問題現象

在進行防盜鏈設定後,訪問ApsaraVideo for VOD加速資源,返回403錯誤。

可能原因

防盜鏈設定異常或為空白。

解決方案

  1. 排查問題原因。

    • 使用curl命令測試訪問加速網域名稱

      curl -voa -e "http://demo.aliyundoc.com" http://example.aliyundoc.com

      系統顯示類似如下,Request請求的HTTP頭帶有Referer為demo.aliyundoc.com的網域名稱,出現403錯誤,同時出現具體錯誤資訊為denied by Referer ACL,說明防盜鏈設定異常。

      curl -voa -e "http://cjy.xxx.cn" http://ct.xxx.cn
      * Rebuilt URL to: http://ct.xxx.cn/
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                       Dload  Upload   Total   Spent    Left  Speed
        0     0    0     0    0     0      0     0 --:--:-- --:--:-- --:--:--     0*   Trying 101.xxx.xxx.144...
      * TCP_NODELAY set
      * Connected to ct.xxx.cn (101.xxx.xxx.144) port 80 (#0)
      > GET / HTTP/1.1
      > Host: ct.xxx.cn
      > User-Agent: curl/7.54.0
      > Accept: */*
      > Referer: http://cjy.xxx.cn
      >
      < HTTP/1.1 403 Forbidden
      < Server: Tengine
      < Date: Sat, 08 Dec 2018 12:36:17 GMT
      < Content-Type: text/html
      < Content-Length: 254
      < Connection: keep-alive
      < X-Tengine-Error: denied by Referer ACL
      < Via: cache15.cn157[,403003]
      < Timing-Allow-Origin: *
      < EagleId: 6525b7a315442725770753781e
      <
      { [254 bytes data]
      100   254  100   254    0     0  2489      0 --:--:-- --:--:-- --:--:--  2514
      * Connection #0 to host ct.xxx.cn left intact
    • 使用curl命令測試訪問CDN加速網域名稱

      curl -voa http://example.aliyundoc.com

      系統顯示類似如下,Request請求的HTTP頭沒有Referer資訊,出現403錯誤,同時出現具體錯誤資訊為denied by Referer ACL,說明防盜鏈設定為空白。

      jianxxx jxxx ecao$ curl -voa  http://ct.xxx.cn
      * Rebuilt URL to: http://ct.pier39.cn/
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                       Dload  Upload   Total   Spent    Left  Speed
        0     0    0     0    0     0      0     0 --:--:-- --:--:-- --:--:--     0*   Trying 101.xxx.148...
      * TCP_NODELAY set
      * Connected to ct.xxx.cn (101.xxx.148) port 80 (#0)
      > GET / HTTP/1.1
      > Host: ct.xxx.cn
      > User-Agent: curl/7.54.0
      > Accept: */*
      > 
      < HTTP/1.1 403 Forbidden
      < Server: Tengine
      < Date: Sat, 08 Dec 2018 12:48:50 GMT
      < Content-Type: text/html
      < Content-Length: 254
      < Connection: keep-alive
      < X-Tengine-Error: denied by Referer ACL
      < Via: cache5.cn1576[,403003]
      < Timing-Allow-Origin: *
      < EagleId: 6525b799154427333013711586e
      < 
      { [254 bytes data]
      100   254  100   254    0     0    992      0 --:--:-- --:--:-- --:--:--   996
      * Connection #0 to host ct.xxx.cn left intact
    • 通過Chrome瀏覽器開啟經網域名稱加速的一個URL連結,開啟開發人員工具,顯示類似如下,Request請求的HTTP頭沒有Referer資訊,說明防盜鏈設定為空白。

      403 Forbidden
      You don't have permission to access the URL on this server.
      Powered by Tengine
      Response Headers:
      Server: Tengine
      Timing-Allow-Origin: *
      Via: cache18.cn1576[,403003]
      X-Tengine-Error: denied by Referer ACL
      Request Headers:
      Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
      Accept-Encoding: gzip, deflate
      Accept-Language: zh-CN,zh;q=0.9
      Cache-Control: no-cache
      Connection: keep-alive
      Host: ct.pier39.cn
      Pragma: no-cache
      Upgrade-Insecure-Requests: 1
      User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36
  2. 根據不同原因進行相應的處理。

    • 防盜鏈設定異常的解決方案

      判斷Referer為demo.aliyundoc.com的網域名稱與加速網域名稱example.aliyundoc.com設定的防盜鏈是否匹配。

      登入ApsaraVideo for VOD控制台,選擇配置管理 > 分发加速配置 > 域名管理,單擊目標網域名稱後的配置,選擇访问控制 > Referer防盜鏈 > 修改配置,Referer類型選擇白名单,確認防盜鏈設定和請求Referer不匹配,則添加demo.aliyundoc.com網域名稱即可。此處Referer防盜鏈配置為白名單類型,規則中填寫 demo.aliyundoc.com,且未勾選允許通過瀏覽器地址欄直接存取資源URL允許空Referer欄位訪問CDN資源

    • 防盜鏈設定為空白的解決方案

      登入ApsaraVideo for VOD控制台,選擇配置管理 > 分发加速配置 > 域名管理,單擊目標網域名稱後的配置,選擇访问控制 > Referer防盜鏈 > 修改配置,勾選允许通过浏览器地址栏直接访问资源URL

      說明

      如將Referer防盜鏈設定為不允許為空白Referer訪問,將有被盜鏈的風險。

添加加速網域名稱提示“網域名稱已存在”怎麼辦?

該提示表示網域名稱已在其他產品或帳號中接入。處理方式:

  • 改用其他次層網域(如 vod.example.com)存取點播。

  • 若網域名稱被其他產品(如建站類產品)佔用,先在原產品中解除綁定後再添加。

  • 若網域名稱在其他帳號的 CDN 中,可提交工單協助將網域名稱遷至當前帳號後刪除再重新添加。

另請注意:網站主網域名稱與點播加速網域名稱不可共用,否則會出現訪問 403 等異常,建議使用獨立子網域名稱存取點播。

配置 HTTPS 時控制台不顯示已購認證?

認證綁定的網域名稱必須與點播加速網域名稱完全一致,否則控制台認證列表中不會展示該認證。也可調用 SetVodDomainSSLCertificate 介面配置認證(該介面僅支援華東2(上海)地區,服務地址需選擇上海)。認證續約後需重新部署新認證替換舊認證後生效。

Web 播放器 SDK 引入後觸發反調試(debugger)無法使用開發人員工具怎麼辦?

aliplayer-min.js 生產版本內建了反調試保護機制,在非授權環境或開啟開發人員工具時會自動插入 debugger 語句,防止未授權使用或代碼篡改,該機制無法通過配置關閉。

若懷疑本地環境與官方版本存在差異,可訪問官方播放器設定頁面進行對比測試。

Web 播放器 SDK 字幕與歌詞同步播放如何??

Web 播放器 SDK 中 VTT 字幕預設顯示在播放器畫面下方,樣式與視頻字幕一致。

SDK 原生不支援音樂播放器風格的逐行滾動或高亮置中歌詞特效。如需實現 MP3 音頻歌詞同步,需將歌詞轉換為 VTT 格式作為外掛字幕使用,確保 VTT 時間戳記與音頻播放進度精確對應,並通過監聽播放器時間更新事件自行解析 VTT 內容、開發自訂 UI 組件渲染歌詞。

Web 播放器切後台恢複播放報錯或長時間 Loading 怎麼辦?

瀏覽器後台資源回收會導致播放器失活,或 PlayAuth 憑證到期(有效期間最長 3000 秒)也會導致該問題。

解決方案:監聽 visibilitychange 事件,切入後台時調用 player.pause() 並將 currentTime 存入 sessionStorage;切回前台時重新擷取 PlayAuth 並調用 replayByVid(vid, newPlayAuth) 重設播放;監聽 readycanplay 事件,在回調中讀取 sessionStorage 時間並調用 player.seek() 恢複進度。

最佳化建議:配置 vodRetry0waitingTimeout 為 10 秒以縮短等待,或在憑證到期前 5 分鐘主動重新整理 Token。

ListPlayer 本機快取 enableLocalCache 如何使用及清理?

生效條件:視頻格式須為 MP4 且通過 URL 播放,若 URL 帶鑒權參數,需在計算緩衝 Key 時去掉鑒權參數。

斷網播放:配置 enableLocalCache 為 YES 後支援斷網連續播放且不消耗流量。

緩衝清理:調用 [AliPlayerGlobalSettings clearCaches] 可清除所有視頻緩衝,適用於播放中、退出登入或手動清理情境。

說明

setCacheConfig 方法已廢棄,應改用 enableLocalCache API。

Web 播放器 SDK License 校正機制及特殊情境(VPN/iframe)如何處理?

校正機制:Web 播放器 SDK 的 License 校正依據是瀏覽器地址欄中的當前網域名稱或 Referer,必須與申請 License 時綁定的網域名稱一致。

VPN 代理情境:通過 VPN 訪問會導致網域名稱不一致報錯,建議使用統一 302 跳轉至授權網域名稱頁面,或在 VPN 頁面中使用 iframe 嵌套播放頁面(確保 iframe 內載入的是授權網域名稱頁面)。

iframe 嵌套限制:若父頁面為非授權網域名稱、子頁面(iframe)為授權網域名稱,License 校正可正常通過;但需注意微信內建瀏覽器對跨域 iframe 可能存在限制,且父子頁面通訊需配置 postMessage

Web 播放器 PlayAuth 到期重新整理後如何從指定位置繼續播放?

當前限制:使用 replayByVidAndPlayAuth 方法重新整理 PlayAuth 後會從頭播放,暫不支援自動從指定位置續播。

推薦方案:在 pause 事件觸發時主動記錄當前播放時間(存入 localStorage 或記憶體變數),在捕獲到 PlayAuth 到期錯誤碼 4002 時,先重新整理 PlayAuth,再手動 seek 到之前記錄的時間點恢複播放。

兜底策略:在 error 事件中儲存最後已知有效時間作為兜底,避免因緩衝誤差導致定位不準。

Android WebView 中 Web 播放器只有聲音沒有畫面怎麼辦?

排查步驟:

  1. 檢查是否開啟硬體加速,在 AndroidManifest.xml 中設定 android:hardwareAccelerated="true",或代碼中設定 webView.setLayerType(View.LAYER_TYPE_SOFTWARE, null) 嘗試軟渲染。

  2. 檢查視頻編碼格式相容性,老舊 WebView 可能不支援高 Profile H.265/H.264,建議轉碼為相容格式。

  3. 升級 Web 播放器 SDK 至最新版本(如 2.37.6+)修複已知相容性問題。

  4. 列印 WebView 版本確認核心是否過舊。

Web 播放器 autoplay 為 false 且無封面時黑屏或一直 Loading 怎麼辦?

未設定 poster 屬性時,播放器缺少預設展示內容,因此會出現黑屏或一直 Loading 的現象。

解決方案:配置 poster 屬性指定封面圖片,或通過監聽 ready 等事件管理播放器狀態和自訂 UI 顯示。

Chrome/Edge 無法播放但 360 瀏覽器可播放的原因及解決方案

360 瀏覽器內建更多解碼器或採用相容核心(如 IE 模式),而 Chrome/Edge 對視頻格式、協議及安全性原則要求更嚴格,因此會出現該差異。

解決方案:申請阿里雲播放器 SDK 免費 License 並接入網站播放器代碼以提升相容性。

播放器拉取直播流 setDataSource 無反應且報 Connect didn't get any data from stream 怎麼辦?

需在播放器 prepared 回調中調用開始播放方法,確保準備就緒後再啟動拉流播放,否則會出現 setDataSource 無反應且報 Connect didn't get any data from stream 的情況。

如何關閉或隱藏 Web 播放器自動彈出的診斷工具介面?

診斷工具不會常駐運行,關閉標籤頁或返回播放頁即可退出。

若需在營運時隱藏以避免資訊暴露,需通過 Web 播放器 H5 自訂錯誤 UI 功能重寫代碼定義樣式(如僅保留重新整理按鈕)。

iOS 端特定瀏覽器(如 UC)無法播放視頻怎麼辦?

排查建議:

  1. 切換網路環境排除網路問題。

  2. 在網頁端添加 vconsole 工具查看具體錯誤記錄檔定位原因。

  3. 推薦使用阿里雲 Web 播放器以獲得更好相容性支援。

配置 hlsOption.abrEwmaDefaultEstimate 後是否還需額外指令碼?

abrEwmaDefaultEstimate 是播放器對當前網路環境的初始估算值,用於與 m3u8 中 BANDWIDTH 比較選擇碼率。播放過程中,播放器會根據實際下載速度更新頻寬估算值並替換初始設定,無需額外指令碼。

VOD 播放器 SDK 升級後 iOS 端部分視頻仍無法播放或顯示 Loading 怎麼辦?

建議將播放器 SDK 升級至最新版本以解決原生 HLS 相容性問題;若升級後仍存在,需排查後端配置及網域名稱認證配置情況。