Comprehensive Guide to Resolving SSH Connection Refused on localhost Port 22

Problem Background and Error Analysis

When installing distributed systems like Hadoop, SSH connectivity is a fundamental requirement. The command ssh localhost attempts to connect to port 22 by default. The error message ssh: connect to host localhost port 22: Connection refused indicates that no service is listening on the target port.

Core Solution: Port Specification Method

According to best practices, when SSH service runs on a non-standard port, the most direct solution is to specify the port number using the -p parameter. For example:

ssh localhost -p 8088

This method is simple and effective, establishing connections without modifying system configurations. During Hadoop installation, if SSH service is configured on port 8088, this command successfully establishes the connection.

Supplementary Solutions

SSH Service Status Check and Reinstallation

First verify if SSH client and server are installed:

which ssh
which sshd

If services are not properly installed, perform reinstallation:

sudo apt-get remove openssh-client openssh-server
sudo apt-get install openssh-client openssh-server

System-Specific Configuration

On Mac OSX systems, ensure remote login functionality is enabled:

Navigate to System Preferences → Sharing, and check the Remote Login option. This setting allows SSH service to run on the default port 22.

In-Depth Technical Analysis

Port Mapping and Container Environments

In containerized environments like Docker, SSH port mapping configuration is crucial. The Gitea deployment case in the reference article shows that when SSH service is configured on port 222, correct port mapping is essential for connectivity:

ports:
  - "22:22"  # Standard port mapping
  # or
  - "222:22" # Custom port mapping

Network Connection Principles

localhost resolves to 127.0.0.1 (IPv4) or ::1 (IPv6). Connection refusal indicates:

• SSH service not running
• Service running on different port
• Firewall blocking connection
• Service configuration error

Debugging and Verification Steps

Use verbose mode to diagnose connection issues:

ssh -vvv localhost

Output shows detailed connection attempt process, including:

• Configuration reading process
• Address resolution results
• Connection establishment attempts
• Specific refusal reasons

Practical Application Scenarios

Hadoop Cluster Configuration

In Hadoop pseudo-distributed mode installation, NameNode and DataNode communicate via SSH. Proper SSH configuration ensures:

• Password-less login between nodes
• Normal service startup
• Job scheduling execution

Version Compatibility Considerations

Different OpenSSH versions may have configuration differences. Ensure client and server version compatibility to avoid connection issues due to protocol mismatches.

Security Configuration Recommendations

When modifying SSH configurations, consider security best practices:

• Use non-standard ports to reduce automated attacks
• Configure key authentication instead of password authentication
• Restrict access IP ranges
• Regularly update SSH software versions

Conclusion

SSH connection refusal on localhost port 22 is a common configuration issue. Through multi-dimensional solutions including port specification, service status checking, and system configuration adjustments, problems can be quickly identified and resolved. In distributed system deployments, proper SSH configuration is fundamental to ensuring normal system operation.