Security News
Research
Data Theft Repackaged: A Case Study in Malicious Wrapper Packages on npm
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
ftp-deploy
Advanced tools
Ftp a folder from your local disk to an ftp destination. Does not delete from destination directory. Derived from grunt-ftp-deploy
A Node.js package to help with deploying code. Ftp a folder from your local disk to a remote ftp destination. Does not delete from destination directory.
Version 2.0.0 is an almost complete re-write to use promises and promise-ftp instead of jsftp. The one breaking change is listed in the Usage section.
npm install --save-dev ftp-deploy
I create a file - e.g. deploy.js - in the root of my source code and add a script to its package.json so that I can npm run deploy
.
"scripts": {
"deploy": "node deploy"
},
The most basic usage (stops uploading when an error occurs):
Note: that in version 2 the config file expects a field of user
rather than username
in 1.x.
The config file is passed as-is to Promise-FTP.
var FtpDeploy = require('ftp-deploy');
var ftpDeploy = new FtpDeploy();
var config = {
user: "user", // NOTE that this was username in 1.x
password: "password", // optional, prompted if none given
host: "ftp.someserver.com",
port: 21,
localRoot: __dirname + '/local-folder',
remoteRoot: '/public_html/remote-folder/',
// include: ['*', '**/*'], // this would upload everything except dot files
include: ['*.php', 'dist/*'],
exclude: ['dist/**/*.map'], // e.g. exclude sourcemaps - ** exclude: [] if nothing to exclude **
deleteRemote: true, // delete existing files at destination before uploading
forcePasv: true // Passive mode is forced (EPSV command is not sent)
}
// use with promises
ftpDeploy.deploy(config)
.then(res => console.log('finished'))
.catch(err => console.log(err))
// use with callback
ftpDeploy.deploy(config, function(err) {
if (err) console.log(err)
else console.log('finished');
});
You need to list all file patterns that you want to include for uploading, and the exclude option enables exceptions to the rule
include
: all files that match will be uploaded. Note that a [ ]
matches nothingexclude
: if a file matches the include pattern a subset may nonetheless be excludedTo be notified of what ftpDeploy is doing:
ftpDeploy.on('uploading', function(data) {
data.totalFilesCount; // total file count being transferred
data.transferredFileCount; // number of files transferred
data.filename; // partial path with filename being uploaded
});
ftpDeploy.on('uploaded', function(data) {
console.log(data); // same data as uploading event
});
ftpDeploy.on('log', function(data) {
console.log(data); // same data as uploading event
});
To continue uploading files even if a file upload fails (not implemented at present):
ftpDeploy.on('upload-error', function (data) {
console.log(data.err); // data will also include filename, relativePath, and other goodies
});
A script to run a simple ftp server (using ftp-srv) is included, together with a test directory.
To use open a console to run the ftp server:
npm run test_server
and then in another console run the tests:
npm test
re-enable continueOnError Move uploading and uploaded events to log
2.2.1
FAQs
Ftp a folder from your local disk to an ftp destination
The npm package ftp-deploy receives a total of 8,080 weekly downloads. As such, ftp-deploy popularity was classified as popular.
We found that ftp-deploy demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.