SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-17

مقایسه FileBrowser، Filestash، SFTPGo و Cloud Commander

FileBrowser، Filestash، SFTPGo و Cloud Commander را از نظر محدودسازی مسیر، لینک اشتراک، backend ذخیره‌سازی و احراز هویت مقایسه کنید و اجرای امن بدون خطر برای فایل‌ها را بیاموزید.

مدیریت فایل self-hosted چیست و چه چیزی نیست

مدیریت فایل self-hosted یک صفحهٔ وب روی درخت پوشه‌ای است که از قبل روی VPS (virtual private server) شما وجود دارد. وارد سیستم می‌شوید و /srv/files را دقیقاً همان‌طور که روی دیسک قرار دارد می‌بینید؛ سپس می‌توانید فایل را upload، rename یا download کنید یا لینکی برای فرد دیگری بفرستید. هیچ چیزی در سیستم دومی کپی نمی‌شود؛ بنابراین فایلی که در مرورگر قرار می‌دهید، یک ثانیه بعد همان فایلی است که ls نشان می‌دهد.

نتایج جست‌وجو این مفهوم را با نرم‌افزارهایی که وظایف دیگری انجام می‌دهند درهم می‌آمیزند. ابزارهای sync یک نسخه از هر فایل را روی هر دستگاه نگه می‌دارند؛ این همان کاری است که یک جایگزین self-hosted برای Dropbox انجام می‌دهد. Object storage بر پایهٔ bucketها و API ساخته شده است، نه یک پوشه روی دیسک شما؛ بنابراین راه‌اندازی MinIO برای object storage سازگار با S3 به مسئلهٔ متفاوتی پاسخ می‌دهد. پنل‌های مدیریت سرور خود ماشین را مدیریت می‌کنند، نه فایل‌ها را؛ موضوع مقایسهٔ Cockpit و Webmin نیز همین است.

وقتی یک همکار به یک archive با حجم 300 MB از روی سرور نیاز دارد، یا می‌خواهید اشتباه تایپی یک فایل config را با تلفن اصلاح کنید، به مدیریت فایل نیاز دارید. کار کوچک است و ابزارها نیز ساده‌اند.

هنگام مطالعه، یک واقعیت را در نظر داشته باشید. این یک web application با دسترسی خواندن و نوشتن به filesystem شماست که روی یک پورت گوش می‌دهد. هر انتخاب در ادامه، در واقع انتخابی دربارهٔ میزان دسترسی آن process به دیسک شماست.

پروژه FileBrowser آرشیو شده است؛ پیش از نصب این مطلب را بخوانید

FileBrowser، همان پروژه filebrowser/filebrowser، پاسخی است که اکثر راهنماها هنوز آن را پیشنهاد می‌دهند. فایل README این پروژه اکنون با این اطلاعیه آغاز می‌شود:

پروژه File Browser در تاریخ 2026-09-01 آرشیو شد. آخرین نسخه برنامه‌ریزی‌شده منتشر شده است. هیچ نسخه، رفع باگ یا وصله امنیتی دیگری برای آن ارائه نخواهد شد.

کد با مجوز Apache 2.0 همچنان کار می‌کند، اما وصله‌های امنیتی متوقف شده‌اند. این موضوع در این دسته‌بندی نرم‌افزاری اهمیت بیشتری نسبت به سایر موارد دارد، زیرا هدف اصلی این نرم‌افزار، فراهم کردن دسترسی نوشتن روی سیستم فایل از طریق HTTP است.

نگهدارندگان پروژه دستورالعملی برای نحوه ادامه استفاده از آن نوشته‌اند که توصیه‌هایش برای هر ابزاری که انتخاب می‌کنید ارزشمند است: آن را مستقیماً در معرض اینترنت قرار ندهید، آن را پشت یک reverse proxy قرار دهید که TLS (امنیت لایه انتقال) را مدیریت کرده و احراز هویت اختصاصی خود را انجام می‌دهد، قابلیت اجرای دستور (command runner) را غیرفعال کنید و آن را با دسترسی محدود (unprivileged) در یک container اجرا کنید که فقط دایرکتوری مورد نظر شما برای اشتراک‌گذاری در آن mount شده باشد.

