Python实现安全高效的SFTP服务器搭建指南 (python sftp服务器)

随着互联网的发展，越来越多的数据需要在不同终端之间进行传递和备份。而传统的FTP（File Transfer Protocol）协议因为其不安全的传输方式，已经逐渐退出历史舞台。SFTP（Secure File Transfer Protocol）作为FTP的一种安全升级版，具有更高的安全性和稳定性，因此已经成为现代数据传输的首选方式。Python作为一种高效的编程语言，具有较广泛的应用领域，本文将介绍如何使用。

之一步：准备工作

要想搭建SFTP服务器，首先需要准备一个Linux服务器，建议使用Ubuntu或CentOS，其次需要确保系统内置OpenSSH-server，可以使用以下命令进行安装：

sudo apt-get install openssh-server

sudo yum install openssh-server

然后使用sudo vim /etc/ssh/sshd_config进行编辑，找到以下几行代码，并且将其设置为no：

#PasswordAuthentication yes

#PermitEmptyPasswords no

#ChallengeResponseAuthentication yes

#PubkeyAuthentication yes

修改密码验证方式为密钥验证方式，可以有效提高安全性。

第二步：Python包安装

使用pip install paramiko，在Python中安装Paramiko包，这是一个基于Python实现的SFTP客户端/服务器，其使用SFTP协议进行传输。Paramiko还提供了一些高级的SSH功能。安装完成后可以进行验证，使用以下代码：

import paramiko

ssh=paramiko.SSHClient()

ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())

ssh.connect(“ip”,port,”user”,”password”)

stdin, stdout, stderr = ssh.exec_command(“ls”)

for i in stdout:

print i

ssh.close()

如果没有任何异常，则安装成功。

第三步：Python实现SFTP服务器搭建

在已经完成Python包安装后，就可以运用Python代码搭建SFTP服务器。代码如下：

import os

import sys

import time

import paramiko

class Server(paramiko.ServerInterface):

def __init__(self):

self.event = threading.Event()

def check_channel_request(self, kind, chanid):

if kind == ‘session’:

return paramiko.OPEN_SUCCEEDED

return paramiko.OPEN_FLED_ADMINISTRATIVE_PROHIBITED

def check_auth_password(self, username, password):

if (username == ‘test’) and (password == ‘test123’):

return paramiko.AUTH_SUCCESSFUL

return paramiko.AUTH_FLED

def get_allowed_auths(self, username):

return ‘password’

def start_server():

host_key = paramiko.RSAKey(filename=’sftpserver_rsa_key’)

transport = paramiko.Transport((‘0.0.0.0’, 22))

transport.add_server_key(host_key)

server = Server()

transport.start_server(server=server)

while True:

chan = transport.accept(1)

if chan is None:

continue

server.event.wt(10)

if not server.event.isSet():

try:

subsystem = chan.recv(1024)

chan.send(‘subsystem request for %s\n’ % subsystem)

except Exception:

pass

chan.close()

else:

print “SFTP session opening”

server.event.clear()

try:

session = transport.open_session()

session.set_name(‘sftp’)

session.invoke_subsystem(‘sftp’)

except Exception, e:

print str(e)

session.close()

transport.close()

在代码中有一些关键行如下：

1.添加密钥

host_key = paramiko.RSAKey(filename=’sftpserver_rsa_key’)

2.启动服务器并且读取命令

transport.start_server(server=server)

while True:

chan = transport.accept(1)

if chan is None:

continue

server.event.wt(10)

if not server.event.isSet():

try:

subsystem = chan.recv(1024)

chan.send(‘subsystem request for %s\n’ % subsystem)

except Exception:

pass

chan.close()

else:

print “SFTP session opening”

server.event.clear()

try:

session = transport.open_session()

session.set_name(‘sftp’)

session.invoke_subsystem(‘sftp’)

except Exception, e:

print str(e)

session.close()

transport.close()

可以看到，这段代码实现了SFTP服务器的连接和命令输入接收，并且通过RSA密钥进行传输和验证，确保了传输的安全性和稳定性。

第四步：测试

当Python代码实现完毕后，需要测试其功能。可以使用如下测试代码：

import paramiko

transport = paramiko.Transport(“ip”)

transport.connect(username=”test”, password=”test123″)

sftp = paramiko.SFTPClient.from_transport(transport)

sftp.put(“test.py”, “data/test.py”)

sftp.get(“data/test.py”, “test2.py”)

在以上代码中，通过SFTPClient对象进行传输数据，并且进行上传和下载操作。如果没有任何异常，则说明SFTP服务器已经成功搭建且正常工作。

本文通过介绍如何使用Python实现安全高效的SFTP服务器搭建以及基础功能的实现，为想要在Python中使用SFTP进行数据传输的开发者提供了一些参考。在实际应用中，可以根据自己的需求对代码进行适当修改，以实现更加高效强大的功能。

相关问题拓展阅读：

• 如何快速安装OSSFTP工具？阿里云OSS FTP安装图文详细教程
• python的paramiko模块 支持连接交换机吗

如何快速安装OSSFTP工具？阿里云OSS FTP安装图文详细教程

OSSFTP工具是一个特殊FTPserver,它接收普通FTP请求后，将对文件、文件夹的操作映射为对OSS的操作，从而使得您可以基于FTP协议来管理存储在OSS上的文件。

注意生产环境请使用osssdk,OSSFTP工具主要面向个人用户使用。

主要特性

跨平台:

无论是Windows、Linux还是Mac，无论是32位还是64位操作系统，无论是图形界面还是命令行都可以运行。

免安装:

解压后可直接运行。

免设置:

无需设置即可运行。

透明化:

FTP工具是python写的，您可以看到完整的源码，我们稍后也会开源到Github。

主要功能

支持文件和文件夹的上传、下载、删除等操作。

通过Multipart方式，分片上传大文件。

支持大部分FTP指令，可以满足日常FTP的使用需求。

注腔毁意

1.目前在1.0版本中，考虑到安装部署的简便，OSSFTP工具没有支持TLS加密。由于FTP协议是明文传输的，

为了防止您的密码泄漏，建议将FTPserver和client运行在同一台机器上，通过127.0.0.1:port的方式来访问。

2.不支持rename和move操作。

3.安装包解压后的路径不要含有中文。

4.FTPserver的管理控制页面在低版本的IE中可能打不开。

5.FTPserver支持的Python版本:Python2.6,Python2.7。

下载

由于Windows不会默认安装Python2.7，所以安装包中包含了Python2.7，免去您python安装配置的麻烦，解压即可使用。

由于Linux/Mac系统默认会安装Python2.7或Python2.6，所以安装包中不再包含可执行的python,只包含了相关依赖库。

运行

首先解压之前下载的文件，然后根据环境情况选择不同的运行方式。

Windows:双击运行start.vbs即可

Linux:打开终端，运行 i.$bashstart.sh

Mac:双击start.command，或者在终端运行 i.$bashstart.command

上述步骤会启动一个FTPserver,默认监听在127.0.0.1的2023端口。同时，为了方便您对FTPserver的状态进行管控，还会启动一羡和个web服务器，监听在127.0.0.1的8192端口。如果您的系统有图形界面，还会自动打开控制页面，

如下所示：

大部分情况不要任何配置，就可以运行一个FTPserver了，如果想对FTPserver进行配置,请注意需要重启才能生效。

连接到FTPserver推荐使用FileZilla客户端去连接FTPserver。

下载安装后，按如下方式连接即可:

主机:127.0.0.1

登录类型：正常

用户：access_key_id/bucket_name

密码：access_key_secret

注意：

用户中，/是必须的，如用户

tSxyiUM3NKswPMEp/test-hz-jh-002。

-access_key_id和access_key_secret的获取

高级使用

通过控制页面管理FTPserver

修改监听地址

如果需要通过网络来访问FTPserver,那么需要修改监听地址，因为默认的监听地址127.0.0.1只允许来自本地的访问。可以修改成内网ip或公网ip。

修改监听端口

修改FTPserver监听的端口,建议端口大于1024，因为监听1024以下的端口时需要管理员权限.

修改日志等级

设置FTPserver的日志级别。FTPserver的日志会输出到data/ossftp/目录下，可以通过控制页面的日志按钮在线查看。默认的日志界别为INFO,打印的日志信息较少，如果需要更详细的日志信息，可以修改为DEBUG模式。如果伍派备希望减少日志的输出，可以设置级别为WARNING或ERROR等。

