

## 引言

本地用 Windows，服务器跑 Linux，文件怎么传？这是每个后端开发和运维绕不开的问题。用惯了图形界面的人不会每次都敲 scp 命令，自然会选择一个 SFTP 客户端——配置好会话信息，双击连接，左边是本地目录，右边是服务器，拖拽搞定。

但理想很丰满，现实往往是一个弹窗："Network error: Connection refused"或者"Host does not exist"。同样是填 IP、端口、用户名、密码四个参数，为什么有时候连不上？

本文整理了 SFTP 连接失败的五个常见原因和排查步骤，不针对某个特定工具，所有基于 SSH/SFTP 协议的客户端都适用。

## 一、端口检查：22 端口是不是通的

### 问题现象

客户端提示 "Connection timed out"、"Network error: Connection refused"、"No route to host" 等网络层错误。

### 排查思路

SFTP 建立在 SSH 协议之上，默认使用 22 端口。如果这个端口不通，所有基于 SSH 的操作都会失败——不只是文件传输，终端登录也一样。

**检查清单：**

1. 确认服务器上的 SSH 服务是否在运行。登录到服务器（通过控制台 VNC 或其他方式），执行：

```bash
systemctl status sshd
```

如果显示 inactive 或 failed，说明 SSH 服务没起来：

```bash
systemctl start sshd
systemctl enable sshd
```

2. 确认 SSH 服务监听的端口。有些运维出于安全考虑会修改默认端口：

```bash
netstat -tlnp | grep sshd
```

如果输出显示的不是 22 端口（比如 2222），客户端里填的端口号也要相应修改。

3. 确认防火墙是否放行了 SSH 端口。以 CentOS 7+ 的 firewalld 为例：

```bash
firewall-cmd --list-ports
```

如果输出中没有 22/tcp，需要添加：

```bash
firewall-cmd --permanent --add-port=22/tcp
firewall-cmd --reload
```

如果是云服务器（腾讯云 CVM 等），还需要检查**安全组规则**。登录云控制台，确认入站规则中有一条"协议 TCP、端口 22、来源 0.0.0.0/0"（或限制为你的 IP）。很多人配置了服务器端的防火墙，却忘了云平台还有一层安全组。

**验证端口是否可达**：在本机命令行执行：

```bash
telnet 服务器公网IP 22
```

如果看到 `SSH-2.0-OpenSSH_` 开头的字符串，说明端口已通。如果一直卡在 "Connecting..." 然后超时，说明端口被拦截了。

## 二、认证问题：密码、密钥、用户名的排列组合

### 问题现象

客户端提示 "Access denied"、"Authentication failed"、"Permission denied"，说明网络已通，但 SSH 服务拒绝了你的登录请求。

### 排查思路

SSH 认证失败的原因可以归为三类：

**第一类：密码错误**

这个不用多说。但有个常见场景是云服务器的初始密码——如果你没有重置过密码，系统生成的初始密码可能包含特殊字符，手动输入时容易打错。建议在客户端里复制粘贴密码，不要手打。

另外，部分 Linux 发行版的默认配置禁止 root 用户通过 SSH 密码登录。检查 `/etc/ssh/sshd_config`：

```
PermitRootLogin prohibit-password
```

如果值是 `prohibit-password` 或 `no`，root 用户不能用密码登录。改成 `yes` 后重启 sshd 服务，或者新建一个普通用户来登录。

**第二类：密钥认证配置问题**

如果服务器配置了密钥认证，但没有正确配置：

- 本地私钥文件路径是否正确（.ppk 用于 PuTTY/WinSCP，.pem 用于 OpenSSH）
- 服务器上的 `~/.ssh/authorized_keys` 文件权限是否正确（必须为 600）
- `.ssh` 目录权限是否正确（必须为 700）
- 私钥是否有密码保护，且在客户端中正确输入了

验证密钥是否有效的最快方法：用命令行 ssh 试一下。

