SFTP(1)

الاسم
sftp - نقل ملفات آمن من OpenSSH

موجز
sftp [-46AaCfNpqrv] [-B buffer_size] [-b batchfile] [-c cipher] [-D sftp_server_command] [-F ssh_config] [-i identity_file] [-J destination] [-l limit] [-o ssh_option] [-P port] [-R num_requests] [-S program] [-s subsystem | sftp_server] [-X sftp_option] destination

الوصف
sftp برنامج لنقل الملفات، يشبه ftp(1) ، ينفذ جميع العمليات عبر وسيلة نقل ssh(1) معمّاة. ويمكنه أيضًا استخدام العديد من ميزات ssh، مثل الاستيثاق بالمفتاح العام والضغط.

يمكن تحديد destination إما كـ [user@]host[:path] أو كمعرّف URI على الشكل sftp://[user@]host[:port][/path].

إذا تضمن destination مسارًا path ولم يكن دليلًا، فسيجلب sftp الملفات آليًا إذا استُخدمت وسيلة استيثاق غير تفاعلية؛ وإلا فإنه سيفعل ذلك بعد نجاح الاستيثاق التفاعلي.

في حال لم يُحدد path ، أو كان path دليلًا، فسيسجل sftp الدخول إلى المضيف host المحدد ويدخل في وضع الأوامر التفاعلي، وينتقل إلى الدليل البعيد في حال حُدد واحد. يمكن استخدام شرطة مائلة لاحقة اختيارية لفرض تفسير path على أنه دليل.

بما أن تنسيقات الوجهة تستخدم حرف النقطتين الرأسيتين للفصل بين أسماء المضيفين وأسماء المسارات أو أرقام المنافذ، فيجب إحاطة عناوين IPv6 بين قوسين مربعين لتجنب اللبس.

الخيارات هي كما يلي:

-4  يجبر sftp على استخدام عناوين IPv4 فقط.

-6  يجبر sftp على استخدام عناوين IPv6 فقط.

-A  يسمح بتمرير ssh-agent(1) إلى النظام البعيد. المبدئي هو عدم تمرير وكيل المصادقة.

-a  محاولة متابعة عمليات النقل المقطوعة بدلًا من الكتابة فوق النسخ الجزئية أو الكاملة الموجودة للملفات. إذا اختلفت المحتويات الجزئية عما يُنقل حاليًا، فمن المرجح أن يكون الملف الناتج معطوبًا.

-B buffer_size
    حدد حجم المخزن الوسيط الذي يستخدمه sftp عند نقل الملفات. تتطلب المخازن الوسيطة الأكبر عددًا أقل من الرحلات الذهاب والإياب على حساب استهلاك ذاكرة أعلى. القيمة المبدئية هي 32768 بايت.

-b batchfile
    يقرأ وضع الدفعة سلسلة من الأوامر من ملف دخل batchfile بدلاً من stdin. وبما أنه يفتقر إلى التفاعل مع المستخدم، فينبغي استخدامه بالتزامن مع استيثاق غير تفاعلي لتفادي الحاجة إلى إدخال كلمة مرور وقت الاتصال (انظر sshd(8) و ssh-keygen(1) للتفاصيل).

    يمكن استخدام batchfile بقيمة ‘-’ للإشارة إلى الدخل القياسي. سيجهض sftp إذا فشل أي من الأوامر التالية: get, put, reget, reput, rename, ln ، و rm, mkdir, chdir, ls ، و lchdir, copy, cp, chmod, chown ، و chgrp, lpwd, df, symlink ، و lmkdir.

    يمكن كبت الإنهاء عند حدوث خطأ لكل أمر على حدة ببدء الأمر بمحرف ‘-’ (على سبيل المثال، -rm /tmp/blah*). يمكن كبت صدى الأمر ببدء الأمر بمحرف ‘@’. يمكن دمج هذين البادئتين بأي ترتيب، على سبيل المثال -@ls /bsd.

-C  يفعّل الضغط (عبر علامة -C الخاصة بـ ssh).

