کتابخانه‌ی استاندارد · شبکه

سرور اف‌تی‌پی ftpd

کارساز FTP و FTPS که یک پوشه را با ورود به سیستم، انتقال غیرفعال و TLS اختیاری پخش می‌کند.

واردسازی سرور اف‌تی‌پی

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

این بسته یک کارساز FTP به زبان سلام است. یک پوشه‌ی ریشه، یک کاربر و یک گذرواژه بدهید، گوش دادن و بعد خدمت را صدا بزنید، و هر کارخواه FTP می‌تواند پرونده‌های زیر آن پوشه را فهرست کند، بفرستد، بگیرد، تغییر نام بدهد و پاک کند. مسیرها درون ریشه بررسی می‌شوند، اما پیوند نمادینی که درون ریشه باشد و به جای دیگری اشاره کند دنبال می‌شود، پس پیوند را از پوشه‌ای که پخش می‌کنید دور نگه دارید. این بسته نیمه‌ی دیگر کارخواه اف‌تی‌پی (ftp) است و آن دو با هم کار می‌کنند.

FTP ساده و FTPS را پشتیبانی می‌کند. انتقال‌ها در حالت غیرفعال انجام می‌شوند (PASV و EPSV) روی بازه‌ی درگاهی که خودتان تعیین می‌کنید، پس آن بازه را در دیوار آتش باز کنید. ورود یا با یک کاربر و گذرواژه‌ی تنظیم‌شده است، یا با دسترسی ناشناس وقتی اجازه ناشناس روشن باشد؛ اگر هیچ‌کدام نباشد کسی نمی‌تواند وارد شود. با یک گواهی و یک کلید، کارساز FTPS آشکار (AUTH TLS و بعد PROT P برای اتصال داده) را هم می‌پذیرد و با تی‌ال‌اس ضمنی FTPS ضمنی را، که اتصال از همان بایت اول رمزگذاری شده است.

پیش از به‌کار بردن بدانید:

  • فقط یک کاربر هست. کاربر و گذرواژه یک حساب را توصیف می‌کنند؛ فهرست حساب‌ها، پوشه‌ی جدا برای هر کاربر و مجوزها در این بسته نیست.
  • کارخواه‌ها یکی پس از دیگری خدمت می‌گیرند. خدمت یک اتصال را تا آخر رسیدگی می‌کند و بعد اتصال بعدی را می‌پذیرد، پس برای یک صندوق تحویل کوچک یا کارسازی که فایل ساخته‌شده را پخش می‌کند مناسب است، نه برای یک کارساز عمومی شلوغ.
  • FTP ساده گذرواژه را بدون رمز می‌فرستد. تی‌ال‌اس فعال را با پرونده گواهی و پرونده کلید روشن کنید و اجبار تی‌ال‌اس را بگذارید تا کارساز تا پیش از رمزگذاری اتصال USER و PASS را رد کند. کارخواه باید پیش از فرستادن گذرواژه TLS را شروع کند؛ کارخواهی که آن را زودتر بفرستد گذرواژه را لو داده است، پس اجبار تی‌ال‌اس فقط از کارخواه‌های درست‌رفتار محافظت می‌کند.
  • درگاه ۰ یک درگاه آزاد برمی‌دارد و درگاه می‌گوید کدام را. نمونه‌ها و آزمون‌ها این‌طور بدون برخورد با چیز دیگری اجرا می‌شوند.

پوشه‌ای را با ورود به سیستم پخش کنید

با پیکربندی نو یک پیکربندی بسازید، ریشه، کاربر، گذرواژه و بازه‌ی درگاه غیرفعال را بگذارید، با جدید کارساز را بسازید و گوش دادن را صدا بزنید. وقتی درگاه اشغال است یا اجازه‌ی استفاده از آن را ندارید گوش دادن نادرست برمی‌گرداند؛ پیش از خدمت که تا توقف کارساز ادامه دارد، آن را بررسی کنید. درگاه‌های زیر ۱۰۲۴، از جمله ۲۱ معمول، در بیشتر سیستم‌ها دسترسی بیشتری می‌خواهند و برای همین نمونه ۲۱۲۱ را به کار می‌برد.

