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

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

کارساز SFTP برای انتقال پرونده روی SSH با ورود با گذرواژه و یک پوشه‌ی ریشه.

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

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

این بسته یک کارساز SFTP به زبان سلام است: کارسازی که فقط یک کار می‌کند، انتقال پرونده روی SSH. روی بسته‌ی سرور اس‌اس‌اچ (sshd) ساخته شده، پس کاربرها را همان‌طور وارد می‌کند و همان کلید میزبان را دارد، اما فقط زیرسامانه‌ی SFTP را می‌پذیرد. کارخواه نمی‌تواند فرمان اجرا کند یا پوسته باز کند، و برای صندوق تحویلی که شریک‌ها در آن پرونده‌هایی را که به آن‌ها اعتماد دارید می‌فرستند و می‌گیرند همین را می‌خواهید.

یک پوشه‌ی ریشه و فهرست کاربرها بدهید، گوش دادن و بعد خدمت را صدا بزنید. کارخواه‌ها همان‌های معمول‌اند: sftp از OpenSSH، FileZilla، یا بسته‌ی اس اس اچ (ssh) با باز کردن اس اف تی پی، بارگذاری و دانلود.

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

  • کاربرها مقدارهای کاربر از بسته‌ی سرور اس‌اس‌اچ (sshd) هستند، با نام، گذرواژه و پوشه‌ی خانه‌ای زیر ریشه. ورود با گذرواژه است.
  • پرونده کلید میزبان را بگذارید و مسیر یک کلید خصوصی OpenSSH را بدهید. بدون آن کارساز کلیدی را به کار می‌برد که در کتابخانه است و همه می‌توانند آن را بخوانند، که فقط برای آزمون‌ها درست است.
  • ریشه جای شروع مسیرهاست، نه مرز امنیتی. کارخواه‌ها ریشه را / می‌بینند، اما کاربر می‌تواند از راه SFTP پیوند نمادینی بسازد که به بیرون از آن اشاره کند؛ پس حساب را فقط به کسانی بدهید که به همه‌ی پرونده‌هایی که فرایند کارساز می‌تواند بنویسد اعتماد دارید.
  • اتصال‌ها یکی پس از دیگری خدمت می‌گیرند، پس یک انتقال طولانی کارخواه بعدی را منتظر نگه می‌دارد.

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

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

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

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اف‌تی‌پی.پیکربندی نو()
    سرچاپ پیکربندی.درگاه، پیکربندی.ریشه
    پیکربندی.میزبان = "127.0.0.1"
    پیکربندی.درگاه = ۰
    پیکربندی.ریشه = "/srv/drop"
    پیکربندی.کاربران.بیفزا(سرور اس‌اس‌اچ.کاربر { نام = "partner"، گذرواژه = "s3cret"، خانه = "/" })
    سرچاپ پیکربندی.کاربران.طول()
    ناپایا سرور := سرور اس‌اف‌تی‌پی.جدید(پیکربندی)
    سرچاپ سرور اس‌اف‌تی‌پی.گوش دادن(سرور)
    سرچاپ سرور اس‌اف‌تی‌پی.درگاه(سرور) بزرگتر ۰
    سرور اس‌اف‌تی‌پی.بستن(سرور)
    سرچاپ سرور.در حال اجرا
پایان
خروجی22 . 1 true true false

