SSH.NET is a Secure Shell (SSH-2) library for .NET, optimized for parallelism.
- Execution of SSH command using both synchronous and asynchronous methods
- SFTP functionality for both synchronous and asynchronous operations
- SCP functionality
- Remote, dynamic and local port forwarding
- Interactive shell/terminal implementation
- Authentication via publickey, password and keyboard-interactive methods, including multi-factor
- Connection via SOCKS4, SOCKS5 or HTTP proxy
using (var client = new SshClient("sftp.foo.com", "guest", new PrivateKeyFile("path/to/my/key")))
{
client.Connect();
using SshCommand cmd = client.RunCommand("echo 'Hello World!'");
Console.WriteLine(cmd.Result); // "Hello World!\n"
}
using (var client = new SftpClient("sftp.foo.com", "guest", "pwd"))
{
client.Connect();
using (FileStream fs = File.OpenRead(@"C:\tmp\test-file.txt"))
{
client.UploadFile(fs, "/home/guest/test-file.txt");
}
foreach (ISftpFile file in client.ListDirectory("/home/guest/"))
{
Console.WriteLine($"{file.FullName} {file.LastWriteTime}");
}
}
The main types provided by this library are:
- Renci.SshNet.SshClient
- Renci.SshNet.SftpClient
- Renci.SshNet.ScpClient
- Renci.SshNet.PrivateKeyFile
- Renci.SshNet.SshCommand
- Renci.SshNet.ShellStream
SSH.NET supports the following encryption methods:
- aes128-ctr
- aes192-ctr
- aes256-ctr
- aes128-gcm@openssh.com (.NET 6 and higher)
- aes256-gcm@openssh.com (.NET 6 and higher)
- chacha20-poly1305@openssh.com
- aes128-cbc
- aes192-cbc
- aes256-cbc
- 3des-cbc
SSH.NET supports the following key exchange methods:
- curve25519-sha256
- curve25519-sha256@libssh.org
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
- diffie-hellman-group-exchange-sha256
- diffie-hellman-group-exchange-sha1
- diffie-hellman-group16-sha512
- diffie-hellman-group14-sha256
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1
SSH.NET supports the following private key formats:
- RSA in OpenSSL PEM ("BEGIN RSA PRIVATE KEY") and ssh.com ("BEGIN SSH2 ENCRYPTED PRIVATE KEY") format
- DSA in OpenSSL PEM ("BEGIN DSA PRIVATE KEY") and ssh.com ("BEGIN SSH2 ENCRYPTED PRIVATE KEY") format
- ECDSA 256/384/521 in OpenSSL PEM format ("BEGIN EC PRIVATE KEY")
- ECDSA 256/384/521, ED25519 and RSA in OpenSSH key format ("BEGIN OPENSSH PRIVATE KEY")
Private keys can be encrypted using one of the following cipher methods:
- DES-EDE3-CBC
- DES-EDE3-CFB
- DES-CBC
- AES-128-CBC
- AES-192-CBC
- AES-256-CBC
SSH.NET supports the following host key algorithms:
- ssh-ed25519
- ecdsa-sha2-nistp256
- ecdsa-sha2-nistp384
- ecdsa-sha2-nistp521
- rsa-sha2-512
- rsa-sha2-256
- ssh-rsa
- ssh-dss
SSH.NET supports the following MAC algorithms:
- hmac-sha2-256
- hmac-sha2-512
- hmac-sha1
- hmac-sha2-256-etm@openssh.com
- hmac-sha2-512-etm@openssh.com
- hmac-sha1-etm@openssh.com
SSH.NET supports the following compression algorithms:
- none (default)
- zlib@openssh.com
SSH.NET supports the following target frameworks:
- .NETFramework 4.6.2 (and higher)
- .NET Standard 2.0 and 2.1
- .NET 6 (and higher)
The library has no special requirements to build, other than an up-to-date .NET SDK. See also CONTRIBUTING.md.
Do you or your company rely on SSH.NET in your projects? If you want to encourage us to keep on going and show us that you appreciate our work, please consider becoming a sponsor through GitHub Sponsors.