-c شفرة
    يحدد المعمّي لاستخدامه في تعمية عمليات نقل البيانات. يُمرر هذا الخيار مباشرة إلى ssh(1).

-D sftp_server_command
    الاتصال مباشرة بخادوم sftp محلي (بدلاً من الاتصال عبر ssh(1)). يمكن تحديد أمر ووسطاء، على سبيل المثال "/path/sftp-server -el debug3". قد يكون هذا الخيار مفيدًا في تنقِيح العميل والخادوم.

-F ssh_config
    يحدد ملف ضبط بديل لكل مستخدم لـ ssh(1). يُمرر هذا الخيار مباشرة إلى ssh(1).

-f  يطلب تفريغ الملفات إلى القرص فوراً بعد النقل. عند رفع الملفات، لا تُفعّل هذه الميزة إلا إذا كان الخادوم يدعم امتداد "fsync@openssh.com".

-i identity_file
    يختار الملف الذي تُقرأ منه الهوية (المفتاح الخاص) للاستيثاق بالمفتاح العام. يُمرر هذا الخيار مباشرة إلى ssh(1).

-J destination
    اتصل بالمضيف المستهدف بإجراء اتصال sftp أولاً بمضيف القفز الموصوف بـ destination ثم إنشاء توجيه TCP إلى الوجهة النهائية من هناك. يمكن تحديد قفزات متعددة مفصولة بفواصل. هذا اختصار لتحديد توجيه ضبط ProxyJump. يُمرر هذا الخيار مباشرة إلى ssh(1).

-l حد
    يحد من عرض النطاق الترددي المستخدم، محددًا بالكيلوبت/ثانية.

-N  يعطل الوضع الصامت، على سبيل المثال لتجاوز الوضع الصامت الضمني المحدد بواسطة علامة -b.

-o خيار_ssh
    يمكن استخدامه لتمرير خيارات إلى ssh بالتنسيق المستخدم في ssh_config(5). هذا مفيد لتحديد الخيارات التي لا يوجد لها علامة سطر أوامر منفصلة في sftp. على سبيل المثال، لتحديد منفذ بديل استخدم: sftp -oPort=24. للحصول على التفاصيل الكاملة للخيارات المدرجة أدناه، وقيمها الممكنة، راجع ssh_config(5).

    AddKeysToAgent
    AddressFamily
    BatchMode
    BindAddress
    BindInterface
    CASignatureAlgorithms
    CanonicalDomains
    CanonicalizeFallbackLocal
    CanonicalizeHostname
    CanonicalizeMaxDots
    CanonicalizePermittedCNAMEs
    CertificateFile
    ChannelTimeout
    CheckHostIP
    Ciphers
    ClearAllForwardings
    الضغط
    ConnectTimeout
    ConnectionAttempts
    ControlMaster
    ControlPath
    ControlPersist
    DynamicForward
    EnableEscapeCommandline
    EnableSSHKeysign
    EscapeChar
    ExitOnForwardFailure
    FingerprintHash
    ForkAfterAuthentication
    ForwardAgent
    ForwardX11
    ForwardX11Timeout
    ForwardX11Trusted
    GSSAPIAuthentication
    GSSAPIDelegateCredentials
    GatewayPorts
    GlobalKnownHostsFile
    HashKnownHosts
    Host
    HostKeyAlgorithms
    HostKeyAlias
    HostbasedAcceptedAlgorithms
    HostbasedAuthentication
    Hostname
    IPQoS
    IdentitiesOnly
    IdentityAgent
    IdentityFile
    IgnoreUnknown
    Include
    KbdInteractiveAuthentication
    KbdInteractiveDevices
    KexAlgorithms
    KnownHostsCommand
    LocalCommand
    LocalForward
    LogLevel
    LogVerbose
    MACs
    NoHostAuthenticationForLocalhost
    NumberOfPasswordPrompts
    ObscureKeystrokeTiming
    PKCS11Provider
    PasswordAuthentication
    PermitLocalCommand
    PermitRemoteOpen
    Port
    PreferredAuthentications
    ProxyCommand
    ProxyJump
    ProxyUseFdpass
    PubkeyAcceptedAlgorithms
    PubkeyAuthentication
    RekeyLimit
    RemoteCommand
    RemoteForward
    RequestTTY
    RequiredRSASize
    RevokedHostKeys
    SecurityKeyProvider
    SendEnv
    ServerAliveCountMax
    ServerAliveInterval
    SessionType
    SetEnv
    StdinNull
    StreamLocalBindMask
    StreamLocalBindUnlink
    StrictHostKeyChecking
    SyslogFacility
    TCPKeepAlive
    Tag
    Tunnel
    TunnelDevice
    UpdateHostKeys
    مستخدم
    UserKnownHostsFile
    VerifyHostKeyDNS
    VisualHostKey
    XAuthLocation