ftpd-serve-files.salam
واردسازی سرور اف‌تی‌پی
واردسازی محیط

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۲۱۲۱
    پیکربندی.ریشه = "/srv/ftp"
    پیکربندی.کاربر = "reports"
    پیکربندی.گذرواژه = محیط.دریافت("FTP_PASSWORD")
    اگر پیکربندی.گذرواژه.طول() برابر ۰:
        سرچاپ "ابتدا FTP_PASSWORD را بگذارید"
        برگشت ۱
    پایان
    پیکربندی.شروع غیرفعال = ۴۰۰۰۰
    پیکربندی.پایان غیرفعال = ۴۰۱۰۰
    ناپایا سرور := سرور اف‌تی‌پی.جدید(پیکربندی)
    اگر وارونه سرور اف‌تی‌پی.گوش دادن(سرور):
        سرچاپ "گوش دادن روی درگاه ممکن نشد"، پیکربندی.درگاه
        برگشت ۱
    پایان
    سرچاپ "پوشه"، پیکربندی.ریشه، "روی درگاه"، سرور اف‌تی‌پی.درگاه(سرور)، "در دسترس است"
    سرور اف‌تی‌پی.خدمت(سرور)
    سرور اف‌تی‌پی.بستن(سرور)
    برگشت ۰
پایان

نمونه روی نشانی خودی گوش می‌دهد و گذرواژه را از متغیر FTP_PASSWORD می‌خواند، پس گذرواژه‌ای که در صفحه نوشته شده باشد هیچ‌وقت برای دستگاه‌های دیگر باز نمی‌شود؛ FTP ساده نباید از دستگاه بیرون برود و برای آن از FTPS استفاده کنید. تا وقتی متوقف نشود ادامه می‌دهد، پس این‌جا فقط بررسی می‌شود. هر کارخواهی را به آن وصل کنید، مثلاً بسته‌ی اف‌تی‌پی (ftp) با اتصال و ورود و همان کاربر و گذرواژه.

اتصال را با FTPS رمزگذاری کنید

یک گواهی و یک کلید خصوصی در پرونده‌های PEM، TLS را روشن می‌کنند. کارخواه آن‌وقت اتصال را با AUTH TLS ارتقا می‌دهد و داده‌ی پرونده را با PROT P محافظت می‌کند. اجبار تی‌ال‌اس یک قدم جلوتر می‌رود و تا این کار انجام نشده USER و PASS را رد می‌کند، پس کارساز روی اتصال ساده اصلاً ورود را امتحان نمی‌کند، هرچند گذرواژه‌ای که یک کارخواه بدرفتار پیش‌تر فرستاده رفته است. با تی‌ال‌اس ضمنی کارساز از همان بایت اول TLS انتظار دارد؛ همان سبک قدیمی‌تر FTPS که درگاه خودش را دارد.

ftpd-ftps.salam
واردسازی سرور اف‌تی‌پی
واردسازی محیط

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    پیکربندی.درگاه = ۲۱۲۱
    پیکربندی.ریشه = "/srv/ftp"
    پیکربندی.کاربر = "reports"
    پیکربندی.گذرواژه = محیط.دریافت("FTP_PASSWORD")
    اگر پیکربندی.گذرواژه.طول() برابر ۰:
        سرچاپ "ابتدا FTP_PASSWORD را بگذارید"
        برگشت ۱
    پایان
    پیکربندی.تی‌ال‌اس فعال = درست
    پیکربندی.پرونده گواهی = "/etc/ssl/certs/ftp.crt"
    پیکربندی.پرونده کلید = "/etc/ssl/private/ftp.key"
    پیکربندی.اجبار تی‌ال‌اس = درست
    ناپایا سرور := سرور اف‌تی‌پی.جدید(پیکربندی)
    اگر وارونه سرور اف‌تی‌پی.گوش دادن(سرور):
        سرچاپ "گوش دادن روی درگاه ممکن نشد"، پیکربندی.درگاه
        برگشت ۱
    پایان
    سرور اف‌تی‌پی.خدمت(سرور)
    برگشت ۰
پایان

اگر گواهی یا کلید خوانده نشود، حتی با تی‌ال‌اس فعال درست، TLS خاموش می‌ماند؛ پس پیش از اعتماد کردن، تنظیمات را یک بار با یک کارخواه واقعی آزمایش کنید.

پیش‌فرض‌ها و یک درگاه آزاد

پیکربندی تازه روی همه‌ی رابط‌ها در درگاه ۲۱ گوش می‌دهد، پوشه‌ی جاری را پخش می‌کند و تا کاربری نگذارید یا دسترسی ناشناس را روشن نکنید کسی را راه نمی‌دهد. انتقال‌های غیرفعال از درگاه ۴۰۰۰۰ تا ۴۰۱۰۰ استفاده می‌کنند. برنامه‌ی زیر پیش‌فرض‌ها را نشان می‌دهد و بعد روی نشانی خودی با درگاه ۰ گوش می‌دهد تا بفهمد سیستم کدام درگاه را داده است. چیزی وصل نمی‌شود، پس بدون شبکه اجرا می‌شود.

