SSH and SFTP client library for React Native

SSH and SFTP client library for React Native on MacOS.

Installation

npm install rn-macos-ssh-sftp

macOS

Run pod install in your ./macos directory.

cd macos
pod install
cd -

[!TIP] Adding a postinstall script to your package.json file to run pod install after npm install is a good idea. The pod-install package is a good way to do this.

{
  "scripts": {
    "postinstall": "npx pod-install"
  }
}

Having OpenSSL issues on MacOS?

If you are using Flipper to debug your app, it will already have a copy of OpenSSL included. This can cause issues with the version of OpenSSL that NMSSH uses. You can disable flipper by removing/commenting out the flipper_configuration => flipper_config, line in your Podfile.

Android

No additional steps are needed for Android.

Linking

This project has been updated to use React Native v73 (the latest at the time of writing, Jan 2024) - which means that manual linking is not required.

Usage

All functions that run asynchronously where we have to wait for a result returns Promises that can reject if an error occurred.

[!NOTE] On macOS, this package currently doesn't support the simulator, you will need to have your app running on a physical device. If you would like to know more about this, see this issue. I'd welcome a PR to resolve this.

Create a client using password authentication

import SSHClient from 'rn-macos-ssh-sftp';

try{
  // Create SSH client with private keys
   const client = new SSHClient(
      '123.123.123.1', // server/ssh ip/host
      'port',
      'username',
      {
        privateKey,
        passphrase: '1234', // replace with your passphrase
      },
      10, // timeout
    );
  
    // Create SSH client with passowrd
     const client = new SSHClient(
      '123.123.123.1', // server/ssh ip/host
      'port',
      'username',
      'password',
      10, // timeout
    );

    await client.connect();
    console.log('SSH connected successfully...');
}catch(e){
  console.error(error)
}

#### Public key authentication is also supported

```plaintext
{privateKey: '-----BEGIN RSA......'}
{privateKey: '-----BEGIN RSA......', publicKey: 'ssh-rsa AAAAB3NzaC1yc2EA......'}
{privateKey: '-----BEGIN RSA......', publicKey: 'ssh-rsa AAAAB3NzaC1yc2EA......', passphrase: 'Password'}

Close client

client.disconnect();

Execute SSH command

const command = 'ls -l';
client.execute(command).then((output) => console.warn(output));

Shell

Start shell

• Supported ptyType: vanilla, vt100, vt102, vt220, ansi, xterm

const ptyType = 'vanilla';
client.startShell(ptyType).then(() => {
  /*...*/
});

Read from shell

client.on('shell', (event) => {
  if (event) console.warn(event);
});

Write to shell

const str = 'ls -l\n';
client.writeToShell(str).then(() => {
  /*...*/
});

Close shell

client.closeShell();

SFTP

Connect SFTP

client.connectSFTP().then(() => {
  /*...*/
});

List directory

const path = '.';
client.list(path).then((response) => console.warn(response));

Download file

client.sftpDownload('[path-to-remote-file]', '[path-to-local-directory]').then((downloadedFilePath) => {
  console.warn(downloadedFilePath);
});

// Download progress (setup before call)
client.on('download', (event) => {
  console.warn(event);
});

// Cancel download
client.sftpCancelDownload();

Upload file

client.sftpUpload('[path-to-local-file]', '[path-to-remote-directory]').then(() => {
  /*...*/
});

// Upload progress (setup before call)
client.on('upload', (event) => {
  console.warn(event);
});

Close SFTP

client.disconnect();

Example app

You can find a very simple example app for the usage of this library here.

Credits

This package wraps the following libraries, which provide the actual SSH/SFTP functionality:

• NMSSH for MacOS
• JSch for Android (from Matthias Wiedemann fork)

This package is a fork of Emmanuel Natividad's react-native-ssh-sftp package. The fork chain from there is as follows:

1. Gabriel Paul "Cley Faye" Risterucci
2. Bishoy Mikhael
3. Qian Sha