Lasso
A tiny application to expose a file-system branch to the world.
Installation
sudo yarn global add beautiful-lasso
sudo npm i -g beautiful-lasso
(the reason why it's beautiful-lasso
and not lasso
is because the name was already taken on npm)
Usage
RANCH=exposed_directory lasso [--port 8000]
This will expose exposed_directory
(also called the ranch ) to the world on port 8000 (default to 3000, the --port
is optional). Of course this will not really expose the directory to the world unless you are running this command on a public machine and configure the firewall to accept entrances on the given port.
Configuration
By default, the files in the ranch are secured with http basic authentication. You'll need to create a .lasso.passwd
into the ranch so you can register users. Here's an example of .lasso.passwd
:
bob:bob_password
Now bob can request a file in the ranch :
curl http://alice.com:8000/database_backup.sql -u bob:bob_password
curl http://alice.com:8000/database_backup.sql -u bob
.lasso.public
It's also possible to make some files available publicly without basic authentication required. Just create .lasso.public
in the ranch :
public-file.txt
public-file2.txt
Now bob and whoever can request :
curl http://alice.com:8000/public-file.txt
(wildcards are not supported at this moment)
You can also make a directory publicly. In .lasso.public
:
public-file.txt
public-directory
Every file in public-directory
are exposed,
curl http://alice.com:8000/public-directory/file1.txt
(note that making a directory public is not making its subdirectories public too, you have to explicitily write every directory you want to make public into .lasso.public
)
This is Lasso philosophy, you just use your lasso to quickly grab some files, with a very basic layer of security.
Commands
You can also use command keywords, for example :
curl http://alice.com:8000/public-directory/latest -u bob