یک خط در آن README از بقیه مهم‌تر است. نشست‌ها (Sessions) به صورت JWT (توکن‌های وب JSON) خودکفا هستند و نه شناسه‌های سمت سرور، بنابراین امکان ابطال آن‌ها وجود ندارد. توکن نشست لو رفته تا زمان انقضا معتبر باقی می‌ماند و تغییر رمز عبور نیز باعث ابطال آن نمی‌شود. اگر همچنان از FileBrowser استفاده می‌کنید، لایه احراز هویتی که در مقابل آن قرار داده‌اید، وظیفه اصلی امنیت را بر عهده دارد.

FileBrowser Quantum: فورکی که هنوز توسعه می‌یابد

توسعه فعال به یک fork با نام FileBrowser Quantum (gtsteffaniak/filebrowser) منتقل شده است. این پروژه به‌صورت image با نام gtstef/filebrowser در Docker Hub و با نام ghcr.io/gtsteffaniak/filebrowser در registry گیت‌هاب منتشر می‌شود. پیکربندی آن به‌جای ترکیب قدیمی flagهای خط فرمان و تنظیمات پایگاه داده، بر یک config.yaml واحد بازطراحی شده است. نمونهٔ quick try مستندشده:

docker run -d \
  -v $(pwd):/srv \
  -p 80:80 \
  ghcr.io/gtsteffaniak/filebrowser:stable

این دستور دایرکتوری فعلی را در http://localhost ارائه می‌کند. از نسخه 2.0.0، ورود نخست دیگر با admin / admin انجام نمی‌شود. مگر آن‌که adminPassword را در configuration روی مقداری غیر از admin تنظیم کنید، container یک گذرواژه تصادفی برای مدیر تولید می‌کند و آن را فقط یک‌بار در log می‌نویسد. بنابراین آن را با docker logs بخوانید. همچنین در نخستین ورود، reset گذرواژه الزامی است. پیش از آن‌که container از هر جایی غیر از سیستم خودتان قابل دسترسی شود، این reset را کامل کنید.

برای نمونه‌ای که قرار است نگه‌داری کنید، از Compose استفاده کنید، به‌جای یک فایل پایگاه داده، directory داده را mount کنید و port را به localhost bind کنید:

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    user: "1000:1000"
    volumes:
      - /srv/files:/folder
      - ./data:/home/filebrowser/data
    ports:
      - 127.0.0.1:8080:80
    restart: unless-stopped

configuration در /home/filebrowser/data/config.yaml و پایگاه داده در /home/filebrowser/data/database.sqlite قرار دارد. نسخه 2.0.0 قالب پایگاه داده را تغییر داده و یک migration یک‌باره انجام می‌دهد. به همین دلیل مستندات mount کردن یک directory را توصیه می‌کنند: mount کردن یک فایل منفرد، جایی برای قرار دادن فایل جدید در اختیار migration نمی‌گذارد. مسیرهای داخل config.yaml، مسیرهای container هستند. بنابراین یک source در configuration به /folder اشاره می‌کند، نه /srv/files. اشتباه گرفتن این دو مسیر، فهرست فایل خالی و بدون خطا ایجاد می‌کند؛ چون آن directory واقعاً وجود ندارد.

این پروژه latest و stable را با حجمی حدود 60 MB و همراه با FFmpeg و preview اسناد، و stable-slim را با حجمی حدود 15 MB و فقط با هستهٔ اصلی منتشر می‌کند. این ارقام مربوط به صفحهٔ نصب در اکتبر 2026 هستند. tag انتخابی خود را pin کنید. latest بدون اطلاع شما تغییر می‌کند و file managerی که قالب configuration خود را هنگام اجرای container تغییر دهد، انتخاب مناسبی نیست.

برای این کاربرد، این ابزار در میان ابزارهای کوچک قوی‌ترین گزینه است. چندین source را با ruleهای include و exclude ارائه می‌کند؛ بنابراین یک instance می‌تواند /srv/media و /srv/docs را با scopeهای متفاوت در معرض دسترسی قرار دهد. Shareها زمان انقضا دارند و می‌توانند anonymous یا محدود به یک user باشند. احراز هویت شامل OIDC (OpenID Connect)، LDAP (lightweight directory access protocol)، گذرواژه همراه با احراز هویت دومرحله‌ای و حالت proxy header است. همین حالت proxy امکان می‌دهد سرویس پشت single sign-on (SSO) مربوط به یک سرور Authentik با میزبانی شخصی قرار گیرد، بدون آن‌که فهرست دومی از userها نگه‌داری کند.

