Python操作服务器文件是常见的需求,尤其在自动化运维、数据处理等场景中，根据服务器类型和访问协议的不同，Python提供了多种方式来实现对远程服务器文件的读取、写入和管理，本文将详细介绍几种主流方法，包括基于SSH、FTP、HTTP/S以及云存储服务的操作方式，并附上代码示例和注意事项。
基于SSH协议操作服务器文件
SSH（Secure Shell）是远程服务器管理的标准协议，Python中可通过paramiko库实现SSH连接及文件操作。paramiko是一个纯Python实现的SSH协议库，支持执行远程命令、传输文件（SFTP）等功能。
安装依赖：
pip install paramiko
核心步骤：
- 建立SSH连接：使用
SSHClient()创建客户端，通过connect()方法指定服务器IP、端口、用户名及密码（或密钥）。 - 执行远程命令：通过
exec_command()运行服务器端命令（如ls、cat等）。 - 文件传输（SFTP）：通过
open_sftp()获取SFTP客户端，实现上传、下载、删除文件等操作。
代码示例：
import paramiko
# 创建SSH客户端
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) # 自动添加主机密钥（生产环境需谨慎）
ssh.connect(hostname="服务器IP", port=22, username="用户名", password="密码")
# 执行远程命令
stdin, stdout, stderr = ssh.exec_command("ls -l /home/user/")
print(stdout.read().decode())
# SFTP文件上传
sftp = ssh.open_sftp()
sftp.put("本地文件.txt", "/home/user/远程文件.txt") # 上传文件
sftp.get("/home/user/远程文件.txt", "下载的文件.txt") # 下载文件
sftp.close()
ssh.close()
基于FTP/FTPS协议操作服务器文件
FTP（File Transfer Protocol）是常用的文件传输协议，Python内置ftplib库支持FTP操作；若需加密传输，可使用FTPS（FTP over SSL/TLS）。
核心步骤：
- 建立FTP连接：使用
FTP()或FTP_TLS()（FTPS）创建客户端，通过connect()连接服务器，login()登录。 - 文件操作：通过
storbinary()上传文件、retrbinary()下载文件、nlst()列出文件等。
代码示例（FTPS）：
from ftplib import FTP_TLS
# 建立FTPS连接
ftp = FTP_TLS()
ftp.connect("ftp服务器IP", 21)
ftp.login("用户名", "密码")
ftp.prot_p() # 启用数据连接加密
# 下载文件
with open("本地文件.txt", "wb") as f:
ftp.retrbinary("RETR 远程文件.txt", f.write)
# 上传文件
with open("本地文件.txt", "rb") as f:
ftp.storbinary("STOR 新远程文件.txt", f)
ftp.quit()
基于HTTP/S协议访问服务器文件
若服务器文件通过HTTP/S服务提供（如WebDAV、静态资源服务器），Python可使用requests库实现文件下载或上传。
核心步骤：
- 发送HTTP请求：通过
requests.get()或requests.post()访问文件URL，支持添加认证头（如Bearer Token）。 - 处理响应：若为文件流，可通过
response.content获取二进制数据并写入本地文件。
代码示例：
import requests
url = "http://服务器IP/path/to/file.txt"
headers = {"Authorization": "Bearer your_token"} # 若需认证
response = requests.get(url, headers=headers, stream=True) # 流式下载
if response.status_code == 200:
with open("下载的文件.txt", "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
操作云存储服务（如AWS S3）
若服务器文件存储在云平台（如AWS S3、阿里云OSS），可通过官方SDK操作，以AWS S3为例，使用boto3库。
安装依赖：
pip install boto3
代码示例：
import boto3
# 创建S3客户端
s3 = boto3.client(
"s3",
aws_access_key_id="your_access_key",
aws_secret_access_key="your_secret_key",
region_name="us-east-1"
)
# 下载文件
s3.download_file("bucket-name", "remote_file.txt", "local_file.txt")
# 上传文件
s3.upload_file("local_file.txt", "bucket-name", "new_remote_file.txt")
不同协议适用场景对比
| 协议 | 适用场景 | 常用库 | 特点 |
|---|---|---|---|
| SSH | 远程服务器文件管理、命令执行 | paramiko | 安全性高，支持SFTP文件传输 |
| FTP/FTPS | 传统文件传输，兼容旧系统 | ftplib | 简单易用，FTPS支持加密 |
| HTTP/S | Web服务文件访问，API接口调用 | requests | 灵活，适合基于HTTP的文件服务 |
| 云存储SDK | AWS S3、阿里云OSS等云平台文件操作 | boto3/oss2 | 专为云设计，支持大规模文件管理 |
注意事项
- 权限与认证：确保操作用户有对应文件读写权限，避免使用明文密码（建议使用SSH密钥、环境变量或密钥管理工具）。
- 异常处理：网络中断、权限错误等需通过
try-except捕获异常（如paramiko.SSHException、requests.exceptions.RequestException）。 - 资源释放：操作完成后及时关闭连接（如
ssh.close()、ftp.quit()），避免资源泄露。
相关问答FAQs
Q1：如何处理SSH连接时的“Authentication failed”错误？
A1：该错误通常由认证信息错误导致，检查用户名、密码或SSH密钥是否正确；若使用密钥，确保密钥文件路径正确且权限设置（chmod 600）符合要求，确认服务器是否允许密码登录（需检查/etc/ssh/sshd_config中的PasswordAuthentication配置）。
Q2：Python如何高效下载大文件到本地？
A2：对于大文件，建议使用流式下载（stream=True），避免一次性加载整个文件到内存，使用requests时，通过iter_content()分块读取并写入文件；使用paramiko的SFTP时，可直接调用get()方法，其底层已实现流式传输，可开启多线程/多进程下载（如concurrent.futures）加速下载过程。
