FTP

FTP

For your information

You can work via FTP only with containers in the pools ru-1 and ru-7.

Two connections are used for the FTP protocol to work:

• control connection — commands and responses are sent over it, they are text strings;
• data connection.

Object storage uses only passive data transfer mode. The process of connection establishment and data transfer is initiated exclusively from the client side.

Writing to the end of the file is not supported — attempting to do so will return response code 426.

Connection data⁠

To connect to object storage via FTP is used:

• FTP host in the right pool;
• port 21.

Authentication is done using an S3 key — the Account Owner or User Administrator issues the key to the service user.When connecting via FTP, the Access key and Secret key fields from the key are used as login and password respectively.

Configure FTP⁠

1. Configure access.
2. Connect via FTP.

1. Set up access⁠

Access can be configured by a user with the Account Owner or User Administrator role.

1. Create a service user с role with access to the object store.If you are using a user with the Object Storage User role, the container must have a configured access policy.
2. Issue an S3 key to the user.

2. Connect via FTP⁠

Windows

Total Commander

1. Open Total Commander.
2. From the Network menu, select Connect to FTP server.
3. Click Add.
4. On the General tab, in the Connection Name field, enter any name (for example, Servercore).
5. In the Server field, enter the FTP host in the desired pool.
6. In the Account field, enter the value of  the Access key field from the S3 key.
7. In the Password field, enter the value of  the Secret key field from the S3 key.
8. Check the Passive sharing mode (as Web browser) checkbox.
9. Open the Advanced tab.
10. In the File name encoding field, select UTF-8.
11. Press OK. The profile will be saved.
12. Click Connect.

Midnight Commander

1. Open Midnight Commander.

2. Press F9. The main menu opens.

3. From the Left (for the Left pane) or Right (for the Right pane) panel menu, select FTP Link.

4. Enter a string in the format [<access_key>]@<ftp_host>. Specify:

   • <access_key> — field value Access key from S3 key;
   • <ftp_host> — FTP host in the required pool.

5. Press Enter.

6. Enter the password — the value of the Secret key field from the S3 key. If all data has been entered correctly, the panel will display the contents of the object storage.

FAR Manager

1. Open FAR Manager.
2. Press Alt + F1 (for the left panel) or Alt + F2 (for the right panel) to open the jump menu.
3. Select NetBox from the transition menu.
4. Press Enter.
5. Press Shift + F4. The screen for creating a new connection opens.
6. In the File Protocol field, select FTP.
7. In the Host name field, enter the FTP host in the desired pool.
8. In the User name field, enter the value of the Access key field from the S3 key.
9. In the Password field, enter the value of  the Secret key field from the S3 key.
10. Press OK.
11. To connect via FTP, select the created profile and press Enter.

WinSCP

1. Open WinSCP.
2. In the Transfer Protocol field, select FTP.
3. Enter the hostname — the FTP host in the desired pool.
4. Enter the user name — the value of the Access key field from the S3 key.
5. Enter the password — the value of the Secret key field from the S3 key.
6. Click More.
7. Select the Environment section.
8. In the UTF-8 encoding for file names field, select On.
9. Click OK → Save.
10. Enter the name of the connection (e.g. Servercore).
11. If you want to save your password, check the Remember Password checkbox.
12. Optional: check the Create shortcut on "Desktop" checkbox.
13. Press OK.
14. To connect via FTP, click Log in.

FileZilla

1. Open FileZilla.
2. From the File menu, select Site Manager.
3. Click New Site.
4. On the General tab, in the Host field, enter the FTP host in the desired pool.
5. In the Input Type field, select Normal.
6. In the User field, enter the value of the Access key field from the S3 key.
7. In the Password field, enter the value of  the Secret key field from the S3 key.
8. Open the Transmission Settings tab.
9. In the Transmission Mode field, select Passive.
10. Open the Encoding tab.
11. Select UTF-8 encoding forcibly.
12. Click OK.
13. From the Transmit menu, select Transmit Mode → Binary.
14. From the File menu, select Site Manager.
15. To connect via FTP, select the created site and click Connect.