Filestash: یک رابط واحد برای storage موجود شما

Filestash ساختار متفاوتی دارد. این برنامه یک front end است که به یک backend متصل می‌شود و فهرست backendهای آن طولانی است: FTP، SFTP (پروتکل انتقال فایل SSH)، S3، SMB، WebDAV، IPFS و حدود بیست گزینهٔ دیگر. زمانی مناسب است که فایل‌ها روی سروری نباشند که interface را اجرا می‌کند.

mkdir -p /srv/filestash && cd /srv/filestash
curl -O https://downloads.filestash.app/latest/docker-compose.yml
docker compose up -d

تصویر مربوط به machines/filestash:latest است. http://your_domain:8334 را باز کنید تا در صفحهٔ نخست، رمز عبور admin تنظیم شود. این کار را فوراً انجام دهید، زیرا تا پیش از آن، کنسول admin برای هر کسی که پورت را پیدا کند باز است.

پیش از آن‌که بر مبنای این برنامه طراحی کنید، مدل هویت آن را بشناسید. Filestash به‌طور پیش‌فرض پایگاه دادهٔ کاربران را به معنای معمول نگه نمی‌دارد. اعتبارنامه‌ها از طریق cookieهای رمزنگاری‌شده، احرازشده و HTTP-only در مرورگر شما ذخیره می‌شوند و چیزی در سمت سرور نگه‌داری نمی‌شود؛ مگر آن‌که از قابلیت share استفاده کنید. در این حالت، Filestash نسخه‌ای رمزنگاری‌شده و پایدار از اعتبارنامه‌های شما را نگه می‌دارد. در این تنظیم پیش‌فرض، «کاربران» همان حساب‌های storage هستند: هویت در backend، یعنی در حساب SFTP یا کلید S3، قرار دارد، نه در Filestash. این تنها گزینه نیست. افزونهٔ plg_authenticate_local که در مخزن open source ارائه می‌شود، Filestash را به identity provider تبدیل می‌کند و صفحه‌ای برای مدیریت کاربران در اختیار می‌گذارد.

این طراحی ساده است، اما هزینه دارد. صفحهٔ pricing، tier رایگان self-hosted را AGPL v3 (مجوز عمومی همگانی GNU Affero) با حداکثر 3 کاربر معرفی می‌کند و SSO (SAML، OIDC و LDAP) را همراه با role based access control در tier پولی self-hosted، با قیمت از $50 در ماه، as of October 2026 ارائه می‌دهد. اگر برنامهٔ شما «استفادهٔ رایگان از Filestash در برابر SSO شرکت» است، پیش از طراحی بر اساس آن، همان صفحه را بررسی کنید.

SFTPGo: یک سرور پروتکل که رابط کاربری وب نیز دارد

SFTPGo توانمندترین نرم‌افزار در این لیست است و اغلب به دلایل اشتباه توصیه می‌شود. این نرم‌افزار سرویس‌های SFTP، HTTP/S، FTP/S و WebDAV را بر بستر فایل‌سیستم محلی، فایل‌سیستم محلی رمزنگاری‌شده، فضای ذخیره‌سازی شیء (Object Storage) سازگار با S3، Google Cloud Storage، Azure Blob Storage یا یک سرور SFTP دیگر ارائه می‌دهد.

فایل‌های باینری، بسته‌های Debian و Ubuntu و یک ایمیج کانتینر برای آن منتشر شده است. خط مخزن APT فعلی و کلید امضای آن در صفحه نصب در مستندات SFTPGo موجود است. روش کانتینر سریع‌ترین راه برای راه‌اندازی آن است؛ کافی است tag را با نسخه مورد نظر خود جایگزین کنید:

docker run --name some-sftpgo -p 8080:8080 -p 2022:2022 -d "drakkan/sftpgo:tag"

سرویس SFTP روی پورت 2022 و رابط‌های وب روی پورت 8080 گوش می‌دهند. مسیر /srv/sftpgo را به عنوان یک volume مانت کنید، در غیر این صورت با بازسازی کانتینر، حساب‌های کاربری و فایل‌های آن‌ها از بین می‌روند، زیرا دایرکتوری‌های خانگی کاربران به‌صورت پیش‌فرض در /srv/sftpgo/data/<username> قرار دارند.

