如何将Python Docker容器内的文件传输至远程SFTP服务器？

一、先排查认证失败的核心原因 #

出现paramiko.ssh_exception.AuthenticationException，优先从以下方向排查：

• 确认SFTP服务器的主机地址、端口、用户名、密码完全匹配，注意端口是否为默认22还是自定义端口
• 测试容器网络连通性：在容器内执行telnet <sftp-host> <port>或nc -zv <sftp-host> <port>，确认能正常访问服务器端口
• 检查SFTP服务器日志，查看具体认证失败细节（比如密码错误、用户无SFTP权限、IP被服务器防火墙拦截）
• 如果服务器采用密钥认证，不要用密码参数，需加载对应私钥文件

二、纠正Paramiko的使用方式 #

你当前通过ssh.exec_command调用sftp命令的方式完全没必要，Paramiko本身提供了原生SFTP客户端能力，直接使用即可：

import os
import paramiko

# 初始化SSH客户端
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())

try:
    # 连接SFTP服务器（替换为你的实际参数）
    ssh.connect(
        hostname="SFTP主机地址",
        port=22,
        username="用户名",
        password="密码",
        # 若用密钥认证，替换为以下两行并注释password参数
        # key_filename="/容器内私钥路径/id_rsa",
        # passphrase="私钥密码（如有）"
    )

    # 创建SFTP客户端
    sftp = ssh.open_sftp()

    # 上传文件：容器内路径 -> SFTP服务器路径
    local_file = "/容器内文件路径/比如/data.csv"
    remote_file = "/SFTP服务器目标路径/比如/upload/data.csv"
    sftp.put(local_file, remote_file)

    # 可选：验证上传完整性
    if sftp.stat(remote_file).st_size == os.path.getsize(local_file):
        print("文件上传成功")

finally:
    # 确保连接关闭
    if 'sftp' in locals():
        sftp.close()
    ssh.close()

三、更优的替代方案 #

如果不需要Python脚本的灵活性，这些方案更简单直接：

1. 直接用sftp命令行
   在Docker镜像中安装openssh-client（Debian/Ubuntu：apt-get install -y openssh-client），然后执行：

# 交互式输入密码
sftp -P <端口> <用户名>@<SFTP主机>:<远程路径> <容器内文件路径>

# 非交互式（用sshpass，需提前安装：apt-get install -y sshpass）
sshpass -p "你的密码" sftp -P <端口> <用户名>@<SFTP主机>:<远程路径> <容器内文件路径>

2. 用rsync（服务器支持时）
   适合大文件传输，速度更快，同样需要安装rsync和openssh-client：

rsync -avz -e 'ssh -p <端口>' <容器内文件路径> <用户名>@<SFTP主机>:<远程路径>

3. 使用pysftp库
   是Paramiko的轻量封装，API更简洁，需先安装pip install pysftp：

import pysftp

with pysftp.Connection(host="SFTP主机", username="用户名", password="密码", port=22) as sftp:
    sftp.put("/容器内文件路径", "/远程目标路径")

四、Docker环境注意事项 #

• 若用Python库，需在容器中安装依赖（比如pip install paramiko pysftp）
• 若用密钥认证，需将私钥挂载到容器内，且权限设为600（chmod 600 /容器内私钥路径），否则SSH会拒绝使用
• 构建镜像时提前安装所需命令行工具（openssh-client、sshpass、rsync等），避免运行时安装耗时

内容的提问来源于stack exchange，提问作者lbened