یک صندوق تحویل راه بیندازید

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

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

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اف‌تی‌پی.پیکربندی نو()
    پیکربندی.درگاه = ۲۲۲۲
    پیکربندی.ریشه = "/srv/drop"
    پیکربندی.پرونده کلید میزبان = "/etc/deploy/host_key"
    پیکربندی.کاربران.بیفزا(سرور اس‌اس‌اچ.کاربر { نام = "partner"، گذرواژه = محیط.دریافت("SFTP_PASSWORD")، خانه = "/" })
    اگر محیط.دریافت("SFTP_PASSWORD").طول() برابر ۰:
        سرچاپ "ابتدا SFTP_PASSWORD را بگذارید"
        برگشت ۱
    پایان
    ناپایا سرور := سرور اس‌اف‌تی‌پی.جدید(پیکربندی)
    اگر وارونه سرور اس‌اف‌تی‌پی.گوش دادن(سرور):
        سرچاپ "گوش دادن روی درگاه ممکن نشد"، پیکربندی.درگاه
        برگشت ۱
    پایان
    سرچاپ "کارساز اس‌اف‌تی‌پی روی درگاه"، سرور اس‌اف‌تی‌پی.درگاه(سرور)
    سرور اس‌اف‌تی‌پی.خدمت(سرور)
    برگشت ۰
پایان

این برنامه تا وقتی متوقف نشود ادامه می‌دهد، پس این‌جا فقط بررسی می‌شود. با sftp -P 2222 partner@host وصل شوید.

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

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

گونه‌ها

پیکربندی Config

ساختار پیکربندی
پیکربندی یک کارساز SFTP.
نامانگلیسیگونهتوضیح
میزبانhostرشته = "0.0.0.0"نشانی‌ای که روی آن گوش داده می‌شود؛ 0.0.0.0 یعنی همه‌ی رابط‌ها.
درگاهportصحیح = 22درگاهی که روی آن گوش داده می‌شود؛ پیش‌فرض ۲۲ است و ۰ می‌گذارد سیستم یکی را برگزیند.
ریشهrootرشته = "."پوشه‌ای که کارخواه‌ها آن را / می‌بینند؛ به بالاتر از آن نمی‌رسند.
پرونده کلید میزبانhost_key_fileرشته = ""مسیر کلید خصوصی OpenSSH که هویت کارساز است.
کاربرانusersوکتور<سرور اس‌اس‌اچ.کاربر>کاربرهایی که می‌توانند وارد شوند، به‌صورت مقدارهای sshd.User.
sftpd-Config.salam
واردسازی سرور اس‌اف‌تی‌پی
واردسازی سرور اس‌اس‌اچ

تابع ریشه:
    ناپایا پیکربندی := سرور اس‌اف‌تی‌پی.پیکربندی نو()
    سرچاپ پیکربندی.میزبان، پیکربندی.درگاه، پیکربندی.ریشه
    سرچاپ پیکربندی.پرونده کلید میزبان برابر ""، پیکربندی.کاربران.طول()
    پیکربندی.ریشه = "/srv/drop"
    پیکربندی.کاربران.بیفزا(سرور اس‌اس‌اچ.کاربر { نام = "partner"، گذرواژه = "s3cret"، خانه = "/" })
    سرچاپ پیکربندی.ریشه، پیکربندی.کاربران.طول()، پیکربندی.کاربران.بگیر(۰).نام
پایان
خروجی0.0.0.0 22 . true 0 /srv/drop 1 partner

سرور Server

ساختار سرور
یک کارساز SFTP در حال اجرا.
نامانگلیسیگونهتوضیح
پیکربندیconfigپیکربندیپیکربندی‌ای که کارساز با آن ساخته شده؛ بعد از گوش دادن درگاهش همان درگاه واقعی است.
سرور اس‌اس‌اچssh_serverسرور اس‌اس‌اچ.سرورکارساز SSH زیر آن، که فقط SFTP را مجاز می‌کند.
در حال اجراrunningمنطقی = نادرستبعد از موفقیت گوش دادن درست است و تا صدا زدن بستن می‌ماند.
sftpd-Server.salam
واردسازی سرور اس‌اف‌تی‌پی

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

تابع‌ها

پیکربندی نو NewConfig

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

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

جدید New

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

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

گوش دادن Listen

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

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

بستن Close

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

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

درگاه Port

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

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

یک‌بار خدمت ServeOnce

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

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

خدمت Serve

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

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