دو رابط وب وجود دارد و تفاوت آن‌ها بخشی است که اکثر راهنماها به آن اشاره نمی‌کنند. WebAdmin در آدرس /web/admin، بخش مدیریتی است: جایی که کاربران، گروه‌ها، پوشه‌های مجازی و قوانین رویدادها را ایجاد می‌کنید و سهمیه‌ها (Quotas)، محدودیت‌های پهنای باند و محدودیت‌های زمانی دسترسی را تنظیم می‌کنید. WebClient در آدرس /web/client، نمای کاربر نهایی است که در آن شخص فایل‌ها را مرور می‌کند، اعتبارنامه‌های خود را تغییر می‌دهد، احراز هویت دو مرحله‌ای را فعال می‌کند و اشتراک‌گذاری ایجاد می‌کند.

آن اشتراک‌گذاری‌ها بهترین نمونه در این مقایسه هستند. یک کاربر می‌تواند لینک‌های HTTP/S برای اشتراک‌گذاری فایل‌ها و پوشه‌ها ایجاد کند، تعداد دانلودها و آپلودها را محدود کند، اشتراک‌گذاری را با رمز عبور محافظت کند، دسترسی را بر اساس IP مبدأ محدود کند و تاریخ انقضای خودکار تعیین کند.

پس چرا باید محتاط بود؟ مرکز ثقل این نرم‌افزار، مدل حساب کاربری و سرور پروتکل است، نه تجربه مرور فایل‌ها. زمانی SFTPGo را انتخاب کنید که افراد دیگر نیاز به حساب‌های واقعی با سهمیه داشته باشند، زمانی که آپلودها از طریق SFTP یا FTPS از سیستمی که شما کنترل نمی‌کنید ارسال می‌شوند، یا زمانی که یک bucket باید در دایرکتوری خانگی چندین کاربر ظاهر شود. پوشه‌های مجازی (Virtual folders) مورد آخر را انجام می‌دهند: پوشه‌ای که توسط دیسک محلی، S3، GCS، Azure Blob، SFTP یا HTTP پشتیبانی می‌شود و در چندین حساب کاربری مانت می‌شود، با سهمیه جداگانه برای هر کاربر روی یک پوشه مشترک. اگر تنها چیزی که می‌خواستید یک صفحه قابل مرور روی /srv/files بود، این حجم از ابزارها برای آن کار بیش از حد است.

دو نکته دیگر که دانستن آن‌ها مفید است: نسخه Community فقط تحت مجوز AGPL-3.0 با شرایط اضافی است و در کنار آن یک نسخه Enterprise با مجوز تجاری وجود دارد. ورود با OIDC در نسخه متن‌باز موجود است و کاربران ارائه‌دهنده هویت را به مدیران و کاربران SFTPGo برای هر دو رابط وب نگاشت می‌کند. همچنین می‌توانید رابط کاربری کلاینت را به‌صورت سراسری با enable_web_client در فایل پیکربندی httpd غیرفعال کنید، یا برای هر کاربر با افزودن HTTP به پروتکل‌های مسدودشده آن کاربر، این کار را انجام دهید تا مدیریت فایل برای یک شخص فعال باشد و برای همه در دسترس نباشد.

Cloud Commander: دو پنل و یک کنسول، برای یک کاربر

Cloud Commander یک مدیر Node.js با مجوز MIT و سبک دوپنله است که ویرایشگر و کنسول داخلی دارد. ترمینال به‌صورت یک گزینه وجود دارد، اما به‌طور پیش‌فرض غیرفعال است و نصب نمی‌شود: برای فعال‌شدن، به بستهٔ جداگانهٔ gritty (npm i gritty -g) و گزینه‌های --terminal و --terminal-path نیاز دارد. خود Cloud Commander را با npm i cloudcmd -g به‌صورت سراسری نصب کنید، یا container منتشرشده را اجرا کنید:

docker run -it --rm -v ~:/root -v /:/mnt/fs -w=/root -p 8000:8000 coderaiser/cloudcmd

پیش از اجرای این command آن را با دقت بخوانید. -v /:/mnt/fs کل فایل‌سیستم host را داخل container mount می‌کند و نمونهٔ ~/.cloudcmd.json، "root": "/"، "auth": false و "console": true را فعال می‌کند. نتیجه این است که هر کسی که به پورت 8000 دسترسی داشته باشد، به کل دیسک شما و یک command console روی server دسترسی خواهد داشت. این تنظیم برای یک laptop پیش‌فرض مناسبی است، اما برای یک VPS انتخاب نامناسبی محسوب می‌شود.

