سرور افتیپی ftpd
کارساز FTP و FTPS که یک پوشه را با ورود به سیستم، انتقال غیرفعال و TLS اختیاری پخش میکند.
واردسازی سرور افتیپی
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
این بسته یک کارساز FTP به زبان سلام است. یک پوشهی ریشه، یک کاربر و یک گذرواژه بدهید، گوش دادن و بعد خدمت را صدا بزنید، و هر کارخواه FTP میتواند پروندههای زیر آن پوشه را فهرست کند، بفرستد، بگیرد، تغییر نام بدهد و پاک کند. مسیرها درون ریشه بررسی میشوند، اما پیوند نمادینی که درون ریشه باشد و به جای دیگری اشاره کند دنبال میشود، پس پیوند را از پوشهای که پخش میکنید دور نگه دارید. این بسته نیمهی دیگر کارخواه افتیپی (ftp) است و آن دو با هم کار میکنند.
FTP ساده و FTPS را پشتیبانی میکند. انتقالها در حالت غیرفعال انجام میشوند (PASV و EPSV) روی بازهی درگاهی که خودتان تعیین میکنید، پس آن بازه را در دیوار آتش باز کنید. ورود یا با یک کاربر و گذرواژهی تنظیمشده است، یا با دسترسی ناشناس وقتی اجازه ناشناس روشن باشد؛ اگر هیچکدام نباشد کسی نمیتواند وارد شود. با یک گواهی و یک کلید، کارساز FTPS آشکار (AUTH TLS و بعد PROT P برای اتصال داده) را هم میپذیرد و با تیالاس ضمنی FTPS ضمنی را، که اتصال از همان بایت اول رمزگذاری شده است.
پیش از بهکار بردن بدانید:
- فقط یک کاربر هست.
کاربروگذرواژهیک حساب را توصیف میکنند؛ فهرست حسابها، پوشهی جدا برای هر کاربر و مجوزها در این بسته نیست. - کارخواهها یکی پس از دیگری خدمت میگیرند.
خدمتیک اتصال را تا آخر رسیدگی میکند و بعد اتصال بعدی را میپذیرد، پس برای یک صندوق تحویل کوچک یا کارسازی که فایل ساختهشده را پخش میکند مناسب است، نه برای یک کارساز عمومی شلوغ. - FTP ساده گذرواژه را بدون رمز میفرستد.
تیالاس فعالرا باپرونده گواهیوپرونده کلیدروشن کنید واجبار تیالاسرا بگذارید تا کارساز تا پیش از رمزگذاری اتصالUSERوPASSرا رد کند. کارخواه باید پیش از فرستادن گذرواژه TLS را شروع کند؛ کارخواهی که آن را زودتر بفرستد گذرواژه را لو داده است، پساجبار تیالاسفقط از کارخواههای درسترفتار محافظت میکند. - درگاه ۰ یک درگاه آزاد برمیدارد و
درگاهمیگوید کدام را. نمونهها و آزمونها اینطور بدون برخورد با چیز دیگری اجرا میشوند.
پوشهای را با ورود به سیستم پخش کنید
با پیکربندی نو یک پیکربندی بسازید، ریشه، کاربر، گذرواژه و بازهی درگاه غیرفعال را بگذارید، با جدید کارساز را بسازید و گوش دادن را صدا بزنید. وقتی درگاه اشغال است یا اجازهی استفاده از آن را ندارید گوش دادن نادرست برمیگرداند؛ پیش از خدمت که تا توقف کارساز ادامه دارد، آن را بررسی کنید. درگاههای زیر ۱۰۲۴، از جمله ۲۱ معمول، در بیشتر سیستمها دسترسی بیشتری میخواهند و برای همین نمونه ۲۱۲۱ را به کار میبرد.
واردسازی سرور افتیپی
واردسازی محیط
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
پیکربندی.میزبان = "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 که درگاه خودش را دارد.
واردسازی سرور افتیپی
واردسازی محیط
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
پیکربندی.درگاه = ۲۱۲۱
پیکربندی.ریشه = "/srv/ftp"
پیکربندی.کاربر = "reports"
پیکربندی.گذرواژه = محیط.دریافت("FTP_PASSWORD")
اگر پیکربندی.گذرواژه.طول() برابر ۰:
سرچاپ "ابتدا FTP_PASSWORD را بگذارید"
برگشت ۱
پایان
پیکربندی.تیالاس فعال = درست
پیکربندی.پرونده گواهی = "/etc/ssl/certs/ftp.crt"
پیکربندی.پرونده کلید = "/etc/ssl/private/ftp.key"
پیکربندی.اجبار تیالاس = درست
ناپایا سرور := سرور افتیپی.جدید(پیکربندی)
اگر وارونه سرور افتیپی.گوش دادن(سرور):
سرچاپ "گوش دادن روی درگاه ممکن نشد"، پیکربندی.درگاه
برگشت ۱
پایان
سرور افتیپی.خدمت(سرور)
برگشت ۰
پایاناگر گواهی یا کلید خوانده نشود، حتی با تیالاس فعال درست، TLS خاموش میماند؛ پس پیش از اعتماد کردن، تنظیمات را یک بار با یک کارخواه واقعی آزمایش کنید.
پیشفرضها و یک درگاه آزاد
پیکربندی تازه روی همهی رابطها در درگاه ۲۱ گوش میدهد، پوشهی جاری را پخش میکند و تا کاربری نگذارید یا دسترسی ناشناس را روشن نکنید کسی را راه نمیدهد. انتقالهای غیرفعال از درگاه ۴۰۰۰۰ تا ۴۰۱۰۰ استفاده میکنند. برنامهی زیر پیشفرضها را نشان میدهد و بعد روی نشانی خودی با درگاه ۰ گوش میدهد تا بفهمد سیستم کدام درگاه را داده است. چیزی وصل نمیشود، پس بدون شبکه اجرا میشود.
واردسازی سرور افتیپی
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
سرچاپ پیکربندی.درگاه، پیکربندی.ریشه، پیکربندی.اجازه ناشناس
سرچاپ پیکربندی.شروع غیرفعال، پیکربندی.پایان غیرفعال، پیکربندی.تیالاس فعال
پیکربندی.میزبان = "127.0.0.1"
پیکربندی.درگاه = ۰
پیکربندی.اجازه ناشناس = درست
ناپایا سرور := سرور افتیپی.جدید(پیکربندی)
سرچاپ سرور افتیپی.گوش دادن(سرور)
سرچاپ سرور افتیپی.درگاه(سرور) بزرگتر ۰
سرور افتیپی.بستن(سرور)
سرچاپ سرور.در حال اجرا
پایانبعد از گوش دادن پیکربندی درون کارساز درگاه واقعی را دارد و درگاه همان را برمیگرداند. بستن کارساز را متوقف میکند و درگاه را آزاد میکند.
کدام تابع برای کدام کار
| کار | ابزار |
|---|---|
| شروع از پیشفرضها | پیکربندی نو و بعد گذاشتن فیلدهای پیکربندی |
| ساختن کارساز | جدید |
| باز کردن درگاه | گوش دادن و بعد درگاه برای خواندن آن |
| خدمت به کارخواهها تا توقف | خدمت |
| خدمت دقیقاً به یک کارخواه | یکبار خدمت |
| توقف و آزاد کردن درگاه | بستن |
گونهها
پیکربندی Config
ساختار پیکربندی| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| میزبان | 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 | منطقی = نادرست | تا اتصال رمزگذاری نشده ورود را رد میکند. |
واردسازی سرور افتیپی
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
سرچاپ پیکربندی.میزبان، پیکربندی.درگاه، پیکربندی.ریشه
سرچاپ پیکربندی.اجازه ناشناس، پیکربندی.کاربر ناشناس
سرچاپ پیکربندی.کاربر برابر ""، پیکربندی.گذرواژه برابر ""
سرچاپ پیکربندی.شروع غیرفعال، پیکربندی.پایان غیرفعال
سرچاپ پیکربندی.تیالاس فعال، پیکربندی.تیالاس ضمنی، پیکربندی.اجبار تیالاس
سرچاپ پیکربندی.پرونده گواهی برابر ""، پیکربندی.پرونده کلید برابر ""
پیکربندی.کاربر = "reports"
پیکربندی.اجازه ناشناس = درست
سرچاپ پیکربندی.کاربر، پیکربندی.اجازه ناشناس
پایانسرور Server
ساختار سرور| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| پیکربندی | config | پیکربندی | پیکربندیای که کارساز با آن ساخته شده؛ بعد از گوش دادن درگاهش همان درگاه واقعی است. |
| شنونده | listener | تی سی پی.سرور | سوکت شنونده. |
| در حال اجرا | running | منطقی = نادرست | بعد از موفقیت گوش دادن درست است و تا صدا زدن بستن میماند. |
| پیکربندی تیالاس | tls_cfg | تی ال اس.پیکربندی کارساز | تنظیمات TLS که از گواهی و کلید خوانده شده؛ وقتی TLS خاموش است خالی است. |
واردسازی سرور افتیپی
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
پیکربندی.میزبان = "127.0.0.1"
پیکربندی.درگاه = ۰
پیکربندی.ریشه = "/tmp"
ناپایا سرور := سرور افتیپی.جدید(پیکربندی)
سرچاپ سرور.در حال اجرا، سرور.پیکربندی.ریشه
سرچاپ سرور افتیپی.گوش دادن(سرور)، سرور.در حال اجرا
سرچاپ سرور افتیپی.درگاه(سرور) بزرگتر ۰، سرور.پیکربندی.درگاه برابر سرور افتیپی.درگاه(سرور)
سرور افتیپی.بستن(سرور)
سرچاپ سرور.در حال اجرا
پایانتابعها
پیکربندی نو NewConfig
تابع پیکربندی نو(): پیکربندینمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Config.salam
جدید New
تابع جدید(cfg: پیکربندی): سرورنمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam
گوش دادن Listen
تابع گوش دادن(srv &: سرور): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam
بستن Close
تابع بستن(srv &: سرور)نمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam
درگاه Port
تابع درگاه(srv: سرور): صحیحگوش دادن درگاه واقعی است.نمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Server.salam
یکبار خدمت ServeOnce
تابع یکبار خدمت(srv &: سرور): منطقیواردسازی سرور افتیپی
تابع ریشه:
ناپایا پیکربندی := سرور افتیپی.پیکربندی نو()
پیکربندی.میزبان = "127.0.0.1"
پیکربندی.درگاه = ۲۱۲۱
پیکربندی.ریشه = "/srv/ftp"
پیکربندی.اجازه ناشناس = درست
ناپایا سرور := سرور افتیپی.جدید(پیکربندی)
اگر وارونه سرور افتیپی.گوش دادن(سرور):
برگشت ۱
پایان
رسیدگی شد := سرور افتیپی.یکبار خدمت(سرور)
سرچاپ "یک کارخواه خدمت شد:"، رسیدگی شد
سرور افتیپی.خدمت(سرور)
سرور افتیپی.بستن(سرور)
برگشت ۰
پایانخدمت Serve
تابع خدمت(srv &: سرور)در حال اجرا نادرست شود یا شنونده از کار بیفتد.نمونهی این مورد همراه با موارد بالاتر آمده است: ftpd-Serve.salam