وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

آپلود فایل در Express و Multer روی هاست شکست می‌خورد

آموزش تشخیص مسیر موقت، مجوز، محدودیت حجم و نام فیلد آپلود فایل در Express و Multer.

انتشار:
توسط تیم فنی نت‌آرام
۶ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله آپلود فایل در Express و Multer روی هاست شکست می‌خورد در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
فرم آپلود در رایانه شما کار می‌کند اما روی هاست فایل ذخیره نمی‌شود، پاسخ ۵۰۰ می‌دهد یا req.file خالی است. مشکل می‌تواند از نوع فرم، نام فیلد، مسیر موقت، مجوز نوشتن یا محدودیت حجم درخواست باشد. ابتدا یک نمونه کوچک و محلی می‌سازیم تا معلوم شود کدام بخش با برنامه اصلی تفاوت دارد.
نمونه این مقاله برای آزمایش روی رایانه خودتان است و فایل را بعد از خواندن اندازه پاک می‌کند. مسیر و نام کاربر سرور هر شخص متفاوت است. فایل‌های مشتری را برای آزمون به محل عمومی منتقل نکنید و پیش از تغییر تنظیمات برنامه نسخه پشتیبان قابل بازگشت داشته باشید.

۱. فرم و درخواست را بررسی کنید

فرم HTML برای فایل باید enctype="multipart/form-data" داشته باشد. نام فیلد فایل باید با نامی که به single می‌دهید دقیقاً یکی باشد. برای مثال، فیلد name="file" با upload.single('file') هماهنگ است. اگر با fetch و FormData درخواست می‌فرستید، مرورگر باید مرز multipart را در هدر بسازد؛ معمولاً نباید Content-Type را دستی و بدون boundary تعیین کنید.
در ابزار Network مرورگر، وضعیت درخواست و پاسخ را ببینید. 413 معمولاً به محدودیت حجم در یکی از لایه‌ها اشاره می‌کند؛ خطای LIMIT_UNEXPECTED_FILE ممکن است به نام فیلد یا تعداد فایل مربوط باشد. کد دقیق برنامه و زمان را ثبت کنید، نه محتوا یا توکن نشست کاربر را.

۲. یک پروژه آزمایشی محلی آماده کنید

در ترمینال سیستم خود، داخل پوشه خالی و مخصوص آزمایش، پس از اطمینان از نصب Node.js و npm اجرا کنید:
کد / دستورnpm init -y npm install express multer node --version npm ls express multer
دو دستور نخست پروژه محلی و وابستگی‌ها را می‌سازند؛ در پوشه اصلی سایت فعال اجرا نکنید. دو دستور بعدی نسخه Node و بسته‌های نصب‌شده را نشان می‌دهند. در پروژه واقعی، نسخه‌های قفل‌شده و سازگاری نسخه Node و مستندات همان نسخه را بررسی کنید و برای رفع خطا بدون آزمون، بسته امنیتی را به نسخه قدیمی برنگردانید.

۳. نمونه محلی را اجرا کنید