محدودهٔ دسترسی را کاهش دهید. container فایل /root/.cloudcmd.json را می‌خواند و command منتشرشده با mount کردن home directory آن را در اختیار container قرار می‌دهد؛ بنابراین mount مربوط به configuration را نگه دارید و بقیه را حذف کنید:

docker run -d --name cloudcmd \
  -v ~/.cloudcmd.json:/root/.cloudcmd.json \
  -v /srv/files:/srv/files \
  -w=/srv/files \
  -p 127.0.0.1:8000:8000 \
  coderaiser/cloudcmd

در آن فایل configuration، "root" را روی /srv/files، "auth" را با استفاده از "username" و "password" روی true تنظیم کنید (این فایل password را به‌صورت hash، نه متن ساده، ذخیره می‌کند) و "console" را روی false قرار دهید، مگر آن‌که واقعاً به دسترسی shell از طریق browser نیاز داشته باشید. "terminal" را روی مقدار پیش‌فرض false باقی بگذارید و به همان دلیل از نصب gritty صرف‌نظر کنید. معادل‌های command line نیز وجود دارند، از جمله --root، --auth، --username، --password و --prefix.

دربارهٔ قابلیت‌های آن واقع‌بین باشید. فقط یک جفت credential وجود دارد؛ تفکیک دسترسی برای هر کاربر، quota و share link وجود ندارد. این ابزار شخصی است؛ بنابراین همان‌طور که در بالا گفته شد، آن را روی localhost bind کنید و از طریق tunnel به آن دسترسی داشته باشید:

ssh -L 8000:127.0.0.1:8000 you@your-vps

سپس در machine خودتان http://127.0.0.1:8000 را باز کنید. file manager هرگز به‌صورت عمومی در معرض اینترنت قرار نمی‌گیرد و تنها چیزی که در برابر اینترنت قرار دارد، SSH daemonای است که از قبل روی VPS خود harden کرده‌اید.

چرا Nextcloud ابزار اشتباهی برای این کار خاص است

Nextcloud نرم‌افزار خوبی است، اما برای این هدف طراحی نشده است. این یک پلتفرم همکاری است: یک برنامه PHP، یک پایگاه داده، کارهای پس‌زمینه (background jobs)، کلاینت‌های همگام‌سازی دسکتاپ و یک فروشگاه اپلیکیشن. اجرای آن صرفاً برای داشتن یک نمای وب از /srv/files، به دلیل اجزای متحرک زیاد، برای یک کار کوچک مناسب نیست و یک عدم تطابق مشخص وجود دارد. Nextcloud متادیتای فایل‌ها را در یک جدول پایگاه داده نگه می‌دارد، نه اینکه در هر درخواست دایرکتوری را بخواند؛ بنابراین فایل‌هایی که توسط rsync یا یک cron job نوشته می‌شوند، تا زمانی که اسکن بعدی انجام نشود، در رابط کاربری دیده نمی‌شوند، مگر با استفاده از sudo -u www-data php occ files:scan --all. یک مدیر فایل (file manager) در هر بار بارگذاری صفحه، دایرکتوری را لیست می‌کند، بنابراین چنین شکافی وجود ندارد.

Nextcloud را برای کارهایی که در آن‌ها عملکرد خوبی دارد حفظ کنید: تقویم‌ها، مخاطبین، همگام‌سازی و اشتراک‌گذاری با افرادی که انتظار کلاینت دسکتاپ دارند. Nextcloud روی یک VPS با Docker، TLS و پشتیبان‌گیری این پیکربندی را پوشش می‌دهد. اگر در حال حاضر آن را اجرا می‌کنید و فقط نیاز دارید یک دایرکتوری موجود را مشاهده کنید، اپلیکیشن External Storage را فعال کنید و کار را همان‌جا متوقف کنید. یک اپلیکیشن وب دوم با دسترسی نوشتن روی همان دیسک، یک مورد اضافه برای وصله‌کردن (patch) است.

نحوه اجرای یک سرویس بدون در معرض خطر قرار دادن کل سرور

