133

Is it possible to have a one line command in python to do a simple ftp server? I'd like to be able to do this as quick and temporary way to transfer files to a linux box without having to install a ftp server. Preferably a way using built in python libraries so there's nothing extra to install.

3
  • 8
    Unless you use an external python library like pftftpdlib, I doubt you can do this with one line of code. Python has a built in ftp client, but not a server.
    – GWW
    Feb 14, 2011 at 16:40
  • 4
    transfer files to linux??? why don't you just use scp?
    – Leonmax
    Dec 2, 2014 at 17:52
  • Why not use sshfs? For fastest transfer rates (in a LAN) use option -o Ciphers=arcfour, i.e. sshfs $REMOTEHOST:$DIRECTORY $MOUNTPOINT -o Ciphers=arcfour and copy, move, rename, manage your files in your filesystem. sshfs is also available for Mac OSX.
    – erik
    Jul 27, 2015 at 10:05

9 Answers 9

156

Obligatory Twisted example:

twistd -n ftp

And probably useful:

twistd ftp --help

Usage: twistd [options] ftp [options].
WARNING: This FTP server is probably INSECURE do not use it.
Options:
  -p, --port=           set the port number [default: 2121]
  -r, --root=           define the root of the ftp-site. [default:
                    /usr/local/ftp]
  --userAnonymous=  Name of the anonymous user. [default: anonymous]
  --password-file=  username:password-style credentials database
  --version         
  --help            Display this help and exit.
11
  • 8
    Very nice! But the OP asked to use the standard python library because he didn't want to install other libraries. Feb 14, 2011 at 17:03
  • 26
    Right, I do deserve down-voting, but really, people should know Twisted. And of course Twisted is in the base install of many Linuxes.
    – Ali Afshar
    Feb 14, 2011 at 17:42
  • 2
    I didn't down-vote because it's a nice answer, ever if a bit O, and people from the future will find it useful when they search for similar problems. Feb 14, 2011 at 17:52
  • 1
    @MichaelA Should certainly work on windows. p.s. It's weird visiting my own future.
    – Ali Afshar
    Apr 4, 2016 at 5:09
  • 2
    On most platforms twisted install is as easy as pip install -U twisted which is not directly mentioned on the linked site. Apr 7, 2016 at 5:56
122

Check out pyftpdlib from Giampaolo Rodola. It is one of the very best ftp servers out there for python. It's used in google's chromium (their browser) and bazaar (a version control system). It is the most complete implementation on Python for RFC-959 (aka: FTP server implementation spec).

To install:

pip3 install pyftpdlib

From the commandline:

python3 -m pyftpdlib

Alternatively 'my_server.py':

#!/usr/bin/env python3

from pyftpdlib import servers
from pyftpdlib.handlers import FTPHandler
address = ("0.0.0.0", 21)  # listen on every IP on my machine on port 21
server = servers.FTPServer(address, FTPHandler)
server.serve_forever()

There's more examples on the website if you want something more complicated.

To get a list of command line options:

python3 -m pyftpdlib --help

Note, if you want to override or use a standard ftp port, you'll need admin privileges (e.g. sudo).

7
  • 1
    As of 1.3.0: >>> from pyftpdlib import ftpserver: pyftpdlib\ftpserver.py:54: DeprecationWarning: pyftpdlib.ftpserver module is deprecated Dec 30, 2013 at 11:44
  • 2
    Updated Wed Aug 27, 2014 for current version. Shouldn't have deprecation warnings, now. Aug 27, 2014 at 16:28
  • is this secure? Dec 27, 2017 at 14:31
  • @TechJS pyftpdlib supports ftp over TLS (RFC 4217). Dec 27, 2017 at 14:39
  • 1
    pyftpdlib was never a builtin. You would need to use pip3 to install: pip3 install pyftpdlib. Feb 22, 2021 at 20:44
48

Why don't you instead use a one-line HTTP server?

python -m SimpleHTTPServer 8000

will serve the contents of the current working directory over HTTP on port 8000.

If you use Python 3, you should instead write

python3 -m http.server 8000

See the SimpleHTTPServer module docs for 2.x and the http.server docs for 3.x.

By the way, in both cases the port parameter is optional.