-P port
    يحدد المنفذ المراد الاتصال به على المضيف البعيد.

-p  يحفظ أوقات التعديل، وأوقات الوصول، والأوضاع من الملفات الأصلية المنقولة.

-q  الوضع الهادئ: يعطل مقياس التقدم ورسائل التحذير والتشخيص من ssh(1).

-R num_requests
    حدد عدد الطلبات التي يمكن أن تكون معلقة في وقت واحد. قد يؤدي زيادة هذا إلى تحسين سرعة نقل الملفات قليلاً ولكنه سيزيد من استهلاك الذاكرة. القيمة المبدئية هي 64 طلباً معلقاً.

-r  نسخ الأدلة بالكامل تكراريًا عند الرفع والتنزيل. لاحظ أن sftp لا يتبع الروابط الرمزية التي يواجهها أثناء عبور الشجرة.

-S برنامج
    اسم البرنامج program المستخدم للاتصال المعمّى. يجب أن يفهم البرنامج خيارات ssh(1).

-s subsystem | sftp_server
    يحدد نظام SSH2 الفرعي أو مسار خادوم sftp على المضيف البعيد. يكون المسار مفيداً عندما لا يكون لدى sshd(8) البعيد نظام sftp فرعي مضبوط.

-v  رفع مستوى التسجيل. يُمرر هذا الخيار أيضًا إلى ssh.

-X خيار_sftp
    تحديد خيار يتحكم في جوانب سلوك بروتوكول SFTP. الخيارات الصالحة هي:

    nrequests=value
        يتحكم في عدد طلبات قراءة أو كتابة SFTP المتزامنة التي قد تكون جارية في أي وقت أثناء التنزيل أو الرفع. مبدئيًا يمكن أن يكون 64 طلبًا نشطًا بالتزامن.

    buffer=value
        يتحكم في الحجم الأقصى للخبيئة لعملية قراءة/كتابة SFTP واحدة أثناء التنزيل أو الرفع. تُستخدم خبيئة بحجم 32 كيلوبايت مبدئيًا.

الأوامر التفاعلية
بمجرد الدخول في الوضع التفاعلي، يفهم sftp مجموعة من الأوامر المشابهة لأوامر ftp(1). الأوامر غير حساسة لحالة الأحرف. يجب إحاطة أسماء المسارات التي تحتوي على مسافات بعلامات اقتباس. أي محارف خاصة واردة داخل أسماء المسارات التي يتعرف عليها glob(3) يجب الهروب منها بشرطات مائلة خلفية (‘\’).

bye الخروج من sftp.

cd [path]
    تغيير الدليل البعيد إلى path. إذا لم يُحدد path ، فسيُغير الدليل إلى الدليل الذي بدأت فيه الجلسة.

chgrp
    [-h] grp path تغيير مجموعة الملف path إلى grp. قد يحتوي path على محارف glob(7) وقد يطابق ملفات متعددة. يجب أن يكون grp معرف مجموعة GID عدديًا.

    إذا حُددت علامة -h ، فلن تُتبع الروابط الرمزية. لاحظ أن هذا مدعوم فقط من قبل الخواديم التي تطبق امتداد "lsetstat@openssh.com".