```bash
ssh -i C:\path\to\private_key.ppk username@server_ip
```

如果命令行能登上，说明密钥没问题，问题出在客户端的密钥配置路径。

**第三类：用户名和系统不匹配**

不同 Linux 发行版的默认用户名不同：

| 系统 | 默认用户名 |
|------|-----------|
| CentOS 7/8 | root |
| Ubuntu 18.04+ | ubuntu |
| Debian 10+ | 安装时指定，或 root |
| OpenSUSE | root |
| AlmaLinux / Rocky | root |

最常见的情况：买了 Ubuntu 系统的云服务器，在 SFTP 客户端里填的用户名是 root，但 Ubuntu 默认禁止 root SSH 登录。应该用 ubuntu 用户登录，然后 `sudo -i` 切换到 root。

## 三、DNS 与网络策略：域名解析失败或被中间设备阻断

### 问题现象

客户端提示 "Host does not exist"、"Network is unreachable"、"Connection reset by peer"。

### 排查思路

**域名解析问题**：如果你填的是域名而不是 IP 地址，先用 `nslookup` 或 `ping` 验证域名是否能正确解析到 IP。如果是公司内网 DNS 没配好，尝试直接填 IP 地址看能不能连上。

**公司网络策略**：很多公司的企业防火墙默认封锁 22 端口，只允许 80 和 443。如果你在公司网络内连不上个人服务器，换手机热点试一下——如果热点能连上，说明是公司防火墙的问题。解决方案是让运维在防火墙上给你开白名单，或者把服务器的 SSH 端口改到 443（HTTPS 端口通常不会被封）。

**服务器端 fail2ban 的误封**：如果你短时间内多次输错密码，服务器的 fail2ban 或类似入侵防御系统可能已经把你的 IP 封了。在服务器上检查：

```bash
fail2ban-client status sshd
```

如果显示你的 IP 在 banned 列表中：

```bash
fail2ban-client set sshd unbanip 你的IP
```

## 四、加密算法协商失败：客户端和服务器端的 SSH 版本不匹配

### 问题现象

客户端提示 "The server rejected the connection"、"No supported authentication methods available"、"Algorithm negotiation failed"。

### 排查思路

SSH 协议的握手过程需要进行加密算法协商——客户端告诉服务器自己支持哪些算法，服务器选一个双方都支持的。如果服务器上的 OpenSSH 版本很旧（比如 CentOS 6 自带的 OpenSSH 5.3），或者服务器管理员出于安全考虑禁用了某些算法，就可能协商失败。

**检查服务器端支持的算法**：

```bash
ssh -Q cipher
ssh -Q mac
ssh -Q kex
```

**检查客户端支持的算法**：以 WinSCP 为例，在连接时勾选"高级设置"→ 左侧"SSH → 加密"，可以看到客户端支持的加密算法列表。

如果发现不匹配，可以在客户端中手动调整算法优先级，或者在服务器端更新 OpenSSH 到较新版本。对于安全敏感的环境，推荐至少使用 aes256-ctr 或 chacha20-poly1305 加密算法，避免使用已被标记为不安全的 arcfour 和 cbc 系列。

## 五、字符编码与传输后文件损坏问题

### 问题现象

连接成功，文件也传过去了，但传输后出现以下问题：

- 中文文件名在服务器上显示为乱码
- 文本文件的内容乱码
- 文件大小发生变化
- shell 脚本传到服务器后无法执行（多了回车符）

### 排查思路

**文件名乱码**：这是由于客户端和服务器端的字符编码不一致。大多数现代 Linux 服务器使用 UTF-8 编码，但部分老系统可能是 GBK 或 ISO-8859-1。检查服务器端的 locale 设置：

```bash
echo $LANG
```

正常输出应该是 `en_US.UTF-8` 或 `zh_CN.UTF-8`。如果是不带 UTF-8 的值，需要在客户端的环境设置中指定使用 UTF-8 编码。

