Differences
This shows you the differences between the selected revisions of the page.
| protocols 2009-03-05 | protocols 2023-12-06 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Supported Transfer Protocols ====== | + | ====== Supported File Transfer Protocols ====== |
| - | As of version 4.0, WinSCP supports three transfer protocols, SFTP, FTP and SCP. Currently, many servers support all three protocols. This document contains a comparison to help you to decide which is most appropriate for your needs. The comparison describes both features that are characteristic to the specific protocol as-is, and features that are caused by the implementation of the protocol in WinSCP. | + | WinSCP supports five transfer protocols: |
| + | * [[sftp|SFTP]] (SSH File Transfer Protocol); | ||
| + | * [[ftp|FTP]] (File Transfer Protocol); | ||
| + | * [[scp|SCP]] (Secure Copy Protocol); | ||
| + | * [[webdav|WebDAV]] (Web Distributed Authoring and Versioning); | ||
| + | * [[s3|S3]] (Amazon S3). | ||
| - | The default mode of operation is to use SFTP and fall back to SCP. Select your preferred protocol on [[ui_login_session#protocol_group|Login dialog]]. | + | Some servers support more than one of these protocols. This document contains a comparison to help you to decide which is most appropriate for your needs. The comparison describes both features that are characteristic to the specific protocol as-is, and features that are caused by the implementation of the protocol in WinSCP. |
| - | ===== [[sftp]] SFTP (SSH File Transfer Protocol) ===== | + | The default mode of operation is to use SFTP and fall back to SCP. Select your preferred protocol on [[ui_login#session_settings|Login dialog]]. |
| - | Despite SSH in its name, it is designed to work over any reliable data stream, but WinSCP supports only operation over SSH, which is also by far its most common usage. | + | |
| - | + | ||
| - | Being operated over SSH, it is secure protocol. In its basic functionally it is similar to old FTP, while having better designed advanced functionality. Unfortunately not all SFTP server implementations take advantage of the advanced features, yet. | + | |
| - | + | ||
| - | Especially in its later versions (from 4 upwards), it is more platform independent, compared to both FTP and SCP. | + | |
| - | + | ||
| - | Unlike SCP, for connection with an SFTP server you do not need access to shell (although some implementations may still require that). | + | |
| - | + | ||
| - | ===== [[scp]] SCP (Secure Copy Protocol) ===== | + | |
| - | SCP is mostly used with SSH-1. SCP is an older protocol but almost universally supported on Unix-like platforms as part of an SSH protocol suite. It is rarely supported on other platforms. SCP is a descendant of the ancient "rcp." | + | |
| - | + | ||
| - | The SCP protocol allows only file transfers in both directions. WinSCP is able to offer other features, implemented using common shell commands like ''cd'', ''ls'', ''pwd'', ''rm'', ''ln'', etc. For this, WinSCP---unlike command-line SCP clients (which allow only file transfers)---requires full shell access and permission to execute other commands in addition to ''scp'' (see [[requirements]]). For access to non-UNIX servers it is necessary that the server have at least a UNIX-like shell. | + | |
| - | + | ||
| - | ===== [[ftp]] FTP (File Transfer Protocol) ===== | + | |
| - | FTP, being the oldest of the three, is most widespread transfer protocol of nowadays. In its basic form it inherently insecure, sending all data (including passwords) unencrypted. There is also secure variants ([[ftps|FTP over TLS/SSL]]). FTP is functionally inferior to SFTP. Also it is less platform independent than later versions of SFTP, mainly in respect to directory listing. | + | |
| ===== Protocol Comparison ===== | ===== Protocol Comparison ===== | ||
| Line 25: | Line 15: | ||
| The list below shows only those features which differ between the protocols, so it is not complete listing. | The list below shows only those features which differ between the protocols, so it is not complete listing. | ||
| - | ^ Feature ^ SFTP ^ FTP ^ SCP ^ | + | ^ Feature ^ SFTP ^ FTP ^ WebDAV ^ SCP ^ |
| - | ^ Security | Secure (SSH) | Optionally secure ([[ftps|FTP over TLS/SSL]]) | Secure (SSH). | | + | ^ Security | Secure (SSH) | Optionally secure ([[ftps|Over TLS/SSL]]) || Secure (SSH). | |
| - | ^ Speed | Generally slowest (encryption and necessity to wait for packet confirmations). | Generally fastest file transfer (no encryption and efficient file transfer), yet transfer setup is slow, so transfer of large number of small files can be slow. | Medium (encryption, but efficient file transfer, yet it does not allow the transfer to be interrupted). | | + | ^ Speed | Generally slowest (encryption and necessity to wait for packet confirmations). | Generally fastest file transfer (no encryption and efficient file transfer), yet transfer setup is slow, so transfer of large number of small files can be slow. || Medium (encryption, but efficient file transfer, yet it does not allow the transfer to be interrupted). | |
| - | ^ [[resume|Transfer resume]] | Supported. WinSCP supports resuming only since SFTP-2 (which introduces rename command). | Supported. | Unsupported. | | + | ^ [[resume|Transfer resume]] | Supported. WinSCP supports resuming only since SFTP-2 (which introduces rename command). | Supported. | Unsupported. | Unsupported by WinSCP. | |
| - | ^ Large files | Supports files over 4 GiB (uses 64-bit sizes). | Supports files over 4 GiB. | Does not support files over 4 GiB (32-bit boundary). | | + | ^ Append to end of file | Supported. | Supported. Unsupported by WinSCP. | Unsupported. | Unsupported. | |
| - | ^ Append to end of file | Supported. | Supported. Unsupported by WinSCP. | Unsupported. | | + | ^ [[ui_progress#controlling|Transfer cancellation]] | Supported. | Supported, but can be time-consuming. | Supported. | Transfer cannot be canceled without termination of session. | |
| - | ^ [[ui_progress#controlling_the_operation|Transfer cancellation]] | Supported. | Supported, but can be time-consuming. | Transfer cannot be canceled without termination of session. | | + | ^ Text (ASCII) [[transfer_mode|transfer mode]] | Supported since SFTP-4. For older versions WinSCP emulates text mode by converting files before transfer. | Supported. | Unsupported. | Not supported by the protocol. WinSCP emulates text mode by converting file before transfer. | |
| - | ^ Text (ASCII) [[transfer_mode|transfer mode]] | Supported since SFTP-4. For older versions WinSCP emulates text mode by converting files before transfer. | Supported. | Not supported by the protocol. WinSCP emulates text mode by converting file before transfer. | | + | ^ Directory operations | Recursive operations with directories (deletion, permissions change) must be performed separately for each file. Thus operations can take a long time, especially for directories with a large number of files. ||| Recursive operations with directories (deletion, permissions change), can be done with a single command (''rm'', ''chmod'', etc). Thus they are quick. On the other hand it limits some functionality. | |
| - | ^ Directory operations | Recursive operations with directories (deletion, permissions change) must be performed separately for each file. Thus operations can take a long time, especially for directories with a large number of files. || Recursive operations with directories (deletion, permissions change), can be done with a single command (''rm'', ''chmod'', etc). Thus they are quick. On the other hand it limits some functionality. | | + | ^ [[task_rename|File renaming]] and [[task_move_duplicate#move|moving]] | Supported since SFTP-2. | Supported. | Supported. | Supported (''mv''). | |
| - | ^ [[task_rename|File renaming]] and [[task_move_duplicate#moving_remote_files|moving]] | Supported since SFTP-2. | Supported. | Supported (''mv''). | | + | ^ ==?duplicate== Direct [[task_move_duplicate#duplicate|File duplication]] | The server has to support %%SFTP%% extension ''copy-file'' (supported by [[http://www.proftpd.org/docs/contrib/mod_sftp.html|ProFTPD ''mod_sftp'']] for example) or ''copy-data'' (supported by OpenSSH for example). WinSCP can open a [[shell_session|separate shell session]] to duplicate the file instead. | WinSCP supports [[http://www.proftpd.org/docs/contrib/mod_copy.html|ProFTPD ''mod_copy'']] commands ''SITE CPFR''/''CPTO''. No other %%FTP%% server supporting file duplication is known. | Supported. | Supported (''cp''). | |
| - | ^ Direct [[task_move_duplicate#duplicating_remote_files|File duplication]] | Unsupported by the protocol. WinSCP can open a [[shell_session|separate shell session]] to execute the command. | Unsupported. | Supported (''cp''). | | + | ^ ==?command== [[remote_command|Execution of arbitrary command]] | Unsupported by the protocol. WinSCP can open a [[shell_session|separate shell session]] to execute the command. | Unsupported. WinSCP allows user to execute arbitrary protocol command. | Unsupported. | Supported as long as the command does not require user input. | |
| - | ^ [[remote_command|Execution of arbitrary command]] | Unsupported by the protocol. WinSCP can open a [[shell_session|separate shell session]] to execute the command. | Unsupported. WinSCP allows user to execute arbitrary protocol command. | Supported as long as the command does not require user input. | | + | ^ [[ui_transfer_custom#upload|Setting properties (time-stamp, permissions) of uploaded files]] | Supported. | Server needs to support ''MFMT'' extension. | Only few servers support setting time-stamp. | Supported. | |
| - | ^ [[ui_transfer#upload_options|Setting properties (time-stamp, permissions) of uploaded files]] | Supported. | Server needs to support ''MFMT'' extension. | Supported. | | + | ^ [[task_properties|Owner or group change]] | In SFTP-2 and SFTP-3, the owner and group can be changed only with knowledge of UID/GID. Since SFTP-4 even change using user or group name is allowed. | Supported (''MFF''). Unsupported by WinSCP. | Unsupported. | Supported (''chown'', ''chgrp''). | |
| - | ^ [[task_properties|Owner or group change]] | In SFTP-2 and SFTP-3, the owner and group can be changed only with knowledge of UID/GID. Since SFTP-4 even change using user or group name is allowed. | Supported (MFF). Unsupported by WinSCP. | Supported (''chown'', ''chgrp''). | | + | ^ ==?checksum== [[ui_properties#checksum|Checksum calculation]] | Supported, if the server supports respective SFTP protocol extension or when WinSCP can use a [[shell_session|separate shell session]] to calculate the checksum using shell commands. | Supported (''HASH'', ''XSHA1'', ''XSHA256'', ''XSHA512'', ''MD5'', ''XMD5'', ''XCRC''). | Unsupported. | Unsupported. | |
| - | ^ [[ui_properties#checksum|Checksum calculation]] | Supported, if the server supports respective SFTP protocol extension. | Supported (XCRC, XMD5, XSHA). Unsupported by WinSCP. | Unsupported. | | + | ^ ==?disk_usage== [[ui_fsinfo#space|Checking disk usage]] | Supported, if the server supports respective SFTP protocol extension (SFTP-5 or proprietary OpenSSH extension ''statvfs@openssh.com''). | Supported (''AVBL'', ''XQUOTA''). Only new servers support it. | Only some servers support it. | Unsupported. Pre-defined [[custom_command|custom command]] //Disk Space Usage// (''df'') can be used as an alternative. | |
| - | ^ [[task_link|Link creation]] | It is possible to create and edit symbolic links since SFTP-3. Hard links are supported only since SFTP-6 (unsupported by WinSCP). | Unsupported. | It is possible to create both symbolic and hard links (''ln''). Symbolic links can be edited also. | | + | ^ ==?link== [[task_link|Link creation]] | It is possible to create and edit symbolic links since SFTP-3. It is possible to create hard links, if the server supports respective SFTP protocol functionality (SFTP-6 or proprietary OpenSSH extension ''hardlink@openssh.com''). | WinSCP supports [[http://www.proftpd.org/docs/contrib/mod_site_misc.html|ProFTPD ''mod_site_misc'']] command ''SITE SYMLINK''. No other FTP server supporting link creation is known. | Unsupported. | It is possible to create both symbolic and hard links (''ln''). Symbolic links can be edited also. | |
| - | ^ User group list lookup | Unsupported. | Unsupported. | Supported (''groups''). | | + | ^ User group list lookup | Unsupported. | Unsupported. | Unsupported. | Supported (''groups''). | |
| - | ^ Influence of environment variables | Generally unaffected by environment variables. || As WinSCP uses shell, it is influenced by environment variables (date format, etc.). WinSCP requires the English environment. See [[requirements]]. | | + | ^ Influence of environment variables | Generally unaffected by environment variables. ||| As WinSCP uses shell, it is influenced by environment variables (date format, etc.). WinSCP requires the English environment. See [[requirements]]. | |
| - | ^ File modification [[timestamp|time-stamp]] | Theoretically the problem does not occur, as the protocol requires timestamps to be in UTC. Practically some of the SFTP servers have problems with DST. | Supported | Some shell commands are influenced by daylight-saving time. For example, the ''ls'' command can return a different time than ''scp''. Thus, after transfer, the time-stamp of the file can be different. Also there can be an additional difference caused by the server timezone offset. This causes trouble when comparing directories and [[task_synchronize|synchronization]]. | | + | ^ Time zone and DST issues with [[timestamp|file time-stamps]] | Theoretically no issues, as the protocol requires timestamps to be in UTC. Practically some of the SFTP servers have problems with DST. | Theoretically no issues, when the server supports ''MLSD'' command, as the comment requires timestamps to be in UTC. Practically some of the FTP servers have problems with DST. When the server supports ''LIST'' command only, behavior is undefined and time zone offset may need to be configured. | Theoretically no issues. | Some shell commands are influenced by daylight-saving time. For example, the ''ls'' command can return a different time than ''scp''. Thus, after transfer, the time-stamp of the file can be different. Also there can be an additional difference caused by the server time zone offset. This causes trouble when comparing directories and [[task_synchronize|synchronization]]. | |
| - | ^ [[ui_login|Configuration]] | Generally, only login information is needed. || For a successful connection to a server it is often necessary to properly set up several configuration options on the [[ui_login_scp|Login dialog]]. | | + | ^ [[ui_login|Configuration]] | Generally, only login information is needed. ||| For a successful connection to a server it is often necessary to properly set up several configuration options on the //[[ui_login_scp|SCP/Shell page]]// of Advanced Site Settings dialog. | |