chmod
    [-h] mode path تغيير صلاحيات الملف path إلى mode. قد يحتوي path على محارف glob(7) وقد يطابق ملفات متعددة.

    إذا حُددت علامة -h ، فلن تُتبع الروابط الرمزية. لاحظ أن هذا مدعوم فقط من قبل الخواديم التي تطبق امتداد "lsetstat@openssh.com".

chown
    [-h] own path تغيير مالك الملف path إلى own. قد يحتوي path على محارف glob(7) وقد يطابق ملفات متعددة. يجب أن يكون own معرف مستخدم UID عدديًا.

    إذا حُددت علامة -h ، فلن تُتبع الروابط الرمزية. لاحظ أن هذا مدعوم فقط من قبل الخواديم التي تطبق امتداد "lsetstat@openssh.com".

copy oldpath newpath
    نسخ ملف بعيد من oldpath إلى newpath.

    لاحظ أن هذا مدعوم فقط من قبل الخواديم التي تطبق امتداد "copy-data".

cp oldpath newpath
    بديل لأمر copy.

df  [-hi] [path] عرض معلومات الاستخدام لنظام الملفات الذي يحتوي على الدليل الحالي (أو path في حال حُدد). إذا حُددت العلامة -h ، فستُعرض معلومات السعة باستخدام لواحق "مقروءة للبشر". تطلب العلامة -i عرض معلومات الفهرس (inode) بالإضافة إلى معلومات السعة. هذا الأمر مدعوم فقط على الخواديم التي تطبق امتداد “statvfs@openssh.com”.

exit
    الخروج من sftp.

get [-afpR] remote-path [local-path] جلب remote-path وتخزينه على الجهاز المحلي. إذا لم يُحدد اسم المسار المحلي، فسيُعطى نفس الاسم الذي يحمله على الجهاز البعيد. قد يحتوي remote-path على محارف glob(7) وقد يطابق ملفات متعددة. إذا حدث ذلك وحُدد local-path ، فيجب أن يحدد local-path دليلاً.

    إذا حُددت علامة -a ، فستُحاول استئناف عمليات النقل الجزئية للملفات الموجودة. لاحظ أن الاستئناف يفترض أن أي نسخة جزئية من الملف المحلي تطابق النسخة البعيدة. إذا اختلفت محتويات الملف البعيد عن النسخة المحلية الجزئية، فمن المرجح أن يكون الملف الناتج معطوباً.

    إذا حُددت علامة -f ، فسيُستدعى fsync(2) بعد اكتمال نقل الملف لتفريغ الملف إلى القرص.

    إذا حُددت علامة -p ، فستُنسخ أيضًا صلاحيات الملف الكاملة وأوقات الوصول.

    إذا حُددت علامة -R ، فستُنسخ الأدلة تكرارياً. لاحظ أن sftp لا يتبع الروابط الرمزية عند إجراء عمليات النقل التكرارية.

help
    عرض نص المساعدة.

lcd [path]
    تغيير الدليل المحلي إلى path. إذا لم يُحدد path ، فسيُغير الدليل إلى الدليل المنزلي للمستخدم المحلي.

lls [ls-options [path]]
    عرض قائمة الدليل المحلي إما لـ path أو الدليل الحالي في حال لم يُحدد path. قد يحتوي ls-options على أي علامات يدعمها أمر ls(1) للنظام المحلي. قد يحتوي path على محارف glob(7) وقد يطابق ملفات متعددة.

lmkdir path
    إنشاء الدليل المحلي المحدد بواسطة path.

ln  [-s] oldpath newpath إنشاء رابط من oldpath إلى newpath. إذا حُددت علامة -s ، فسيكون الرابط المنشأ رابطاً رمزياً، وإلا فسيكون رابطاً صلباً.

lpwd
    طباعة دليل العمل المحلي.