以 WinSCP 为例，在"环境 → 文件名 UTF-8 编码"中可以设置。一般勾选"自动"即可，WinSCP 会尝试检测服务器端的编码。如果自动检测失败，可以手动指定为 UTF-8。

**文本内容乱码**：文本文件传输后的内容乱码，通常是因为传输模式选错了。SFTP 协议中有两种传输模式：

- **文本模式（ASCII 模式）**：会自动转换换行符（Windows 的 CRLF ↔ Linux 的 LF），以及可能的编码转换。
- **二进制模式（Binary 模式）**：原封不动传输，不做任何转换。

规则很简单——**除纯文本文件（.txt、.csv、.sh、.conf、.log 等）外，全部用二进制模式传输**。图片、压缩包、可执行文件、数据库文件如果用文本模式传输，必然损坏。现在主流的 SFTP 客户端默认用二进制模式，一般不需要改，但如果手动切成了文本模式，就是这里出的问题。

**Shell 脚本多了回车符**：Windows 的换行符是 `\r\n`，Linux 只有 `\n`。如果 shell 脚本在 Windows 上编辑后直接传到 Linux 执行，会多出一个不可见的 `\r`，导致脚本报错。

解决方式有两种：
- 在客户端传输时使用文本模式，自动转换换行符
- 在 Linux 上用 `dos2unix script.sh` 清理回车符

如果经常需要在 Windows 上编辑 shell 脚本再传到服务器，建议在代码编辑器（VS Code 等）中将默认换行符设为 LF，从源头解决问题。

## 六、一个快速诊断思路

当 SFTP 连接失败时，按以下顺序排查，大概率能定位问题：

1. 先用 `ping` 确认 IP 可达
2. 再用 `telnet IP 22` 确认端口可达
3. 端口不可达 → 检查安全组/防火墙 → 检查 sshd 是否运行
4. 端口可达但认证失败 → 确认用户名 → 确认密码 → 检查 `/var/log/secure` 或 `/var/log/auth.log` 中的失败原因
5. 认证通过但连接断开 → 检查加密算法协商 → 查看服务器端 sshd 日志
6. 能传文件但有乱码 → 检查编码设置 → 确认传输模式

大部分 SFTP 连接问题停在第 2 步到第 4 步之间。安全组没开 22 端口、Ubuntu 系统用了 root 用户登录、密码里特殊字符打错了——这三个问题占了日常连接故障的大头。

常用的 SFTP 客户端如 WinSCP（可从 winscp.ijinshan.com 获取）在连接日志中会打印详细的调试信息，遇到连接问题可以先看日志，比凭记忆排查效率更高。


本地用 Windows，服务器跑 Linux，文件怎么传？这是每个后端开发和运维绕不开的问题。用惯了图形界面的人不会每次都敲 scp 命令，自然会选择一个 SFTP 客户端——配置好会话信息，双击连接，左边是本地目录，右边是服务器，拖拽搞定。

从Windows向Linux服务器传文件：SFTP连接失败的五个排查方向

架构设计

SFTP连接失败？5大常见原因及解决方案：1.检查22端口是否开放（防火墙/安全组）；2.认证问题（密码错误/密钥配置/用户名不匹配）；3.DNS解析或网络策略限制；4.SSH版本不兼容导致加密算法协商失败；5.字符编码与传输模式设置错误。附详细排查步骤，快速解决文件传输问题。

入侵防御系统

云服务器

代码解释

文件传输

数据库

服务器

防火墙

Windows

Ubuntu

Linux

热销域名限时优惠，新客首年免费！


domain

DNS解析新购特惠59元起，续费优惠低至5.3折！

4核4G3M云服务器 新用户低至38元/年！

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从Windows向Linux服务器传文件：SFTP连接失败的五个排查方向-腾讯云开发者社区-腾讯云

从Windows向Linux服务器传文件：SFTP连接失败的五个排查方向

从Windows向Linux服务器传文件：SFTP连接失败的五个排查方向

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