ftpd-listen.salam
واردسازی سرور اف‌تی‌پی

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    سرچاپ پیکربندی.درگاه، پیکربندی.ریشه، پیکربندی.اجازه ناشناس
    سرچاپ پیکربندی.شروع غیرفعال، پیکربندی.پایان غیرفعال، پیکربندی.تی‌ال‌اس فعال
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۰
    پیکربندی.اجازه ناشناس = درست
    ناپایا سرور := سرور اف‌تی‌پی.جدید(پیکربندی)
    سرچاپ سرور اف‌تی‌پی.گوش دادن(سرور)
    سرچاپ سرور اف‌تی‌پی.درگاه(سرور) بزرگتر ۰
    سرور اف‌تی‌پی.بستن(سرور)
    سرچاپ سرور.در حال اجرا
پایان
خروجی21 . false 40000 40100 false true true false

بعد از گوش دادن پیکربندی درون کارساز درگاه واقعی را دارد و درگاه همان را برمی‌گرداند. بستن کارساز را متوقف می‌کند و درگاه را آزاد می‌کند.

کدام تابع برای کدام کار

کارابزار
شروع از پیش‌فرض‌هاپیکربندی نو و بعد گذاشتن فیلدهای پیکربندی
ساختن کارسازجدید
باز کردن درگاهگوش دادن و بعد درگاه برای خواندن آن
خدمت به کارخواه‌ها تا توقفخدمت
خدمت دقیقاً به یک کارخواهیک‌بار خدمت
توقف و آزاد کردن درگاهبستن

گونه‌ها

پیکربندی Config

ساختار پیکربندی
پیکربندی یک کارساز FTP.
نامانگلیسیگونهتوضیح
میزبانhostرشته = "0.0.0.0"نشانی‌ای که روی آن گوش داده می‌شود؛ 0.0.0.0 یعنی همه‌ی رابط‌ها.
درگاهportصحیح = 21درگاهی که روی آن گوش داده می‌شود؛ پیش‌فرض ۲۱ است و ۰ می‌گذارد سیستم یکی را برگزیند.
ریشهrootرشته = "."پوشه‌ای که کارخواه‌ها آن را / می‌بینند؛ به بالاتر از آن نمی‌رسند.
اجازه ناشناسallow_anonymousمنطقی = نادرستمی‌گذارد کارخواه‌ها بدون گذرواژه به‌عنوان کاربر ناشناس وارد شوند؛ پیش‌فرض خاموش است.
کاربر ناشناسanonymous_userرشته = "anonymous"نامی که ناشناس به حساب می‌آید؛ پیش‌فرض anonymous است.
کاربرuserرشته = ""نام تنها حسابی که می‌تواند با گذرواژه وارد شود.
گذرواژهpasswordرشته = ""گذرواژه‌ی آن حساب.
شروع غیرفعالpassive_startصحیح = 40000نخستین درگاه بازه‌ای که برای اتصال‌های داده‌ی غیرفعال به کار می‌رود؛ پیش‌فرض ۴۰۰۰۰.
پایان غیرفعالpassive_endصحیح = 40100آخرین درگاه آن بازه؛ پیش‌فرض ۴۰۱۰۰.
تی‌ال‌اس فعالtls_enabledمنطقی = نادرستFTPS را روشن می‌کند؛ پرونده گواهی و پرونده کلید را هم می‌خواهد.
پرونده گواهیcert_fileرشته = ""مسیر گواهی در قالب PEM.
پرونده کلیدkey_fileرشته = ""مسیر کلید خصوصی در قالب PEM.
تی‌ال‌اس ضمنیimplicit_tlsمنطقی = نادرستاز بایت اول اتصال TLS انتظار دارد، مثل FTPS ضمنی.
اجبار تی‌ال‌اسrequire_tlsمنطقی = نادرستتا اتصال رمزگذاری نشده ورود را رد می‌کند.
ftpd-Config.salam
واردسازی سرور اف‌تی‌پی

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    سرچاپ پیکربندی.میزبان، پیکربندی.درگاه، پیکربندی.ریشه
    سرچاپ پیکربندی.اجازه ناشناس، پیکربندی.کاربر ناشناس
    سرچاپ پیکربندی.کاربر برابر ""، پیکربندی.گذرواژه برابر ""
    سرچاپ پیکربندی.شروع غیرفعال، پیکربندی.پایان غیرفعال
    سرچاپ پیکربندی.تی‌ال‌اس فعال، پیکربندی.تی‌ال‌اس ضمنی، پیکربندی.اجبار تی‌ال‌اس
    سرچاپ پیکربندی.پرونده گواهی برابر ""، پیکربندی.پرونده کلید برابر ""
    پیکربندی.کاربر = "reports"
    پیکربندی.اجازه ناشناس = درست
    سرچاپ پیکربندی.کاربر، پیکربندی.اجازه ناشناس