5
  • 44
    I don't think this allows him to upload files. Jul 7, 2014 at 2:37
  • 3
    No resume, single connection, etc. Sep 15, 2016 at 9:36
  • @RomanPlášil it will, just run server on another end xD simply as it is
    – Reishin
    Mar 31, 2018 at 20:19
  • 8
    The question is about setting up a FTP server, not HTTP. Sep 21, 2020 at 9:48
  • Works for mac if you want to download a file from mac.
    – Lokesh
    Nov 23, 2020 at 10:10
34

The answers above were all assuming your Python distribution would have some third-party libraries in order to achieve the "one liner python ftpd" goal, but that is not the case of what @zio was asking. Also, SimpleHTTPServer involves web broswer for downloading files, it's not quick enough.

Python can't do ftpd by itself, but you can use netcat, nc:

nc is basically a built-in tool from any UNIX-like systems (even embedded systems), so it's perfect for "quick and temporary way to transfer files".

Step 1, on the receiver side, run:

nc -l 12345 | tar -xf -

this will listen on port 12345, waiting for data.

Step 2, on the sender side:

tar -cf - ALL_FILES_YOU_WANT_TO_SEND ... | nc $RECEIVER_IP 12345

You can also put pv in the middle to monitor the progress of transferring:

tar -cf - ALL_FILES_YOU_WANT_TO_SEND ...| pv | nc $RECEIVER_IP 12345

After the transferring is finished, both sides of nc will quit automatically, and job done.

3
  • 6
    Speaking of assuming... You assume that the clients are going to be unix machines with tar and nc available. What if it's windows?
    – jlh
    Jan 2, 2019 at 20:26
  • wow this is convenient. Would there be any GUI wrapper build around this? I wouldn't be able to pitch command line way to my folks, a simple UI would make it happen
    – Nikhil VJ
    Jun 24, 2021 at 9:28
  • 1
    @jlh You can use it via Cygwin on Windows, it seems. Cygwin's not a tiny install, but if you need to do much Linux-like stuff on the command-line in Windows, it should be convenient and easy. Apr 12, 2022 at 22:28
24

For pyftpdlib users. I found this on the pyftpdlib website. This creates anonymous ftp with write access to your filesystem so please use with due care. More features are available under the hood for better security so just go look:

sudo pip3 install pyftpdlib

python3 -m pyftpdlib -w  

## updated for python3 Feb14:2020

Might be helpful for those that tried using the deprecated method above.

sudo python -m pyftpdlib.ftpserver

4
  • 3
    You can skip sudo if you install in a venv
    – balki
    Nov 4, 2014 at 16:09
  • 1
    don't forget that there's the v3 variant: pip3 install pyftpdlib and python3 -m pyftpdlib -w. worked like a charm for me.
    – Ron Klein
    Jun 2, 2019 at 5:14
  • thanks! This works beautifully for quick transfer between computers at home.
    – Nikhil VJ
    Jun 24, 2021 at 9:44
  • this one works nicely for me, is there a sftp server in one line?
    – ethanjyx
    Nov 5, 2021 at 20:41
6
apt-get install python3-pip

pip3 install pyftpdlib

python3 -m pyftpdlib -p 21 -w --user=username --password=password

-w = write permission

-p = desired port

--user = give your username

--password = give your password
1
  • 1
    @karel They cover the same library, but they do not look like duplicates to me. May 3, 2020 at 7:35
4

Install:

pip install twisted

Then the code:

from twisted.protocols.ftp import FTPFactory, FTPRealm
from twisted.cred.portal import Portal
from twisted.cred.checkers import AllowAnonymousAccess, FilePasswordDB
from twisted.internet import reactor

reactor.listenTCP(21, FTPFactory(Portal(FTPRealm('./'), [AllowAnonymousAccess()])))
reactor.run()

Get deeper:

http://twistedmatrix.com/documents/current/core/examples/

4

The simpler solution will be to user pyftpd library. This library allows you to spin Python FTP server in one line. It doesn’t come installed by default though, but we can install it using simple apt command

apt-get install python-pyftpdlib

now from the directory you want to serve just run the pythod module

python -m pyftpdlib -p 21 
1
  • Looks good, but what kind of authentication does happen? I get "530 Authentication failed."
    – guettli
    Sep 18, 2018 at 13:33
0

I dont know about a one-line FTP server, but if you do

python -m SimpleHTTPServer

It'll run an HTTP server on 0.0.0.0:8000, serving files out of the current directory. If you're looking for a way to quickly get files off a linux box with a web browser, you cant beat it.

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.