萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Web 檔案上傳安全實務:儲存隔離與白名單驗證雙重防護

承接前文漏洞成因分析,本文落實具體防禦措施:從系統架構層面徹底隔離執行權限,從應用程式層面實施白名單驗證與隨機重命名,構建「縱深防禦」體系。

核心防禦策略:兩大支柱

支柱一:儲存目錄權限隔離(系統層治本)

  • 上傳目錄移出 Web 根目錄(如 `/var/www/uploads/` → `/data/uploads/`),透過 PHP 讀取輸出(`readfile`/`X-Sendfile`)。
  • 若必須置於 Web 目錄下,強制禁用腳本執行:
# Apache .htaccess (放在上傳目錄)
php_flag engine off
AddType text/plain .php .phtml .php3 .php4 .php5 .phps .asp .aspx .jsp .jspx
# Nginx location 區塊
location /uploads/ {
    location ~ \.php$ { deny all; return 403; }
}
無論上傳何種檔案,伺服器拒絕解析執行,攻擊鏈在「執行」環節即被切斷。

支柱二:應用層嚴格輸入驗證與重命名(程式層治標)

遵循「一切輸入皆有害」原則,不直接使用任何 `$_FILES` 提供的值。

標準化安全上傳流程

<?php
function secure_upload($fileInputName, array $allowedMimes, array $allowedExts, $saveDir) {
    // 1. 基礎檢查
    if (!isset($_FILES[$fileInputName]) || $_FILES[$fileInputName]['error'] !== UPLOAD_ERR_OK) {
        return ['success' => false, 'msg' => '上傳錯誤或無檔案'];
    }
    $tmp = $_FILES[$fileInputName]['tmp_name'];
    $size = $_FILES[$fileInputName]['size'];
    if ($size > 5 * 1024 * 1024) return ['success' => false, 'msg' => '檔案過大'];

    // 2. 真實 MIME 驗證(finfo)
    $finfo = new finfo(FILEINFO_MIME_TYPE);
    $mime = $finfo->file($tmp);
    if (!in_array($mime, $allowedMimes, true)) {
        return ['success' => false, 'msg' => '檔案類型不允許'];
    }

    // 3. 副檔名白名單對應
    $extMap = [
        'image/jpeg' => 'jpg',
        'image/png'  => 'png',
        'image/gif'  => 'gif',
        'application/pdf' => 'pdf',
    ];
    $ext = $extMap[$mime] ?? 'bin';
    if (!in_array($ext, $allowedExts, true)) {
        return ['success' => false, 'msg' => '副檔名不允許'];
    }

    // 4. 隨機檔名 + 固定目錄
    $filename = bin2hex(random_bytes(16)) . '.' . $ext;
    $dest = rtrim($saveDir, '/') . '/' . $filename;

    // 5. 移動檔案
    if (!move_uploaded_file($tmp, $dest)) {
        return ['success' => false, 'msg' => '儲存失敗'];
    }

    // 6. 設定檔案權限(僅擁有者可讀寫)
    chmod($dest, 0600);

    return ['success' => true, 'path' => $dest, 'filename' => $filename, 'mime' => $mime];
}

// 使用範例
$result = secure_upload('avatar',
    ['image/jpeg', 'image/png', 'image/gif'],
    ['jpg', 'png', 'gif'],
    '/data/uploads/avatars/'
);

常見誤區與釐清

誤區事實
檢查 `$_FILES['type']` 就夠了Client 可任意偽造,必須用 `finfo`/`getimagesize` 驗證檔案內容
檔名過濾特殊字元就安全黑名單永遠不完整,唯有「隨機重命名」徹底解決
上傳目錄設 777 才能寫入目錄 755 + PHP-FPM 以網站使用者身分執行即可寫入,777 極度危險
只驗證副檔名Apache/Nginx 可能解析雙副檔名,需配合「不可執行」設定

進階加強建議

  • 病毒掃描:整合 ClamAV 掃描上傳檔案(`clamscan /path/to/file`)。
  • 圖片二次渲染:使用 GD/Imagick 重新壓縮儲存,徹底剝離潛在惡意代碼(Polyglot 攻擊)。
  • 存取控制:下載時驗證權限,輸出時設定 `Content-Disposition: attachment` 強制下載而非瀏覽器直接開啟。
  • 審計日誌:記錄上傳者、IP、檔案雜湊、時間,支援事後追溯。

「權限隔離」解決執行風險,「白名單重命名」解決寫入風險,兩者缺一不可。將此流程封裝為專案共用 Library,納入 CI 檢查,才能讓上傳功能真正安全落地。

copyright © 萬盛學電腦網 all rights reserved