SSH remote connection issues
Workbench login issues
SSH client login issues
Resolving the "ssh_exchange_identification: read: Connection reset by peer" error
Resolving the "No supported authentication methods available" error
Resolving the "error: Unable to load host key: /etc/ssh/ssh_host_rsa_key" error
Resolving the "Maximum amount of failed attempts was reached" error
Resolving the "could not set limit for ‘nofile’: Operation not permitted" error
Resolving the "This account is currently not available." error
Resolving the "fatal: mm_request_send: write: Broken pipe" error
SFTP client login issues
Other issues
SSH service startup issues and solutions
Resolving sshd configuration errors that prevent remote connections
Resolving the sshd startup error: "/usr/share/empty.sshd must be owned by root..."
Resolving the "error while loading shared libraries" error during SSH service startup
Resolving the "fatal: Cannot bind any address" error during SSH service startup
Resolving the "Bad configuration options" error during SSH service startup
Resolving the "Failed to start OpenSSH server daemon" error during SSH service startup
Troubleshooting SSH service startup failures with no error message
Other common issues and solutions
Remote Desktop (RDP) connection issues
Troubleshooting remote connection failures to a Windows instance
Resolving the "For security reasons, this user account has been locked..." error
Resolving the "Your credentials did not work" error during a remote logon to a Windows instance
Resolving the "The Remote Desktop Users group does not have this permission" error
Resolving the "Because of a protocol error, this session will be disconnected" error
Resolving the "The remote desktop licensing server is not specified" error
Troubleshooting the disabled "Allow Remote Assistance connections to this computer" option
Troubleshooting unstable Remote Desktop connections to a Windows instance
Troubleshooting copy and paste issues during a Remote Desktop connection
Resolving the "Remote Desktop Connection has been disconnected" error
Troubleshooting Remote Desktop connection failures when VNC connection is successful
Resolving the "Remote Desktop Connection cannot verify the identity..." error on Mac
Resolving the "The terminal server has exceeded the maximum number of allowed connections" error
Resolving "The system cannot find the file specified" error during a Remote Desktop connection
Troubleshooting login failures to a Windows instance using the default port (3389)
Troubleshooting automatic disconnection after logon in Remote Desktop
How to start the RDP service for a Remote Desktop connection on a Windows instance
VNC remote connection issues
FTP service connection issues
Windows instances
Troubleshooting internet connection failures to an FTP service on a Windows ECS instance
Resolving the "530 Login incorrect" error when connecting to an FTP server
Resolving the "530 valid hostname is expected" error when connecting to an FTP server
Resolving the "550 Permission denied" error when uploading a file to FileZilla Server
Resolving the "534 Policy requires SSL" message for an FTP over TLS connection
Linux instances
Appendix
Sshd startup error: Permission for /usr/share/empty.sshd
Symptom
The sshd service on an ECS instance fails to start, and the system log reports a permission error:
/usr/share/empty.sshd must be owned by root and not group or world-writableCause
The sshd service fails to start because the
/usr/share/empty.sshdfile has incorrect permissions.Solution
chown -R root.root /usr/share/empty.sshd chmod 744 /usr/share/empty.sshd systemctl start sshd ll -ld /usr/share/empty*
Troubleshooting internet FTP connections on Windows
Symptom
An FTP service on a Windows ECS instance is unreachable from the internet.
Cause
Possible causes include:
Incorrect security group rules for FTP: For more information, see Solution 1: Add security group rules for FTP.
The firewall blocks the FTP process: For more information, see Solution 2: Configure FTP firewall support.
Solution
Choose a solution based on the cause.
Solution 1: Add security group rules for FTP
After you set up an FTP site on an ECS instance that runs Windows, you must add an inbound rule to the security group of the instance to allow traffic on port 21 for the FTP server and on the port range 1024-65535 for passive mode. For more information, see Add a security group rule.
For more information about security group configurations, see Security group application guide and use cases and Common ports.
Solution 2: Configure FTP firewall support
If the firewall is enabled, you must configure IIS Manager to allow FTP traffic on TCP port 21 and the port range 1024-65535. Follow these steps:
The internal firewall of a Windows ECS instance is disabled by default.
This topic uses IIS Manager as an example to describe how to configure FTP.
Connect to the Windows instance.
For more information, see Connect to a Windows instance by using a password or key.
Open IIS Manager and double-click FTP Firewall Support to open its configuration page.
Set the parameters and click Apply.
NoteParameters:
External IP Address of Firewall: Enter the public IP address of the Windows ECS instance.
Data Channel Port Range: Specify the port range for passive connections. The valid port range is 1024-65535. This topic uses 1024-65535 as an example.
Open the command line and run the following command to restart the FTP service. This applies the new configuration to all FTP sites.
net stop ftpsvc&net start ftpsvc(Optional) If the FTP server is locally accessible but unreachable from other machines after configuration, the firewall might be misconfigured. Follow these steps to correctly configure the firewall:
Check the inbound rules in Server Manager to make sure that the FTP server is enabled.
Add the Windows service host process.
Navigate to Control Panel > Windows Firewall and click Allow an App or Feature Through Windows Firewall in the left-side navigation pane.
In the new window, click Allow Another App..., browse to and select
C:\Windows\System32\svchost.exeto add the service host process.Select the new Windows Service Host Process item, select the Private and Public checkboxes, and then click OK.
Troubleshooting FTP error "530 Login incorrect"
Symptom
When you connect to the FTP server on an ECS instance that runs Windows, the following error is reported:
Response: 331 Please specify the password.
Command: PASS ************
Response: 530 Login incorrect.
Error: Critical error: Could not connect to serverCause
Possible causes include:
The FTP password is incorrect: For more information, see Solution 1: Change the FTP password.
Incorrect FTP user permissions: For more information, see Solution 2: Add FTP user permissions.
Solution
Choose a solution based on the cause.
Solution 1: Change the FTP password
Connect to the Windows instance.
For more information, see Connect to a Windows instance by using a password or key.
On the desktop, right-click Computer > Manage to open Server Manager.
In the left-side navigation pane, click Local Users and Groups > Users. Right-click the FTP account and select Set Password.
Solution 2: Add FTP user permissions
Connect to the Windows instance.
For more information, see Connect to a Windows instance by using a password or key.
Check whether the FTP user directory exists.
If the directory does not exist, re-create it and add the required permissions. For more information, see Step 3: Set permissions for shared files.
If the directory exists, right-click the folder and select Properties > Security. Select the FTP account and grant the required permissions.
Troubleshooting FTP error "530 valid hostname is expected"
Symptom
When connecting to an FTP server on a Windows ECS instance by IP address, a "530 valid hostname is expected" or "503 Login with USER first" error occurs if the FTP site, configured in IIS 7.5, is bound to a domain name.
Cause
This error occurs because the username format is incorrect when you log on to an FTP service that is bound to a domain name in IIS 7.5.
Solution
If the domain name bound to the FTP service is www.example.com and the username is user, you must use www.example.com|user to log on.
The separator is a pipe character (|).
Alternatively, remove the domain name binding and log on with only the username.
Troubleshooting FileZilla error "550 Permission denied"
Symptom
A "550 Permission denied" error is reported when you upload a file to FileZilla Server by using FTP on an ECS instance that runs Windows.
Cause
The corresponding FTP account in FileZilla Server does not have the write permission.
Solution
Connect to the Windows instance.
For more information, see Connect to a Windows instance by using a password or key.
Run the FileZilla Server software. On the Users page, select Shared folders.
Select the corresponding user and directory, select the Write checkbox, and then click OK to grant the permission.
FTP over TLS error: "534 Policy requires SSL"
Symptom
When you connect to an FTP site created by the IIS service on a Windows instance by using FTP over TLS, the message "534 Policy requires SSL" is displayed, preventing the connection.
Cause
The "534 Local policy on server does not allow TLS secure connections." response indicates that the FTP SSL Settings parameter of the FTP site is not correctly configured.
Solution
Connect to the Windows instance.
For more information, see Connection methods.
In the lower-left corner of the desktop, choose
> Windows Administrative Tools > Internet Information Services (IIS) Manager.On the FTP homepage, in the FTP section, double-click FTP SSL Settings.
In the FTP SSL Settings section, set SSL Policy to Allow SSL connections, and then click Apply in the Actions pane.
Access the FTP site again.
Troubleshooting FTP error "425 Security:Bad IP connection"
Symptom
A "425 Security:Bad IP connection" error is reported when a user uploads a file to an FTP site on an ECS instance that runs Linux.
Cause
This issue usually occurs because the client is in a NAT network that is associated with more than one public IP address. As a result, the source IP addresses for the control and data connections are inconsistent, causing the error.
The FTP service uses a control connection and a data connection. By default, the FTP server verifies that the two connections have the same source IP address during data transfer. If the source IP addresses are different, a "425 Security:Bad IP connection" error is reported.
Solution
Perform the following steps to disable the IP security check in passive mode:
Connect to the Linux instance.
For more information, see Connect to a Linux instance by using a password or key.
Run the following command to edit the FTP configuration file:
vi /etc/vsftpd/vsftpd.confPress
ito enter edit mode and add the following content to the configuration file:pasv_promiscuous=yesPress
Escto exit edit mode, enter:wq, and then press Enter to save and exit.Run the following command to restart the FTP service:
systemctl restart vsftpd
Troubleshooting vsftp error "553 Could not create file"
Symptom
Uploading a file to an ECS instance that runs Linux by using vsftp fails with a "553 Could not create file" error.
Cause
Possible causes include:
The disk space of the Linux instance is full.
The FTP
homedirectory does not have thewritepermission.
Solution
Follow these steps to check the instance's disk space and the FTP home directory permissions:
Connect to the Linux instance.
For more information, see Connect to a Linux instance by using a password or key.
Run the following command to check whether the disk is full.
df -hNoteIf a partition's disk space usage reaches 100%, it is full.
A similar output is displayed. For example, the space usage of the
/dev/xvda1partition is 59%.Filesystem Size Used Avail Use% Mounted on /dev/xvda1 20G 11G 7.8G 59% / tmpfs 498M 1.6M 496M 1% /dev/shmRun the following command to check whether the FTP
homedirectory has thewritepermission.NoteBefore you run the following command, replace
/home/userwith your actual FTPhomedirectory name.ls -l /home/userIf the permission string in the output does not include
w, you do not have thewritepermission. For example:dr-xr-xr-x 4 xxx xxx 4096 May 10 21:47 zhengboRun the following command to add the
writepermission:chmod +w /home/userRun the following command to verify the permission. If the command output contains
w, thewritepermission is added.ls -l /home/user
What to do when an ECS instance becomes unresponsive due to high CPU load, insufficient memory, or saturated disk I/O/BPS/IOPS and remote connections (SSH/VNC/Workbench) fail?
When an ECS instance becomes unresponsive because CPU load is too high, memory is exhausted, or disk I/O/BPS/IOPS is saturated, you may be unable to connect to the instance through SSH, VNC, or Workbench. Follow these steps to perform emergency recovery and root cause analysis.
Possible causes
A system hang is usually caused by one or a combination of the following:
Insufficient memory triggers intensive page swapping: After physical memory is exhausted, the kernel
kswapd0process continuously swaps memory pages to disk (swap), saturating disk I/O and causing the system to respond extremely slowly.A single process exhausts resources: A process (such as a Docker container, Java application, or MySQL database) consumes a large amount of CPU or memory resources, leaving the system unable to allocate resources for critical services such as SSH.
Disk space is 100% full: Disk space exhaustion causes critical system processes to malfunction. For example, SSH login requires writing to the login history file. When the disk is full, this operation is blocked, causing the SSH connection to hang.
Emergency recovery steps
Create a snapshot to back up data
Log on to the ECS console, find the system disk and data disks of the target instance, and create snapshots as a priority to back up data.
NoteWhen the system is in a hung state, disk I/O may remain at a high level. Snapshot creation may take significantly longer than normal. Wait for the snapshots to complete.
Attempt to send commands through Cloud Assistant (optional)
If you want to stop the problematic application before restarting the instance to ensure data is flushed to disk, you can try sending a
killorstopcommand to the instance through Cloud Assistant in the ECS console. However, if the OS kernel is completely unresponsive, the command will time out. In that case, proceed to the next step.WarningRunning
killorstopcommands will forcefully terminate the target process, which may result in incomplete business data writes, file corruption, or abnormal database shutdown. Assess the business impact before proceeding.Restart the instance
Restart the instance from the ECS console.
First, try a normal restart (wait for the kernel to respond to the shutdown command) and observe for 10–15 minutes.
If the normal restart times out and fails, perform a force restart. A force restart is equivalent to a power cycle and carries a very small risk of corrupting files that were being written. Make sure you have completed the snapshot backup before force restarting.
Root cause analysis and long-term optimization
Install the atop tool: We recommend that you install atop and configure it to start on boot (
systemctl enable atop). atop continuously records system resource usage.Check OOM records: Run
dmesg | grep -i oomor check/var/log/messagesto confirm whether an out-of-memory (OOM) event has occurred.Optimize memory configuration: For memory bottlenecks, you can configure a Linux swap partition as a temporary buffer. If your workload requires more memory in the long term, we recommend that you upgrade the instance type.
Configure CloudMonitor alerts: Configure threshold alerts for CPU usage, memory usage, disk I/O, and other metrics in CloudMonitor to receive notifications before resources are exhausted.