در همان پوشه فایلی به نام upload-test.cjs بسازید. این مثال پوشه موقت مخصوص آزمایش ایجاد و فقط روی رابط محلی گوش می‌دهد:
کد / دستورconst express = require('express'); const multer = require('multer'); const fs = require('node:fs'); const os = require('node:os'); const path = require('node:path'); const app = express(); const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'upload-demo-')); const upload = multer({ dest: tempDir, limits: { fileSize: 5 * 1024 * 1024, files: 1, fields: 2 } }).single('file'); app.post('/upload', (req, res) => { upload(req, res, (err) => { if (err) return res.status(400).send('Upload failed: ' + (err.code || 'storage')); if (!req.file) return res.status(400).send('No file field'); const size = req.file.size; fs.unlink(req.file.path, (cleanupErr) => { if (cleanupErr) return res.status(500).send('Temporary cleanup failed'); res.json({ receivedBytes: size }); }); }); }); app.listen(3000, '127.0.0.1', () => console.log('Local test on 127.0.0.1:3000'));
با node upload-test.cjs آن را اجرا کنید. dest محل نوشتن موقت و limits سقف نمونه را تعیین می‌کنند. نام تصادفی فایل را Multer می‌سازد؛ نام ارسالی مشتری را مسیر ذخیره قرار ندهید. پس از پایان آزمایش با کلیدهای Ctrl+C برنامه را ببندید و پوشه خالی ساخته‌شده را پس از تشخیص نام دقیق آن در مسیر موقت خود حذف کنید.
در ترمینال دوم، یک فایل کوچک غیرحساس به نام sample.txt در پوشه آزمایش بسازید و اجرا کنید:
کد / دستورcurl -F 'file=@sample.txt' http://127.0.0.1:3000/upload
باید پاسخ JSON شامل تعداد بایت دریافت شود. اگر نام فیلد را عمداً به photo تغییر دهید، نمونه باید خطا بدهد؛ این مقایسه مشخص می‌کند نام فرم چه اثری دارد. فایل بزرگ‌تر از پنج مگابایت نیز باید با خطای محدودیت رد شود.

۴. تفاوت مسیر هاست را پیدا کنید

در برنامه واقعی مسیر موقت را با تنظیمات سرویس و مسیر خانگی مجاز حساب هماهنگ کنید. مسیر نسبی به پوشه کاری فرایند وابسته است؛ روی هاست ممکن است پوشه کاری با رایانه شما فرق کند. مسیر مطلق مجاز و خارج از پوشه عمومی، به همراه مالک و گروه درست، قابل اطمینان‌تر است. برای بررسی فقط‌خواندنی می‌توانید با دسترسی مجاز pwd و ls -ld /path/to/upload-temp را اجرا کنید.
پیام EACCES به مجوز، ENOENT به نبود مسیر یا یکی از والدها و ENOSPC به فضا یا منبع ذخیره اشاره می‌کند؛ سهمیه و inode نیز ممکن است نقش داشته باشند. در هاست اشتراکی خروجی بدون اطلاعات محرمانه را به پشتیبانی بدهید. تنظیم chmod 777 برای پوشه آپلود راه‌حل امنی نیست.
اگر آپلودهای کوچک موفق و فایل بزرگ ناموفق است، محدودیت برنامه و همچنین محدودیت وب‌سرور یا پراکسی جلوی آن را مقایسه کنید. ابتدا عدد هر لایه را پیدا کنید و فقط در محدوده نیاز واقعی افزایش دهید؛ سقف نداشتن می‌تواند منابع سرور را مصرف کند.

۵. پیش از استفاده واقعی امنیت را کامل کنید

نمونه محلی بالا عمداً احراز هویت ندارد و آماده انتشار عمومی نیست. در برنامه واقعی پیش از middleware آپلود، هویت و مجوز کاربر را بررسی کنید، نوع و اندازه قابل قبول را با توجه به کاربرد بسنجید و فایل را خارج از مسیر اجرای عمومی نگه دارید. نام و MIME ارسالی کاربر به تنهایی مدرک سالم‌بودن محتوا نیستند. برای فایل‌های مهم از بررسی بدافزار و سیاست نگهداری متناسب استفاده کنید.
برای شکست پردازش، قطع اتصال و خطای انتقال به محل نهایی، پاک‌سازی فایل موقت و ثبت خطای امن در برنامه طراحی و آزمایش شود. اگر چند نمونه برنامه یا کانتینر دارید، پوشه موقت یک نمونه الزاماً در دیگری دیده نمی‌شود؛ برای فایل دائمی از ذخیره‌سازی مناسب معماری خود استفاده کنید. پس از اصلاح، فایل کوچک، فایل بیش از حد مجاز و درخواست بدون ورود را جداگانه امتحان کنید.
اگر نصب بسته روی هاست پیدا نمی‌شود، راهنمای خطای یافت‌نشدن ماژول Node.js را ببینید. برای مشخصات هاست Node.js نت‌آرام و جزئیات نسخه‌های Multer، مستندات Express را بخوانید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام