Ruslan's Blog Ruslan's Blog
SFTP server with Python and Paramiko in under a minute

I needed a simple server that could be used as a stub for testing Python SFTP clients so I whipped out one over the weekend.
It’s a simple single-threaded server so it’s not for production use but give it a try anyways, you might find it useful too.


$ [sudo] pip install sftpserver

Running the server:

    $ sftpserver
    Usage: sftpserver [options]
    -k/--keyfile should be specified

      -h, --help            show this help message and exit
      --host=HOST           listen on HOST [default: localhost]
      -p PORT, --port=PORT  listen on PORT [default: 3373]
      -l LEVEL, --level=LEVEL
                            Debug level: WARNING, INFO, DEBUG [default: INFO]
      -k FILE, --keyfile=FILE
                            Path to private key, for example /tmp/test_rsa.key

    $ sftpserver -k /tmp/test_rsa.key -l DEBUG

Connecting with a Python client to our server:

>>> import paramiko
>>> pkey = paramiko.RSAKey.from_private_key_file('/tmp/test_rsa.key')
>>> transport = paramiko.Transport(('localhost', 3373))
>>> transport.connect(username='admin', password='admin', pkey=pkey)
>>> sftp = paramiko.SFTPClient.from_transport(transport)
>>> sftp.listdir('.')
['', '']

The server code itself is pretty minimal, check it out on GitHub.

arrow5 Responses

  1. 38 mos ago

    Nice work! How about making it use PyFilesystem? It could be useful for testing to be able to use an in-memory filesystem.


  2. Ruslan Spivak
    38 mos ago

    Hi Andrei,

    Thanks for pointing out PyFilesystem. I’ll look into it.

  3. 38 mos ago

    The ‘fsserve’ command in PyFilesystem can serve a directory over sftp.

    For example, to serve the current working directory:

    $ sudo fsserve -t sftp

    And this to get a directory listing:

    $ fsls sftp://

    You might want to join the PyFilesystem mailing list!

  4. Ruslan Spivak
    38 mos ago

    I didn’t know that, really neat! Thanks for the information, Will.

  5. horizon
    17 mos ago

    why not use paramiko common class ,such as from sftp_server import SFTPServer

Leave A Comment