设置Bucketendpoints

FTPserver默认会探索bucket的所属location信息，随后将请求发到对应的region（如oss-cn-hangzhou.aliyuncs.com或oss-cn-beijing.aliyuncs.com)，FTPserver会优先尝试内网访问oss。如果您设置了bucketendpoints,如设置为test-bucket-a.oss-cn-hangzhou.aliyuncs.com，那么当访问test-bucket-a时，就会使用oss-cn-hangzhou.aliyuncs.com域名。

注意

所有修改都需要重启才能生效。

上述的所有修改其实都是修改的ftp根目录下的config.json，所以您可以直接修改该文件。

直接启动FTPserver(Linux/Mac)

可以直接启动ossftp目录下的ftpserver.py,免去web_server的开销。

1.python ossftp/ftpserver.py  

配置修改方式同上。

可能遇到的问题

如果连接FTPserver时，遇到以下错误：

有两种可能:

输入的access_key_id和access_key_secret有误。

解决

：请输入正确的信息后再重试。

所用的access_key信息为ram子账户的access_key，而子账户不具有Listbuckets权限。

解决

：当使用子账户访问时，请在控制页面中指定bucketendpoints，即告诉FTPserver某个bucket应该用什么endpoint来访问。同时，子账户也需要一些必须的权限，关于使用ram访问oss时的访问控制。

只读访问

OSSFTP工具需要的权限列表为ListObjects、GetObject、HeadObject。关于如何创建一个具有只读访问的ram子账户，请参考图文教程如何结合ram实现文件共享。

上传文件

如果允许ram子账户上传文件，还需要PutObject。

删除文件

如果允许ram子账户删除文件，还需要DeleteObject。

如果您在Linux下运行FTPserver，然后用FileZilla连接时遇到如下错误:

501 can’t decode path (server filesystem encoding is ANSI_X3.4-1968)

一般是因为本地的中文编码有问题。在将要运行start.sh的终端中输入下面的命令，然后再重新启动即可。

1

.$ export LC_ALL=en_US.UTF-8; export LANG=”en_US.UTF-8″; locale

python的paramiko模块 支持连接交换机吗

paramiko使用

paramiko模块是基于python实现了SSH2远程安全连接，支持认证和密钥方式，可以实现远程连接、命令执行、文件传输、中间SSH代理功能

安装

pip install paramiko

或 easy_install paramiko

paramiko依赖第三方的Crypto，Ecdsa和罩滚pyhton-devel,所以需要安装

paramiko核心组件

SSHClient类

SSHClient类是SSH服务会话的高级表示，该类实现了传输、通道、以及SFTP的校验、建立的方法

connect 方法

connect方法实现了远程ssh连接并作校验

hostname 连接的目标主机

port=SSH_PORT 指定端口

username=None 验证的用户名

password=None 验证的用户密码

pkey=None 私钥方式用于身份验证

key_filename=None 一个文件名或文件列表，指定私钥文件

timeout=None 可选的tcp连接拆晌超时时间

allow_agent=True, 是否允许连接到ssh代理，默认为True 允许

look_for_keys=True 是否在~/.ssh中搜索私钥文件，默认为True 允许

compress=False, 是否打开压缩

sock=None,

gss_auth=False,

gss_kex=False,

gss_deleg_creds=True,

gss_host=None,

banner_timeout=None

参数

exec_command方法

远程执行命令的方法，该命令的输入与输出流为标准输入、标出输出、标准错误输出

command 执行的命令

bufsize=-1 文件缓冲区大小

timeout=None

get_pty=False

参数

load_system_host_key方法

夹在本地公钥文件，默认为~/.ssh/known_hosts

filename=None 指定本地公钥文件

参数

set_missing_host_key_policy方法

设物御余置连接的远程主机没有本地主机密钥或HostKeys对象时的策略，目前支持三种：

用法：

set_missing_host_key_policy(paramiko.AutoAddPolicy())

AutoAddPolicy 自动添加主机名及主机密钥到本地HostKeys对象，不依赖load_system_host_key的配置。即新建立ssh连接时不需要再输入yes或no进行确认

WarningPolicy 用于记录一个未知的主机密钥的python警告。并接受，功能上和AutoAddPolicy类似，但是会提示是新连接

