本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用用戶端透過伺服器端點傳輸檔案
您可以在用戶端中指定傳輸操作，透過 AWS Transfer Family 服務傳輸檔案。 AWS Transfer Family 支援下列用戶端：
+ 我們支援 SFTP 通訊協定的第 3 版。
+ OpenSSH (macOS 和 Linux)
**注意**
此用戶端僅適用於啟用 Secure Shell (SSH) 檔案傳輸通訊協定 (SFTP) 的伺服器。
+ WinSCP (僅限 Microsoft Windows)
+ Cyberduck (Windows、macOS 和 Linux)
+ FileZilla (Windows、macOS 和 Linux)
下列限制適用於每個用戶端：
+ 不支援 SCP 通訊協定，因為它被視為不安全。您可以使用 OpenSSH `scp`命令，如中所述[使用 `scp`命令](#openssh-scp)。
+ 每個連線的並行多工 SFTP 工作階段數目上限為 10。
+ 對於閒置連線，所有通訊協定 (SFTP/FTP/FTPS) 的逾時值為 1800 秒 (30 分鐘）。如果在此期間之後沒有活動，用戶端可能會中斷連線。對於沒有回應的連線：
+ 當用戶端完全沒有回應時，SFTP 會有 300 秒 (5 分鐘） 的逾時。
+ FTPS 和 FTP 有大約 10 分鐘的無回應逾時，由基礎程式庫處理。
+ Amazon S3 和 Amazon EFS （由於 NFSv4 通訊協定） 需要檔案名稱為 UTF-8 編碼。使用不同的編碼可能會導致非預期的結果。對於 Amazon S3，請參閱[物件金鑰命名準則](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines)。
+ 對於透過 SSL (FTPS) 的檔案傳輸通訊協定，僅支援明確模式。不支援隱含模式。
+ 對於檔案傳輸通訊協定 (FTP) 和 FTPS，僅支援被動模式。
+ 對於 FTP 和 FTPS，僅支援 STREAM 模式。
+ 對於 FTP 和 FTPS，僅支援映像/二進位模式。
+ 對於 FTP 和 FTPS，資料連線的 TLS - PROT C （未受保護） TLS 是預設值，但 AWS Transfer Family FTPS 通訊協定不支援 PROT C。因此，對於 FTPS，您需要發出 PROT P 才能接受您的資料操作。
+ 如果您使用 Amazon S3 做為伺服器的儲存體，而且您的用戶端包含使用多個連線進行單一傳輸的選項，請務必停用該選項。否則，大型檔案上傳可能會以無法預測的方式失敗。請注意，如果您使用 Amazon EFS 做為儲存後端，EFS *會*支援單一傳輸的多個連線。
以下是 FTP 和 FTPS 的可用命令清單：
| 可用命令 |
| --- |
| ABOR | FEAT | MLST | PASS | RETR | STOR |
| AUTH | LANG | MKD | PASV | RMD | STOU |
| CDUP | LIST | MODE | PBSZ | RNFR | STRU |
| CWD | MDTM | NLST | PROT | RNTO | SYST |
| 刪除 | MFMT | NOOP | PWD | SIZE | TYPE |
| EPSV | MLSD | OPTS | 結束 | STAT | USER |
**注意**
不支援 APPE。
對於 SFTP，在使用 Amazon Elastic File System (Amazon EFS) 的伺服器上使用邏輯主目錄的使用者目前不支援下列操作。
| 不支援的 SFTP 命令 |
| --- |
| SSH\$1FXP\$1READLINK | SSH\$1FXP\$1SYMLINK | 當請求的檔案為符號連結時，SSH\$1FXP\$1STAT | 當請求的路徑包含任何符號連結元件時，SSH\$1FXP\$1REALPATH |
**產生公有/私有金鑰對**
您必須先有公有/私有金鑰對可用，才能傳輸檔案。如果您先前尚未產生金鑰對，請參閱 [為服務受管使用者產生 SSH 金鑰](sshkeygen.md)。
**Topics**
+ [可用的 SFTP/FTPS/FTP 命令](#transfer-sftp-commands)
+ [尋找您的 Amazon VPC 端點](#find-vpc-endpoint)
+ [避免`setstat`錯誤](#avoid-set-stat)
+ [使用 OpenSSH](#openssh)
+ [使用 WinSCP](#winscp)
+ [使用 Cyberduck](#cyberduck)
+ [使用 FileZilla](#filezilla)
+ [使用 Perl 用戶端](#using-clients-with-perl-modules)
+ [使用 LFTP](#using-client-lftp)
+ [上傳後處理](#post-processing-upload)
+ [SFTP 訊息](#sftp-transfer-activity-types)
## 可用的 SFTP/FTPS/FTP 命令
下表說明 SFTP AWS Transfer Family、FTPS 和 FTP 通訊協定的可用命令。
**注意**
資料表提及 Amazon S3 *的檔案*和*目錄*，僅支援儲存貯體和物件：沒有階層。不過，您可以在物件金鑰名稱中使用字首來暗示階層，並以類似資料夾的方式整理資料。此行為說明於《*Amazon Simple Storage Service 使用者指南*》中的[使用物件中繼資料](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html)。
**SFTP/FTPS/FTP 命令**
| 命令 | Amazon S3 | Amazon EFS |
| --- | --- | --- |
| cd | 支援 | 支援 |
| chgrp | 不支援 | 支援 (rootowner僅限 或 ) |
| chmod | 不支援 | 支援 (root僅限 ) |
| chmtime | 不支援 | 支援 |
| chown | 不支援 | 支援 (root僅限 ) |
| get | 支援 | 支援 （包括解析符號連結） |
| ln -s | 不支援 | 支援 |
| ls/dir | 支援 | 支援 |
| mkdir | 支援 | 支援 |
| put | 支援 | 支援 |
| pwd | 支援 | 支援 |
| rename | 僅支援 檔案 不支援覆寫現有檔案的重新命名。 | 支援 不支援覆寫現有檔案或目錄的重新命名。 |
| rm | 支援 | 支援 |
| rmdir | 支援 （僅限空白目錄） | 支援 |
| version | 支援 | 支援 |
## 尋找您的 Amazon VPC 端點
如果 Transfer Family 伺服器的端點類型是 VPC，則識別用於傳輸檔案的端點並不簡單。在此情況下，請使用下列程序來尋找您的 Amazon VPC 端點。
**尋找您的 Amazon VPC 端點**
1. 導覽至伺服器的詳細資訊頁面。
1. 在**端點詳細資訊**窗格中，選取 **VPC**。
![\[\]](http://docs.aws.amazon.com/zh_tw/transfer/latest/userguide/images/server-details-endpoint-vpc.png)
1. 在 Amazon VPC 儀表板中，選取 **VPC 端點 ID**。
1. 在 **DNS 名稱**清單中，您的伺服器端點是列出的第一個端點。
![\[\]](http://docs.aws.amazon.com/zh_tw/transfer/latest/userguide/images/server-details-endpoint-vpc-2.png)
## 避免`setstat`錯誤
有些 SFTP 檔案傳輸用戶端可以在上傳檔案時使用 SETSTAT 等命令，嘗試變更遠端檔案的屬性，包括時間戳記和許可。不過，這些命令與 Amazon S3 等物件儲存系統並不相容。由於這種不相容性，即使已成功上傳檔案，從這些用戶端上傳檔案也可能導致錯誤。
+ 當您呼叫 `CreateServer`或 `UpdateServer` API 時，請使用 `ProtocolDetails`選項`SetStatOption`來忽略當用戶端嘗試在您上傳至 S3 儲存貯體的檔案上使用 SETSTAT 時所產生的錯誤。
+ 將值設定為 `ENABLE_NO_OP`，讓 Transfer 系列伺服器忽略 SETSTAT 命令，並上傳檔案，而不需要對 SFTP 用戶端進行任何變更。
+ 請注意，雖然`SetStatOption``ENABLE_NO_OP`設定會忽略錯誤，但*會在* CloudWatch Logs 中產生日誌項目，因此您可以判斷用戶端何時進行 SETSTAT 呼叫。
如需此選項的 API 詳細資訊，請參閱 [ProtocolDetails](https://docs.aws.amazon.com/transfer/latest/APIReference/API_ProtocolDetails.html)。
## 使用 OpenSSH
本節包含使用 OpenSSH 從命令列傳輸檔案的說明。
**注意**
此用戶端僅適用於啟用 SFTP 的伺服器。
**Topics**
+ [使用 OpenSSH](#openssh-use)
+ [使用 `scp`命令](#openssh-scp)
### 使用 OpenSSH
**AWS Transfer Family 使用 OpenSSH 命令列公用程式傳輸檔案**
1. 在 Linux、macOS 或 Windows 上，開啟命令終端機。
1. 在提示中，輸入下列命令：
`sftp -i transfer-key sftp_user@service_endpoint`
在上述命令中， `sftp_user` 是使用者名稱，而 `transfer-key`是 SSH 私有金鑰。此處`service_endpoint`是伺服器端點，如所選伺服器的 AWS Transfer Family 主控台所示。
**注意**
此命令會使用預設`ssh_config`檔案中的設定。除非您先前已編輯過此檔案，否則 SFTP 會使用連接埠 22。您可以將**-P**旗標新增至命令來指定不同的連接埠 （例如 2222)，如下所示。
```
sftp -P 2222 -i transfer-key sftp_user@service_endpoint
```
或者，如果您一律想要使用連接埠 2222 或連接埠 22000，您可以更新 `ssh_config` 檔案中的預設連接埠。
應會出現 `sftp` 提示。
1. （選用） 若要檢視使用者的主目錄，請在`sftp`提示中輸入下列命令：
`pwd`
1. 若要將檔案從檔案系統上傳至 Transfer Family 伺服器，請使用 `put`命令。例如，若要上傳 `hello.txt`（假設檔案位於檔案系統的目前目錄中），請在`sftp`提示下執行下列命令：
`put hello.txt`
隨即出現類似以下內容的訊息，指出檔案傳輸正在進行中或已完成。
`Uploading hello.txt to /amzn-s3-demo-bucket/home/sftp_user/hello.txt`
`hello.txt 100% 127 0.1KB/s 00:00`
**注意**
建立伺服器之後，可能需要幾分鐘的時間，伺服器端點主機名稱才能由環境中的 DNS 服務解析。
### 使用 `scp`命令
Transfer Family 不支援 SCP 通訊協定。不過，如果您需要此功能，您可以使用 OpenSSH `scp`命令。
透過 SFTP 使用 SCP 的建議是使用 OpenSSH 9.0 版或更新版本。在 OpenSSH 第 9 版及更新版本中，`scp`命令預設為使用 SFTP 通訊協定進行檔案傳輸，而非舊版 SCP 通訊協定。
**重要**
確保您的 Transfer Family 伺服器已設定為使用 S3 最佳化目錄存取。
## 使用 WinSCP
使用下列說明使用 WinSCP 從命令列傳輸檔案。
**注意**
如果您使用的是 WinSCP 5.19，則可以使用登入 AWS 資料直接連線至 Amazon S3，並上傳/下載檔案。如需詳細資訊，請參閱[連線至 Amazon S3 服務](https://winscp.net/eng/docs/guide_amazon_s3)。
**AWS Transfer Family 使用 WinSCP 傳輸檔案**
1. 開啟 WinSCP 用戶端。
1. 在**登入**對話方塊中，針對**檔案通訊協定**選擇通訊協定：**SFTP** 或 **FTP**。
如果您選擇 FTP，請針對**加密**選擇下列其中一項：
+ FTP **無加密**
+ FTPS 的 **TLS/SSL 明確加密**
1. 針對 **Host name (主機名稱)**，輸入您的伺服器端點。伺服器端點位於**伺服器詳細資訊**頁面上。如需詳細資訊，請參閱[檢視 SFTP、FTPS 和 FTP 伺服器詳細資訊](configuring-servers-view-info.md)。
如果您的伺服器使用 VPC 端點，請參閱 [尋找您的 Amazon VPC 端點](#find-vpc-endpoint)。
1. 針對**連接埠號碼**，輸入下列項目：
+ **22** 適用於 SFTP
+ **21** 適用於 FTP/FTPS
1. 針對**使用者名稱**，輸入您為特定身分提供者建立的使用者名稱。
**秘訣：**使用者名稱應該是您為身分提供者建立或設定的使用者之一。 AWS Transfer Family 提供下列身分提供者：
+ [使用服務受管使用者](service-managed-users.md)
+ [使用 AWS Directory Service for Microsoft Active Directory](directory-services-users.md)
+ [使用自訂身分提供者](custom-idp-intro.md)
1. 選擇**進階**以開啟**進階網站設定**對話方塊。在 **SSH** 區段中，選擇**身分驗證**。
1. 對於**私有金鑰檔案**，瀏覽 ，然後從檔案系統選擇 SSH 私有金鑰檔案。
如果 WinSCP 提供將 SSH 私有金鑰轉換為 PPK 格式，請選擇**確定**。
1. 選擇 **OK (確定)** 返回 **Login (登入)** 對話方塊，然後選擇 **Save (儲存)**。
1. 在將**工作階段另存為網站**對話方塊中，選擇**確定**以完成連線設定。
1. 在**登入**對話方塊中，選擇**工具**，然後選擇**偏好設定**。
1. 在**偏好設定**對話方塊中，針對**轉接**，選擇**耐久度**。
針對**啟用傳輸繼續/傳輸到暫時檔案名稱的選項**，選擇**停用**。
**重要**
如果您啟用此選項，會增加上傳成本，大幅降低上傳效能。它也可能導致大型檔案上傳失敗。
1. 針對**轉接**，選擇**背景**，然後清除**針對單一轉接使用多個連線**核取方塊。
**秘訣：**如果您選取此選項，大型檔案上傳可能會以無法預測的方式失敗。例如，可以建立產生 Amazon S3 費用的孤立分段上傳。也可能發生靜音資料損毀。
1. 執行檔案傳輸。
您可以使用drag-and-drop方法來複製目標和來源視窗之間的檔案。您可以使用工具列圖示來上傳、下載、刪除、編輯或修改 WinSCP 中檔案的屬性。
**注意**
如果您使用 Amazon EFS 進行儲存，則不適用此備註。
嘗試變更遠端檔案屬性的命令，包括時間戳記，與 Amazon S3 等物件儲存系統不相容。因此，如果您使用 Amazon S3 進行儲存，請務必先停用 WinSCP 時間戳記設定 （或使用 `SetStatOption`中所述的 [避免`setstat`錯誤](#avoid-set-stat))，再執行檔案傳輸。若要這樣做，請在 **WinSCP Transfer 設定**對話方塊中停用**設定許可**上傳選項和**保留時間戳記**常用選項。
## 使用 Cyberduck
使用下列說明使用 Cyberduck 從命令列傳輸檔案。
**AWS Transfer Family 使用 Cyberduck 傳輸檔案**
1. 開啟 [Cyberduck](https://cyberduck.io/download/) 用戶端。
1. 選擇**開啟連線**。
1. 在**開啟連線**對話方塊中，選擇通訊協定：**SFTP (SSH 檔案傳輸通訊協定）**、**FTP-SSL （明確 AUTH TLS)** 或 **FTP （檔案傳輸通訊協定）**。
1. 在**伺服器**中，輸入您的伺服器端點。伺服器端點位於**伺服器詳細資訊**頁面上。如需詳細資訊，請參閱[檢視 SFTP、FTPS 和 FTP 伺服器詳細資訊](configuring-servers-view-info.md)。
如果您的伺服器使用 VPC 端點，請參閱 [尋找您的 Amazon VPC 端點](#find-vpc-endpoint)。
1. 針對**連接埠號碼**，輸入下列項目：
+ **22** 適用於 SFTP
+ **21** 適用於 FTP/FTPS
1. 針對 **Username (使用者名稱)**，輸入您在[管理伺服器端點的使用者](create-user.md)中建立的使用者名稱。
1. 如果選取 SFTP，請針對 **SSH 私有金鑰**選擇或輸入 SSH 私有金鑰。
1. 選擇**連線**。
1. 執行檔案傳輸。
根據檔案所在位置，執行以下其中一項：
+ 在本機目錄 （來源） 中，選擇您要傳輸的檔案，然後將它們拖放到 Amazon S3 目錄 （目標）。
+ 在 Amazon S3 目錄 （來源） 中，選擇您要傳輸的檔案，然後將它們拖放到您的本機目錄 （目標）。
## 使用 FileZilla
使用下列指示來使用 FileZilla 傳輸檔案。
**設定檔案傳輸的 FileZilla**
1. 開啟 FileZilla 用戶端。
1. 選擇**檔案**，然後選擇 **Site Manager**。
1. 在**站台管理員**對話方塊中，選擇**新站台**。
1. 在**一般**索引標籤上，針對**通訊協定**，選擇通訊協定：**SFTP** 或 **FTP**。
如果您選擇 FTP，請針對**加密**選擇下列其中一項：
+ **僅使用純 FTP （不安全）** – 適用於 FTP
+ **如果可用，透過 TLS 使用明確的 FTP** – 適用於 FTPS
1. 針對**主機名稱**，輸入您正在使用的通訊協定，後面接著伺服器端點。伺服器端點位於**伺服器詳細資訊**頁面上。如需詳細資訊，請參閱[檢視 SFTP、FTPS 和 FTP 伺服器詳細資訊](configuring-servers-view-info.md)。
+ 如果您使用的是 SFTP，請輸入： `sftp://hostname`
+ 如果您使用的是 FTPS，請輸入： `ftps://hostname`
請務必將*主機名稱*取代為實際的伺服器端點。
如果您的伺服器使用 VPC 端點，請參閱 [尋找您的 Amazon VPC 端點](#find-vpc-endpoint)。
1. 針對**連接埠號碼**，輸入下列項目：
+ **22** 適用於 SFTP
+ **21** 適用於 FTP/FTPS
1. 如果選取 SFTP，請針對**登入類型**選擇**金鑰檔案**。
針對**金鑰檔案**，選擇或輸入 SSH 私有金鑰。
1. 針對**使用者**，輸入您在 中建立的使用者名稱[管理伺服器端點的使用者](create-user.md)。
1. 選擇**連線**。
1. 執行檔案傳輸。
**注意**
如果您中斷進行中的檔案傳輸， AWS Transfer Family 可能會在 Amazon S3 儲存貯體中寫入部分物件。如果您中斷上傳，請檢查 Amazon S3 儲存貯體中的檔案大小是否符合來源物件的檔案大小，然後再繼續。
## 使用 Perl 用戶端
如果您使用 NET::SFTP::Foreign perl 用戶端，您必須`queue_size`將 設定為 `1`。例如：
`my $sftp = Net::SFTP::Foreign->new('user@s-12345.server.transfer.us-east-2.amazonaws.com', queue_size => 1);`
**注意**
[1.92.02](https://metacpan.org/changes/release/SALVA/Net-SFTP-Foreign-1.93#L12) `Net::SFTP::Foreign`之前的 修訂需要此解決方法。
## 使用 LFTP
LFTP 是免費的 FTP 用戶端，可讓使用者透過大多數 Linux 機器的命令列界面執行檔案傳輸。
對於大型檔案下載，LFTP 有已知的封包順序錯誤問題，導致檔案傳輸失敗。
## 上傳後處理
您可以檢視上傳後處理資訊，包括 Amazon S3 物件中繼資料和事件通知。
**Topics**
+ [Amazon S3 物件中繼資料](#post-processing-S3-object-metadata)
+ [Amazon S3 事件通知](#post-processing-S3-event-notifications)
### Amazon S3 物件中繼資料
做為物件中繼資料的一部分，您會看到名為 的金鑰`x-amz-meta-user-agent`，其值為 `AWSTransfer`且`x-amz-meta-user-agent-id`其值為 `username@server-id`。`username` 是上傳檔案的 Transfer Family 使用者，`server-id`也是用於上傳的伺服器。您可以使用 Lambda 函數內 S3 物件上的 [HeadObject](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) 操作來存取此資訊。
![\[中繼資料畫面顯示 Amazon S3 物件中繼資料的相關資訊 AWS Transfer Family。\]](http://docs.aws.amazon.com/zh_tw/transfer/latest/userguide/images/s3-object-metadata.png)
### Amazon S3 事件通知
使用 Transfer Family 將物件上傳至 S3 儲存貯體時， `RoleSessionName` 會包含在 [S3 事件通知結構](https://docs.aws.amazon.com/AmazonS3/latest/dev/notification-content-structure.html)中的請求者欄位中，做為 `[AWS:Role Unique Identifier]/username.sessionid@server-id`。例如，以下是已複製到 S3 儲存貯體之檔案的 S3 存取日誌中請求者範例欄位的內容。 S3
`arn:aws:sts::AWS-Account-ID:assumed-role/IamRoleName/username.sessionid@server-id`
在上方的申請者欄位中，會顯示名為 的 IAM 角色`IamRoleName`。如需設定 S3 事件通知的詳細資訊，請參閱《[Amazon Simple Storage Service 開發人員指南》中的設定 Amazon S3 事件通知](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)。 **如需 AWS Identity and Access Management (IAM) 角色唯一識別符的詳細資訊，請參閱*AWS Identity and Access Management 《 使用者指南*》中的[唯一識別符](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-unique-ids)。
## SFTP 訊息
本節說明使用 Transfer Family 伺服器時，您在 SFTP 檔案傳輸期間或之後可能收到的用戶端訊息。如需任何 SFTP 事件的詳細資訊，請檢查您的 SFTP 用戶端日誌。您可以使用該資訊對任何錯誤進行故障診斷，或將該資訊轉送給您的網路團隊，以協助他們識別問題。
**SFTP 用戶端訊息**
| 活動 | Description |
| --- | --- |
| AUTH\$1FAILURE | 使用者身分驗證失敗。這可能是來自自訂身分提供者或服務受管使用者的任何類型的失敗。事件中的詳細資訊有助於釐清失敗的根本原因。 |
| CLOSE | 表示已開啟的檔案或目錄已成功關閉。 |
| CONNECTED/DISCONNECTED | 表示正常連線成功和中斷連線。 |
| CREATE\$1SYMLINK | 已建立符號連結 （成功或失敗）。 |
| DELETE | 檔案已刪除 （成功或失敗）。 |
| ERROR | 一般、非預期的錯誤。相關聯的描述包含的資訊可協助您或您的網路管理員識別特定問題。 |
| EXIT\$1REASON | 當意外錯誤導致 SFTP 工作階段終止時發出。與事件相關聯的訊息說明原因。 |
| MKDIR | 目錄已建立 （成功或失敗）。 |
| OPEN | 檔案已開啟進行讀取或寫入 （成功或失敗） |
| PARTIAL\$1CLOSE | 當檔案仍然開啟且未收到 CLOSE 訊息時，用戶端會中斷與伺服器的連線。Transfer Family 會儲存檔案的接收部分 （實際上可能是完整的檔案），並發出 PARTIAL\$1CLOSE 事件，以提醒客戶發生此問題。工作流程整合也會收到onPartialClose事件，以適當地處理檔案。 |
| RENAME | 檔案已重新命名 （成功或失敗） |
| RMDIR | 目錄已刪除 （成功或失敗） |
| SETSTAT | 檔案的屬性會變更 （成功或失敗）。 如果您使用 Amazon S3 進行儲存，Transfer Family 不支援 SETSTAT。[避免`setstat`錯誤](#avoid-set-stat) 本節提供如何透過關閉 設定來避免`SetStat`錯誤的詳細資訊。這可避免您收到 `fail unsupported error`：反之，您會收到 `success but do nothing` 訊息。 |
| TLS\$1RESUME\$1FAILURE | 伺服器設定為強制執行 TLS 工作階段恢復，且用戶端不支援它。 |