n8n-nodes-sftp-custom
v0.1.5
Published
n8n node for SFTP with custom algorithms
Maintainers
Readme
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)
- Go to Settings > Community Nodes in your n8n instance
- Click Install
- Enter
n8n-nodes-sftp-custom - Click Install
Manual Installation
npm install n8n-nodes-sftp-customConfiguration
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-rsarsa-sha2-256rsa-sha2-512ecdsa-sha2-nistp256ecdsa-sha2-nistp384ecdsa-sha2-nistp521ssh-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]- Read Binary File: Select local file
- SFTP Upload: Configure Remote Path
Upload via Webhook
[Webhook] → [SFTP Upload]- Webhook: Set to POST with form data
- SFTP Upload: Use
dataas Input Data Field Name
Download and Process
[SFTP Download] → [Process File] → [...]- SFTP Download: Specify Remote File Path
- 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:
- Open an issue on GitHub
- Ask in the n8n community forum