هرگز آن را به / اشاره ندهید. این پردازش می‌تواند تمام فایل‌هایی که حساب کاربری‌اش به آن‌ها دسترسی دارد را بخواند و بنویسد؛ بنابراین، یک توکن نشست (session token) سرقت‌شده، دقیقاً به همان میزان دسترسی به فایل‌سیستم را برای مهاجم فراهم می‌کند. تنها یک دایرکتوری، یعنی /srv/files را سرو کنید و آن را صرفاً برای همین منظور ایجاد کنید.

سرویس را با یک کاربر غیر-root اجرا کنید و فقط آنچه را که باید سرو شود، mount کنید. در Compose، این کار با user: "1000:1000" و یک bind mount برای هر دایرکتوری انجام می‌شود؛ همچنین برای هر فایلی که نیازی به نوشتن در آن نیست، از :ro استفاده کنید:

    volumes:
      - /srv/files:/folder
      - /srv/media:/media:ro

نتیجه معمول این تغییر آن است که مرور فایل‌ها کار می‌کند اما آپلودها با خطای permission denied مواجه می‌شوند، زیرا شناسه کاربری (UID) داخل کانتینر مالک دایرکتوری در خارج از آن نیست. این دو را مقایسه کنید: docker exec filebrowser id کاربر کانتینر را چاپ می‌کند و ls -ln /srv/files مالک عددی فایل در میزبان (host) را نشان می‌دهد. مشکل را با sudo chown -R 1000:1000 /srv/files برطرف کنید. این همان مشکل مالکیتی است که PUID و PGID در ایمیج‌های Docker برای حل آن وجود دارند.

پورت منتشرشده را به localhost متصل کنید، یعنی 127.0.0.1:8080:80 به جای 8080:80. داکر قوانین netfilter خود را پیش از قوانین ufw اعمال می‌کند، بنابراین یک پورت که به سادگی منتشر شده باشد، حتی زمانی که ufw deny 8080 فعال است، از اینترنت قابل دسترسی باقی می‌ماند. برای TLS، یک reverse proxy در مقابل آن قرار دهید. در پروتکل HTTP ساده، کوکی نشست به‌صورت متن آشکار در شبکه جابه‌جا می‌شود و آن کوکی در واقع همان دسترسی به فایل‌سیستم است. اگر با Compose آشنا نیستید، Docker Compose روی VPS ساختار فایلی که این قطعه‌کدها فرض می‌کنند را توضیح می‌دهد.

زمانی که مکانیزم احراز هویت خودِ برنامه ضعیف است، یک لایه احراز هویت اضافه کنید. برای یک نمونه تک‌کاربره، HTTP basic auth در سطح پروکسی کافی است. هنگامی که بیش از یک نفر درگیر است، از OIDC یا forward auth در برابر یک identity provider استفاده کنید تا با ابطال یک حساب، دسترسی در همه جا لغو شود.

قابلیت‌های اضافی را غیرفعال کنید. هر مدیر فایلی که shell، اجرای دستور یا ترمینال درون‌مرورگری ارائه می‌دهد، در واقع امکان اجرای کد از راه دور (RCE) را برای هر کسی که یک نشست معتبر داشته باشد، فراهم می‌کند. توصیه خودِ FileBrowser این است که command runner را غیرفعال نگه دارید و نمونه پیکربندی Cloud Commander نیز کنسول را فعال می‌کند. آگاهانه تصمیم بگیرید، نه بر اساس تنظیمات پیش‌فرض.

چه چیزی زودتر از کار می‌افتد و چه خطاهایی خواهید دید

listen tcp :80: bind: permission denied. Linux پورت‌های کمتر از 1024 را privileged در نظر می‌گیرد: bind کردن چنین پورتی به root، قابلیت CAP_NET_BIND_SERVICE یا net.ipv4.ip_unprivileged_port_start کاهش‌یافته نیاز دارد. پیکربندی مستند FileBrowser Quantum از پورت 80 استفاده می‌کند. این حالت معمولاً داخل container و روی یک Docker engine استاندارد rootful کار می‌کند، چون این engine همچنان آن capability را به container می‌دهد. وقتی کاربر بدون privileged بودن، binary را مستقیماً روی host اجرا می‌کند، این روش شکست می‌خورد و ممکن است در rootless Docker یا با profile محدودتر capability نیز کار نکند. در config.yaml پورتی بالاتر از 1024 تنظیم کنید و مالکیت 443 را به proxy بسپارید.

