الاسم

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 and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh-filexfer-00.txt, January 2001, عمل جاري تقديمه.

ترجمة

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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