پایان
خروجی0.0.0.0 21 . false anonymous true true 40000 40100 false false false true true reports true

سرور Server

ساختار سرور
یک کارساز FTP در حال اجرا.
نامانگلیسیگونهتوضیح
پیکربندیconfigپیکربندیپیکربندی‌ای که کارساز با آن ساخته شده؛ بعد از گوش دادن درگاهش همان درگاه واقعی است.
شنوندهlistenerتی سی پی.سرورسوکت شنونده.
در حال اجراrunningمنطقی = نادرستبعد از موفقیت گوش دادن درست است و تا صدا زدن بستن می‌ماند.
پیکربندی تی‌ال‌اسtls_cfgتی ال اس.پیکربندی کارسازتنظیمات TLS که از گواهی و کلید خوانده شده؛ وقتی TLS خاموش است خالی است.
ftpd-Server.salam
واردسازی سرور اف‌تی‌پی

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۰
    پیکربندی.ریشه = "/tmp"
    ناپایا سرور := سرور اف‌تی‌پی.جدید(پیکربندی)
    سرچاپ سرور.در حال اجرا، سرور.پیکربندی.ریشه
    سرچاپ سرور اف‌تی‌پی.گوش دادن(سرور)، سرور.در حال اجرا
    سرچاپ سرور اف‌تی‌پی.درگاه(سرور) بزرگتر ۰، سرور.پیکربندی.درگاه برابر سرور اف‌تی‌پی.درگاه(سرور)
    سرور اف‌تی‌پی.بستن(سرور)
    سرچاپ سرور.در حال اجرا
پایان
خروجیfalse /tmp true true true true false

تابع‌ها

پیکربندی نو NewConfig

تابع پیکربندی نو(): پیکربندی
پیکربندی با مقدارهای پیش‌فرض: درگاه ۲۱، پوشه‌ی جاری به‌جای ریشه، و هنوز هیچ ورودی مجاز نیست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Config.salam

جدید New

تابع جدید(cfg: پیکربندی): سرور
از یک پیکربندی کارساز می‌سازد و وقتی TLS روشن است گواهی را می‌خواند. هنوز گوش نمی‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam

گوش دادن Listen

تابع گوش دادن(srv &: سرور): منطقی
درگاه را باز می‌کند؛ اگر نتواند آن را ببندد نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam

بستن Close

تابع بستن(srv &: سرور)
کارساز را متوقف می‌کند و درگاه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam

درگاه Port

تابع درگاه(srv: سرور): صحیح
درگاهی که کارساز روی آن گوش می‌دهد؛ وقتی پیکربندی ۰ بود، بعد از گوش دادن درگاه واقعی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam

یک‌بار خدمت ServeOnce

تابع یک‌بار خدمت(srv &: سرور): منطقی
منتظر یک کارخواه می‌ماند، تا خروجش به او خدمت می‌دهد و درست برمی‌گرداند؛ اگر درگاه باز نباشد یا پذیرفتن شکست بخورد نادرست.
ftpd-Serve.salam
واردسازی سرور اف‌تی‌پی

تابع ریشه:
    ناپایا پیکربندی := سرور اف‌تی‌پی.پیکربندی نو()
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۲۱۲۱
    پیکربندی.ریشه = "/srv/ftp"
    پیکربندی.اجازه ناشناس = درست
    ناپایا سرور := سرور اف‌تی‌پی.جدید(پیکربندی)
    اگر وارونه سرور اف‌تی‌پی.گوش دادن(سرور):
        برگشت ۱
    پایان
    رسیدگی شد := سرور اف‌تی‌پی.یک‌بار خدمت(سرور)
    سرچاپ "یک کارخواه خدمت شد:"، رسیدگی شد
    سرور اف‌تی‌پی.خدمت(سرور)
    سرور اف‌تی‌پی.بستن(سرور)
    برگشت ۰
پایان

خدمت Serve

تابع خدمت(srv &: سرور)
یکی پس از دیگری به کارخواه‌ها خدمت می‌دهد تا در حال اجرا نادرست شود یا شنونده از کار بیفتد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftpd-Serve.salam