هنگام مرور فایل‌ها مشکلی وجود ندارد، اما uploadها شکست می‌خورند. فهرست‌کردن یک directory به r-x نیاز دارد و نوشتن در آن به w. رابط وب یک خطای عمومی نمایش می‌دهد؛ بنابراین ابتدا filesystem را بررسی کنید، نه logهای application را.

413 Request Entity Too Large. این خطا معمولاً از چیزی در جلوی file manager ایجاد می‌شود، نه از خود file manager. ابتدا nginx را بررسی کنید. مقدار پیش‌فرض client_max_body_size برابر با 1 MB است؛ بنابراین upload بزرگ‌تر در proxy رد می‌شود، پیش از آن‌که application اصلاً درخواست را ببیند. مقدار client_max_body_size 4096m; را در block مربوط به server تنظیم کنید، یا برای غیرفعال‌کردن بررسی از 0 استفاده کنید. اگر domain از طریق Cloudflare proxy شده باشد، Cloudflare نیز وقتی request از حداکثر اندازه upload در zone بیشتر شود، همین خطای 413 را برمی‌گرداند. مستندات Cloudflare این مقدار را تا اکتبر 2026 برای planهای Free و Pro برابر با 100 MB اعلام می‌کنند. افزایش limit در nginx در این وضعیت کمکی نمی‌کند؛ بنابراین uploadهای بزرگ به routeای نیاز دارند که از Cloudflare proxy عبور نکند.

گروه فایل‌های upload‌شده نادرست است. مالک فایل‌های جدید همان user مربوط به process است، صرف‌نظر از تنظیمات directory والد؛ این وضعیت باعث می‌شود سرویس دوم نتواند همان tree را بخواند. برای هر دو سرویس یک shared group ایجاد کنید و با sudo chmod g+s /srv/files، bit مربوط به setgid را روی directory تنظیم کنید تا فایل‌های جدید group مربوط به directory را به ارث ببرند.

همه‌چیز روی port کار می‌کند، اما پشت proxy از کار می‌افتد. applicationای که زیر یک subpath ارائه می‌شود، linkها را بر اساس prefixای می‌سازد که باید آن را به application اعلام کنید. Cloud Commander برای این کار --prefix را دارد. اگر چنین گزینه‌ای وجود نداشت، برای application یک subdomain مستقل ایجاد کنید و root path را به آن proxy کنید.

کدام مدیر فایل self-hosted را باید اجرا کنید؟

  • یک VPS، یک یا دو دایرکتوری، لینک‌های اشتراکی با تاریخ انقضا و احتمالاً SSO در آینده: FileBrowser Quantum.
  • فایل‌هایی که در جای دیگری قرار دارند، مانند یک bucket در S3، یک میزبان SFTP یا یک NAS از طریق SMB، و می‌خواهید یک نمای وب یکپارچه روی همه آن‌ها داشته باشید: Filestash، در چارچوب محدودیت‌های tier رایگان.
  • افراد دیگری به حساب کاربری، quota و امکان upload از طریق SFTP یا FTPS نیاز دارند: SFTPGo؛ در این حالت، web client را یک قابلیت جانبی مفید در نظر بگیرید، نه دلیل اصلی انتخاب نرم‌افزار.
  • یک ابزار شخصی با editor و console که از طریق SSH tunnel به آن دسترسی دارید و هرگز آن را public نمی‌کنید: Cloud Commander.
  • Nextcloud از قبل در حال اجراست و یک دایرکتوری موجود برای expose کردن دارید: اپلیکیشن External Storage؛ بدون نصب هیچ نرم‌افزار جدیدی.

صرف‌نظر از انتخاب شما، نحوه deployment از خود انتخاب مهم‌تر است. یک دایرکتوری، یک کاربر non-root، یک پورت که به localhost bind شده باشد و authentication در جلوی آن. مدیر فایلی که به این شکل راه‌اندازی شود، یک ابزار convenience است. همان نرم‌افزار، اگر به / اشاره کند و از یک shared password استفاده کند، در عمل یک remote shell با یک رابط کاربری مناسب است.

FAQ

آیا اجرای FileBrowser در 2026 همچنان امن است؟