RejectPolicy 自动拒绝未知的主机名和密钥，依赖load_system_host_key的配置。此为默认选项

SFTPClient类

SFTPCLient作为一个sftp的客户端对象，根据ssh传输协议的sftp会话，实现远程文件操作，如上传、下载、权限、状态

from_transport(cls,t) 创建一个已连通的SFTP客户端通道

put(localpath, remotepath, callback=None, confirm=True) 将本地文件上传到服务器 参数confirm：是否调用stat()方法检查文件状态，返回ls -l的结果

get(remotepath, localpath, callback=None) 从服务器下载文件到本地

mkdir() 在服务器上创建目录

remove() 在服务器上删除目录

rename() 在服务器上重命名目录

stat() 查看服务器文件状态

listdir() 列出服务器目录下的文件

远程连接并执行命令

实现远程连接主机，并执行命令，同时记录日志

* 直接验证方式

import paramiko

host = ‘172.16.200.45’port = 22user = ‘root’passwd = ‘123123’# 创建SSH对象ssh = paramiko.SSHClient()# 允许连接不在know_hosts文件中的主机ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())# 连接服务器ssh.connect(hostname=host, port=port, username=user, password=passwd)

paramiko.util.log_to_file(‘syslogin.log’)  #将登录信息记录日志

# 执行命令stdin, stdout, stderr = ssh.exec_command(‘df’)# 获取命令结果result = stdout.read()print(result)# 关闭连接ssh.close()

SSHClient 封装 Transport

import paramiko

host = ‘172.16.200.45’port = 22user = ‘root’passwd = ‘123123’transport = paramiko.Transport((host, port))

transport.connect(username=user, password=passwd)

ssh = paramiko.SSHClient()

ssh._transport = transport

stdin, stdout, stderr = ssh.exec_command(‘df’)print(stdout.read())

基于公钥密钥连接

import paramiko

private_key = paramiko.RSAKey.from_private_key_file(‘/home/fuzengjie/.ssh/id_rsa’)

# 创建SSH对象ssh = paramiko.SSHClient()# 允许连接不在know_hosts文件中的主机ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())# 连接服务器ssh.connect(hostname=’172.16.200.45′, port=22, username=’fuzengjie’, key=private_key)

# 执行命令stdin, stdout, stderr = ssh.exec_command(‘df’)# 获取命令结果result = stdout.read()

# 关闭连接ssh.close()

SSHClient 封装 Transport 使用公钥方式

import paramiko

private_key = paramiko.RSAKey.from_private_key_file(‘/home/fuzengjie/.ssh/id_rsa’)

transport = paramiko.Transport((‘172.16.200.45’, 22))

transport.connect(username=’fuzengjie’, pkey=private_key)

ssh = paramiko.SSHClient()

ssh._transport = transport

stdin, stdout, stderr = ssh.exec_command(‘df’)

transport.close()

远程连接实现文件上传下载

基于用户名密码上传下载

import paramiko

host = ‘172.16.200.45’port = 22user = ‘root’passwd = ‘123123’transport = paramiko.Transport((host,port))

transport.connect(username=user,password=passwd)

sftp = paramiko.SFTPClient.from_transport(transport)# 将location.py 上传至服务器 /tmp/test.pya = sftp.put(‘/Users/fuzengjie/1’, ‘/tmp/fuzj123’,confirm=True)print(a)  #打印上传到服务器上的文件状态# 将remove_path 下载到本地 local_pathsftp.get(‘/root/tesst.py’, ‘/Users/fuzengjie/test.py’)

transport.close()

基于公钥密钥上传下载

import paramiko

private_key = paramiko.RSAKey.from_private_key_file(‘/home/fuzengjie/.ssh/id_rsa’)

transport = paramiko.Transport((‘172.16.200.45’, 22))

transport.connect(username=’fuzengjie’, pkey=private_key )

sftp = paramiko.SFTPClient.from_transport(transport)# 将location.py 上传至服务器 /tmp/test.pysftp.put(‘/tmp/location.py’, ‘/tmp/test.py’)# 将remove_path 下载到本地 local_pathsftp.get(‘/root/123.txt’, ‘/tmp/123’)

transport.close()

堡垒机实现

架构

