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安装图文详细教程
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()