ls  [-1afhlnrSt] [path] عرض قائمة دليل بعيد إما لـ path أو الدليل الحالي في حال لم يُحدد path. قد يحتوي path على محارف glob(7) وقد يطابق ملفات متعددة.

    يُتعرف على العلامات التالية وتغير سلوك ls وفقاً لذلك:

    -1  إنتاج خرج في عمود واحد.

    -a  سرد الملفات التي تبدأ بنقطة (‘’)..

    -f  عدم فرز القائمة. ترتيب الفرز المبدئي هو المعجمي.

    -h  عند الاستخدام مع خيار التنسيق الطويل، استخدم لواحق الوحدات: بايت، كيلوبايت، ميجابايت، جيجابايت، تيرابايت، بيتابايت، وإكسابايت لتقليل عدد الأرقام إلى أربعة أو أقل باستخدام قوى 2 للأحجام (K=1024، M=1048576، إلخ).

    -l  عرض تفاصيل إضافية بما في ذلك معلومات الصلاحيات والملكية.

    -n  إنتاج قائمة طويلة مع عرض معلومات المستخدم والمجموعة رقمياً.

    -r  عكس ترتيب فرز القائمة.

    -S  فرز القائمة حسب حجم الملف.

    -t  فرز القائمة حسب وقت آخر تعديل.

lumask umask
    ضبط قناع umask المحلي إلى umask.

mkdir path
    إنشاء الدليل البعيد المحدد بواسطة path.

progress
    تبديل عرض مقياس التقدم.

put [-afpR] local-path [remote-path] رفع local-path وتخزينه على الجهاز البعيد. إذا لم يُحدد اسم المسار البعيد، فسيُعطى نفس الاسم الذي يحمله على الجهاز المحلي. قد يحتوي local-path على محارف glob(7) وقد يطابق ملفات متعددة. إذا حدث ذلك وحُدد remote-path ، فيجب أن يحدد remote-path دليلاً.

    إذا حُددت علامة -a ، فستُحاول استئناف عمليات النقل الجزئية للملفات الموجودة. لاحظ أن الاستئناف يفترض أن أي نسخة جزئية من الملف البعيد تطابق النسخة المحلية. إذا اختلفت محتويات الملف المحلي عن النسخة البعيدة الجزئية، فمن المرجح أن يكون الملف الناتج معطوباً.

    إذا حُددت علامة -f ، فسيُرسل طلب إلى الخادوم لاستدعاء fsync(2) بعد نقل الملف. لاحظ أن هذا مدعوم فقط من قبل الخواديم التي تطبق امتداد "fsync@openssh.com".

    إذا حُددت علامة -p ، فستُنسخ أيضًا صلاحيات الملف الكاملة وأوقات الوصول.

    إذا حُددت علامة -R ، فستُنسخ الأدلة تكرارياً. لاحظ أن sftp لا يتبع الروابط الرمزية عند إجراء عمليات النقل التكرارية.

pwd عرض دليل العمل البعيد.

quit
    الخروج من sftp.

reget
    [-fpR] remote-path [local-path] استئناف تنزيل remote-path. يعادل get مع تعيين علامة -a.

reput
    [-fpR] local-path [remote-path] استئناف رفع local-path. يعادل put مع تعيين علامة -a.

rename oldpath newpath
    تغيير اسم ملف بعيد من oldpath إلى newpath.

rm path
    حذف الملف البعيد المحدد بواسطة path.

rmdir path
    إزالة الدليل البعيد المحدد بواسطة path.

symlink oldpath newpath
    إنشاء رابط رمزي من oldpath إلى newpath.

version
    عرض إصدار بروتوكول sftp.

!command
    تنفيذ command في صدفة محلية.

!   الهروب إلى صدفة محلية.

?   مرادف للمساعدة (help).

انظر أيضًا
ftp(1), ls(1), scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), glob(7), sftp-server(8), sshd(8) T. Ylonen, S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh-filexfer-00.txt, January 2001, عمل جاري تقديمه.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3: https://www.gnu.org/licenses/gpl-3.0.html أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.