核心需求
- 隱藏路徑:使用者看不到真實檔案位置,無法直接連結下載
- 防盜鏈:檢查
HTTP_REFERER 必須來自本站
- 權限控管:可結合 Session/資料庫驗證下載權限
- 支援大檔/斷點續傳:輸出
Content-Length、Accept-Ranges
完整下載函式:DownloadFile.asp
<%@ Language=VBScript CodePage=65001 %>
<%
Function DownloadFile(virtualPath)
Dim fso, file, fileName, fileExt, fileSize, stream, referer, host
Dim allowExt, denyExt, i
' 1. 實體路徑轉換與存在性檢查
Dim physPath : physPath = Server.MapPath(virtualPath)
Set fso = Server.CreateObject("Scripting.FileSystemObject")
If Not fso.FileExists(physPath) Then
Call DenyAccess("檔案不存在")
End If
' 2. 防盜鏈:檢查 Referer
referer = Request.ServerVariables("HTTP_REFERER")
host = Request.ServerVariables("SERVER_NAME")
If referer = "" Or InStr(1, referer, host, vbTextCompare) = 0 Then
Call DenyAccess("非法連結來源")
End If
' 3. 副檔名黑名單 (防下載腳本/資料庫)
denyExt = Array("asp","asa","aspx","asax","mdb","accdb","php","jsp","config","bak","log","inc")
fileName = fso.GetFileName(physPath)
fileExt = LCase(Mid(fileName, InStrRev(fileName, ".") + 1))
For i = 0 To UBound(denyExt)
If fileExt = denyExt(i) Then Call DenyAccess("檔案類型禁止下載")
Next
' 4. 開啟檔案串流
Set stream = Server.CreateObject("ADODB.Stream")
stream.Type = 1 ' adTypeBinary
stream.Open
On Error Resume Next
stream.LoadFromFile physPath
If Err.Number <> 0 Then
Call DenyAccess("檔案讀取失敗: " & Err.Description)
End If
On Error GoTo 0
fileSize = stream.Size
' 5. 斷點續傳支援 (Range 請求)
Dim rangeHeader, startPos, endPos, contentLength
rangeHeader = Request.ServerVariables("HTTP_RANGE")
startPos = 0
endPos = fileSize - 1
contentLength = fileSize
Dim statusCode : statusCode = 200
If rangeHeader <> "" Then
' 簡易解析 bytes=start-end
Dim rangeMatch, startStr, endStr
Set rangeMatch = New RegExp
rangeMatch.Pattern = "bytes=(\d+)-(\d*)"
rangeMatch.Global = False
Dim m : Set m = rangeMatch.Execute(rangeHeader)
If m.Count > 0 Then
startStr = m(0).SubMatches(0)
endStr = m(0).SubMatches(1)
If IsNumeric(startStr) Then startPos = CLng(startStr)
If endStr <> "" And IsNumeric(endStr) Then endPos = CLng(endStr)
If endPos >= fileSize Then endPos = fileSize - 1
contentLength = endPos - startPos + 1
statusCode = 206 ' Partial Content
End If
End If
' 6. 輸出 HTTP 標頭
Response.Buffer = False ' 大檔案關閉緩衝,直接串流
Response.Clear
Response.Status = statusCode
Response.AddHeader "Content-Type", "application/octet-stream"
Response.AddHeader "Content-Disposition", "attachment; filename=""" & fileName & """"
Response.AddHeader "Content-Length", CStr(contentLength)
Response.AddHeader "Accept-Ranges", "bytes"
If statusCode = 206 Then
Response.AddHeader "Content-Range", "bytes " & startPos & "-" & endPos & "/" & fileSize
End If
Response.Charset = "UTF-8"
Response.CacheControl = "private"
Response.Expires = 0
' 7. 定位並輸出
stream.Position = startPos
Response.BinaryWrite stream.Read(contentLength)
Response.Flush
stream.Close
Set stream = Nothing
Set fso = Nothing
Response.End
End Function
Sub DenyAccess(reason)
Response.Status = 403
Response.Write "403 Forbidden: " & reason
Response.End
End Sub
%>
呼叫方式
<!-- 下載頁面 download.asp -->
<%@ Language=VBScript CodePage=65001 %>
<!--#include file="DownloadFile.asp"-->
<%
' 權限檢查 (例如會員等級、購買記錄)
If Session("UserID") = "" Then Response.Redirect "login.asp?return=" & Server.URLEncode(Request.URL)
' 記錄下載日誌
Call LogDownload(Session("UserID"), Request("file"))
' 執行下載
Call DownloadFile(Request("file")) ' 參數為虛擬路徑,如 "/files/report.pdf"
%>
前端下載連結
<a href="download.asp?file=/files/manual.pdf">下載說明手冊</a>
<a href="download.asp?file=/protected/data.zip">下載資料包</a>
進階:大檔案效能優化
- 關閉 Response.Buffer:避免大檔案佔用伺服器記憶體
- 使用 Persits.ASPUpload 的 SendBinary (若已購授權):內核級傳送,CPU 佔用極低
- X-Sendfile / X-Accel-Redirect:若前端掛 Nginx/IIS ARR,ASP 僅驗證權限後回傳
X-Accel-Redirect: /protected/file.zip,由 Nginx 直接傳檔
- 非同步處理:生成下載 Token 存 Redis,下載頁由獨立高效能服務 (Go/Node) 處理
安全清單
- [ ] 所有輸入路徑經
Server.MapPath 解析,防止目錄遍歷 ../../etc/passwd
- [ ] 副檔名白名單優於黑名單
- [ ] Referer 檢查可被偽造,重要檔案請改用 **簽名 URL (Signed URL)** 或 **Token 驗證**
- [ ] 記錄下載日誌 (用戶、IP、檔案、時間、User-Agent) 供稽核