堡垒机的主要作用权限控制和用户行为审计，堡垒机就像一个城堡的大门，城堡里的所有建筑就是你不同的业务系统 ， 每个想进入城堡的人都必须经过城堡大门并经过大门守卫的授权，每个进入城堡的人必须且只能严格按守卫的分配进入指定的建筑，且每个建筑物还有自己的权限访问控制，不同级别的人可以到建筑物里不同楼层的访问级别也是不一样的。还有就是，每个进入城堡的人的所有行为和足迹都会被严格的监控和纪录下来，一旦发生犯罪事件，城堡管理人员就可以通过这些监控纪录来追踪责任人。 



堡垒机执行流程：

管理员为用户在服务器上创建账号（将公钥放置服务器，或者使用用户名密码）

用户登陆堡垒机，输入堡垒机用户名密码，现实当前用户管理的服务器列表

用户选择服务器，并自动登陆

执行操作并同时将用户操作记录

代码

import paramikoimport sysimport osimport socketimport getpassfrom paramiko.py3compat import u# windows does not have termios…try:    import termios    import tty

   has_termios = Trueexcept ImportError:

   has_termios = Falsedef interactive_shell(chan):    if has_termios:

posix_shell(chan)    else:

windows_shell(chan)def posix_shell(chan):    import select

   oldtty = termios.tcgetattr(sys.stdin)    try:

tty.setraw(sys.stdin.fileno())

tty.setcbreak(sys.stdin.fileno())

chan.settimeout(0.0)

log = open(‘handle.log’, ‘a+’, encoding=’utf-8′)

flag = False

temp_list = while True:

r, w, e = select.select(, , )if chan in r:  try:

     x = u(chan.recv(1024))      if len(x) == 0:

sys.stdout.write(‘\r\n*** EOF\r\n’)break

     if flag:if x.startswith(‘\r\n’):pass

else:

temp_list.append(x)

flag = False

     sys.stdout.write(x)

     sys.stdout.flush()  except socket.timeout:      pass

if sys.stdin in r:

 x = sys.stdin.read(1)  import json  if len(x) == 0:      break

 if x == ‘\t’:

     flag = True  else:

     temp_list.append(x)  if x == ‘\r’:

     log.write(”.join(temp_list))

     log.flush()

     temp_list.clear()

 chan.send(x)    finally:

termios.tcsetattr(sys.stdin, termios.TCSADRAIN, oldtty)def windows_shell(chan):    import threading

   sys.stdout.write(“Line-buffered terminal emulation. Press F6 or ^Z to send EOF.\r\n\r\n”)    def writeall(sock):while True:

data = sock.recv(256)if not data:

 sys.stdout.write(‘\r\n*** EOF ***\r\n\r\n’)

 sys.stdout.flush()  break

sys.stdout.write(data)

sys.stdout.flush()

   writer = threading.Thread(target=writeall, args=(chan,))

   writer.start()    try:while True:

d = sys.stdin.read(1)if not d:  break

chan.send(d)    except EOFError:# user hit ^Z or F6

passdef run():

   default_username = getpass.getuser()

   username = input(‘Username : ‘ % default_username)    if len(username) == 0:

username = default_username

   hostname = input(‘Hostname: ‘)    if len(hostname) == 0:print(‘*** Hostname required.’)

sys.exit(1)

   tran = paramiko.Transport((hostname, 22,))

   tran.start_client()

   default_auth = “p”

   auth = input(‘Auth by (p)assword or (r)sa key ‘ % default_auth)    if len(auth) == 0:

auth = default_auth    if auth == ‘r’:

default_path = os.path.join(os.environ, ‘.ssh’, ‘id_rsa’)

path = input(‘RSA key : ‘ % default_path)if len(path) == 0:

path = default_pathtry:

key = paramiko.RSAKey.from_private_key_file(path)except paramiko.PasswordRequiredException:

password = getpass.getpass(‘RSA key password: ‘)

key = paramiko.RSAKey.from_private_key_file(path, password)

tran.auth_publickey(username, key)    else:

pw = getpass.getpass(‘Password for %s@%s: ‘ % (username, hostname))

tran.auth_password(username, pw)    # 打开一个通道

   chan = tran.open_session()    # 获取一个终端    chan.get_pty()    # 激活器    chan.invoke_shell()

   interactive_shell(chan)

   chan.close()

   tran.close()if __name__ == ‘__main__’:

   run()