sftp-custom

n8n node for SFTP with custom algorithms

Package Information

Downloads: 63 weeklyĀ /Ā 117 monthly
Latest Version: 0.1.5
Author: Genevieve Lee

Available Nodes

SFTP icon
SFTP
n8n node for SFTP with custom algorithms

Documentation

n8n-nodes-sftp-custom

A custom n8n community node for SFTP operations with support for legacy algorithms.

Features

  • āœ… Custom Algorithm Support - Configure host key algorithms (ssh-dss, ssh-rsa, etc.)
  • šŸ”„ Connect Test - Verify SFTP connection
  • ā¬†ļø Upload File - Upload files to SFTP server
  • ā¬‡ļø Download File - Download files from SFTP server
  • šŸ“‹ List Files - List files and directories (with recursive option)
  • šŸ—‘ļø Delete - Delete files or directories (with recursive option)
  • āœļø Rename/Move - Rename or move files and directories

Installation

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes in your n8n instance
  2. Click Install
  3. Enter n8n-nodes-sftp-custom
  4. Click Install

Manual Installation

npm install n8n-nodes-sftp-custom

Configuration

Credentials

Create a new SFTP Account credential with the following fields:

  • Host: SFTP server hostname or IP
  • Port: SFTP port (default: 22)
  • Username: SFTP username
  • Password: SFTP password
  • Host Key Algorithms: Comma-separated list of algorithms (e.g., ssh-dss,ssh-rsa,rsa-sha2-256,ecdsa-sha2-nistp256)

Supported Algorithms

The Host Key Algorithms field allows you to specify which algorithms to use for authentication. This is particularly useful for connecting to legacy SFTP servers that still use deprecated algorithms like ssh-dss.

Common algorithms:

  • ssh-dss (legacy, for older servers)
  • ssh-rsa
  • rsa-sha2-256
  • rsa-sha2-512
  • ecdsa-sha2-nistp256
  • ecdsa-sha2-nistp384
  • ecdsa-sha2-nistp521
  • ssh-ed25519

Default value: ssh-dss,ssh-rsa,rsa-sha2-256,ecdsa-sha2-nistp256

Operations

Connect Test

Test the SFTP connection with your configured credentials.

Upload File

Upload a file to the SFTP server.

Parameters:

  • Input Data Field Name: Name of the binary property containing the file (default: data)
  • Remote Path: Destination directory on the server (e.g., /upload/)

Usage: Connect a Read Binary File node before this operation to provide the file data.

Download File

Download a file from the SFTP server.

Parameters:

  • Remote File Path: Full path to the file on the server (e.g., /path/to/file.txt)
  • Output Property Name: Name for the binary property to store the downloaded file (default: data)

List Files

List files and directories on the SFTP server.

Parameters:

  • Remote Directory Path: Directory to list (default: /)
  • Recursive: Whether to list subdirectories recursively

Output: Returns file/directory information including name, size, modification time, and permissions.

Delete

Delete a file or directory from the SFTP server.

Parameters:

  • Path: Path of the file or directory to delete
  • Recursive: Whether to delete directory contents recursively

āš ļø Warning: Recursive deletion is permanent and cannot be undone.

Rename/Move

Rename or move a file or directory on the SFTP server.

Parameters:

  • Old Path: Current path of the file or directory
  • New Path: New path for the file or directory

Options:

  • Timeout: Connection timeout in milliseconds (default: 10000)

Example Workflows

Upload File from Local System

[Read Binary File] ā†’ [SFTP Upload]
  1. Read Binary File: Select local file
  2. SFTP Upload: Configure Remote Path

Upload via Webhook

[Webhook] ā†’ [SFTP Upload]
  1. Webhook: Set to POST with form data
  2. SFTP Upload: Use data as Input Data Field Name

Download and Process

[SFTP Download] ā†’ [Process File] ā†’ [...]
  1. SFTP Download: Specify Remote File Path
  2. File is available as binary data in subsequent nodes

Legacy Server Support

This node was specifically designed to support legacy SFTP servers that require deprecated algorithms like ssh-dss. Modern SSH implementations (OpenSSH 7.0+, OpenSSL 3.0+) have disabled these algorithms by default due to security concerns.

If you're connecting to a legacy system and encounter authentication errors, configure the Host Key Algorithms field in your credentials to include ssh-dss.

Compatibility

  • n8n version: 1.0.0+
  • Node.js: 18+

Resources

License

MIT

Author

Genevieve Lee

Support

If you encounter issues or have questions:

Discussion