Windows Explorer

1. Open Windows Explorer.
2. Right-click on This Computer and select Connect Network Disk.
3. Click Connect to a website where you can store documents and images.
4. Click Next.
5. Select Select a different network location.
6. Click Next.
7. Enter the address of the object storage — FTP host in the desired pool.
8. Click Next.
9. Uncheck the Anonymous Login checkbox.
10. Enter the value of the Access key field from the S3 key as the user name.
11. Click Next.
12. Optional: change the name of the connection.
13. Click Finish.
14. Enter the password — the value of the Secret key field from the S3 key.
15. Check the Save password checkbox.
16. Click Login. The connection appears in the list of local and network drives.

Linux

Nautilus

1. Use Nautilus to open any directory.
2. From the File menu, select Connect to Server.
3. In the Server Address field, enter the FTP host in the desired pool.
4. Click Connect.
5. Select Registered User.
6. Enter login — the value of the Access key field from the S3 key.
7. Enter the password — the value of the Secret key field from the S3 key.
8. Optional: check the Remember Forever checkbox.
9. Click Connect.

FTP operation⁠

Authorization⁠

Team	Arguments	Designation
USER	Access key from S3 key	Pass login
PASS	Secret key from the S3 key	Pass the password

Defense⁠

Team	Arguments	Designation
AUTH	Not required	Establish a secure TLS connection. Arguments will be ignored
PROT	P / C	Set the protection mode. P for Private, C for Clean. By default, P will use TLS
PBSZ	Buffer size	Set the size of the protection buffer. The server will respond with 200 OK

Miscellaneous⁠

Team	Arguments	Designation
FEAT	Not required	Display a list of supported additional functions
SYST	Not required	Display the server operating system
NOOP	Not required	Empty operation, the server will respond with 200 OKs
OPTS	According to RFC2389.	Pass additional options to the server

File access⁠

Team	Arguments	Designation
SIZE	File name	Get file size
STAT	Not required	Get connection statistics
MDTM	Path	Get the date and time of file modification
RETR	File name	Download file. It will work only after switching to passive mode with PASV command. Docking is supported
STOR	File name	Upload a file in passive mode
APPE	File name	Tell the server to accept the remote file. The command will work only if such a file does not exist in the storage yet. If the file exists, an error will be returned
DELE	File name	Delete file
RNFR	File name	Select the file to rename
RNTO	New file name	Set a new file name. Only after the RNFR command has been selected
ALLO	Size in bytes	Return a response about available space. Regardless of the argument, the response will be 202 OK
REST	Offset in bytes	Command to "rewind" to a specific position in the file. Required for downloading with RETR

Working with containers⁠

Team	Arguments	Designation
CWD	Directory name	Go to the specified directory
PWD	Not required	Show the current working directory
CDUP	Not required	Go to the parent directory
NLST	Not required	Return a list of directory files in a shorter format than LIST. Only in passive connection mode
LIST	Path	Output the contents of the current or provided directory. Both relative and absolute paths are supported
MLSD	Path	Output the contents of the current directory. The main difference from LIST is that time stamps are accurate to the second, time is specified in UTC
MKD	Directory name	Create a directory
RMD	Directory name	Delete directory

Establishing a connection⁠

Team	Arguments	Designation
TYPE	A / I	Change the mode of data transmission. There are two options, ASCII(A) or Binary(I). Either argument is ignored, the command is used for backward compatibility. Only Binary mode is supported
PASV	Not required	Switch to passive data transfer mode
EPSV	Not required	Initiate a passive mode data connection. In response, the server will transmit the port number for the connection
EPRT	Protocol version / address / port	Initiate a data connection. The command is exclusive to active data transfer mode, so the server will report to this command that active mode is not supported
PORT	Not required	Switch to active data transfer mode. The command is exclusive to active data transfer mode, so the server will report to this command that active mode is not supported
QUIT	Not required	Disconnect from the server