README بالادستی filebrowser/filebrowser اعلام می‌کند که File Browser در تاریخ 2026-09-01 بایگانی شده و دیگر release، رفع اشکال یا اصلاحیه امنیتی نخواهد داشت. کد همچنان اجرا می‌شود، اما نرم‌افزار بدون patch که به فایل‌سیستم شما دسترسی نوشتن دارد، با گذشت زمان خطرناک‌تر می‌شود. اگر آن را نگه می‌دارید، توصیه‌های خود پروژه را رعایت کنید: آن را مستقیماً در معرض اینترنت قرار ندهید، از reverse proxy برای TLS و احراز هویت مستقل استفاده کنید، command runner را غیرفعال نگه دارید و از یک container بدون دسترسی‌های privileged استفاده کنید که فقط دایرکتوری ارائه‌شده را mount کرده باشد. توجه کنید که sessionهای آن JWTهای مستقل هستند، نه شناسه‌های نگهداری‌شده در سمت سرور؛ بنابراین امکان revoke کردن آن‌ها وجود ندارد و تغییر password نیز token صادرشده را نامعتبر نمی‌کند. برای نصب جدید، از fork با نام FileBrowser Quantum استفاده کنید که با image با نام gtstef/filebrowser منتشر شده و توسعه آن ادامه دارد.

آیا یک file manager خودمیزبان می‌تواند از SSO موجود من استفاده کند؟

FileBrowser Quantum از OIDC، LDAP و حالت proxy header پشتیبانی می‌کند؛ بنابراین می‌تواند پشت یک identity provider موجود قرار بگیرد و به فهرست کاربران جداگانه نیاز نداشته باشد. یکپارچه‌سازی OpenID Connect در SFTPGo در build متن‌باز آن وجود دارد و کاربران identity provider را برای هر دو رابط WebAdmin و WebClient به مدیران و کاربران SFTPGo نگاشت می‌کند. Filestash موردی است که باید به آن توجه کنید: صفحه قیمت‌گذاری آن، SSO شامل SAML، OIDC و LDAP را از October 2026 در tier پولی self-hosted با قیمت $50 در ماه قرار داده است؛ در حالی که tier رایگان به‌صورت AGPL v3 با حداکثر 3 کاربر فهرست شده است. اگر یک application اصلاً از SSO پشتیبانی نکند، راهکار جایگزین، forward authentication در reverse proxy است. این روش از صفحه ورود محافظت می‌کند، اما permissionهای داخلی application را تغییر نمی‌دهد.

SFTPGo کامل‌ترین پیاده‌سازی را دارد. کاربر از WebClient یک link از نوع HTTP/S ایجاد می‌کند و می‌تواند تعداد download و upload را محدود کند، برای آن password تعیین کند، دسترسی را بر اساس source IP address محدود کند و تاریخ انقضای خودکار تعیین کند. FileBrowser Quantum از shareهایی با زمان انقضا پشتیبانی می‌کند. دسترسی به این shareها می‌تواند anonymous باشد یا به یک کاربر محدود شود و برای هر share نیز permissionهای جداگانه برای مشاهده، ویرایش و upload وجود دارد. Filestash نیز قابلیت share دارد و تنها موردی است که سرور یک نسخه رمزگذاری‌شده و پایدار از credentialهای storage را نگه می‌دارد؛ زیرا link باید پس از پایان session مرورگر شما نیز کار کند. Cloud Commander اصلاً share link ندارد.

آیا اگر تنها کاربر هستم، اشاره‌کردن یک file manager به / امن است؟

خیر، و خطر واقعاً به اعتمادکردن به خودتان مربوط نیست. process به تمام چیزهایی که account کاربر آن می‌تواند به آن‌ها دسترسی داشته باشد، مجوز read و write دارد. بنابراین هر مسیری به آن session، یک cookie سرقت‌شده، یک bug اصلاح‌نشده در upload handler یا یک password استفاده‌شده در جای دیگر، به دسترسی به /etc، کلیدهای SSH شما و data directory تمام serviceها تبدیل می‌شود. mount را فقط به یک دایرکتوری محدود کنید: /srv/files به‌جای /. این مشکل در Cloud Commander شدیدتر است، زیرا command منتشرشده Docker آن، root میزبان را در /mnt/fs mount می‌کند و sample config آن "root": "/" را با "auth": false تنظیم می‌کند. پیش از آن‌که این container روی چیزی به‌جز localhost گوش دهد، هر دو مورد را تغییر دهید.

آیا این مقاله مفید بود؟

#file-manager#filebrowser#sftpgo#self-hosting#storage