本地上传文件到服务器：避开这些坑，效率翻倍

兄弟们，说到本地上传文件到服务器，是不是觉得简单的跟 1+1 似的？随便拉个 FTP 工具，拖拽上传就完事了？呵呵，等你在生产环境上栽过跟头，就知道这里面的水深着呢。今天老司机就带你盘一盘，本地上传文件到服务器这件事，到底有多少你没想到的坑。

本地上传文件到服务器的传统方式：FTP 的利与弊

FTP 的基本使用与隐藏风险

FTP（文件传输协议）算是老古董了，但架不住简单。FileZilla 一开，输个 IP、账号、密码，就能连上。但注意，传统 FTP 是明文传输的！你的密码、数据在网络上裸奔，抓包一抓一个准。强烈建议使用 SFTP（SSH File Transfer Protocol）或者 FTPS（FTP over SSL），至少加密传输。

断点续传与文件完整性检查

上传大文件，断个网，FTP 直接给你断掉，从头再来？实际上，FileZilla 支持断点续传，但前提是服务器端也支持。另外，很多小白传完文件不校验，导致文件损坏。上传完一定要比较哈希值（MD5、SHA1），确保文件完整。

本地上传文件到服务器的进阶姿势：命令行与 rsync

scp 命令：简单粗暴，适合小文件

如果你习惯用命令行，scp 是最简单的。

```bash

scp localfile.zip user@server:/path/to/remote/

```

但 scp 不支持断点续传，传大文件断了就悲剧了。

rsync：效率与安全的王者

rsync 是官方推荐的同步工具，支持增量传输（只传变化的部分）、断点续传、压缩、加密（通过 SSH）。

```bash

rsync -avz --progress localfile user@server:/path/to/remote/

```

这里 `-a` 是归档模式（保留权限、时间戳），`-v` 是 verbose，`-z` 是压缩。强烈建议用 rsync 代替 scp，尤其是大文件。

rsync 的常见坑与解决方案

• 路径末尾的斜杠：`rsync -avz source/ dest/` 和 `rsync -avz source dest/` 的行为不同，少了斜杠会把 source 目录本身复制过去，多了斜杠只复制内容。小心！

• 删除服务器端多余文件：默认 rsync 不删除目标端多余的文件，如果需要精确同步，加 `--delete` 参数，但慎用，可能会误删。

• 权限问题：同步后文件属主可能变成当前用户，如果需要保留原权限，加 `-o`（保留属主）和 `-g`（保留属组），但需要 root 权限。

本地上传文件到服务器的自动化：脚本与定时任务

编写自动化上传脚本

经常手动上传太 low，老司机教你写个脚本。

```bash

!/bin/bash

rsync -avz --progress /local/dir/ user@server:/remote/dir/ --password-file=/path/to/.rsyncpass

```

然后用 `crontab` 定时执行，实现自动同步。但注意，密码文件权限要设置为 600，否则安全漏洞。

使用 Git 部署：高效但需注意

如果你上传的是代码，用 Git hook 或 CI/CD 工具（如 GitHub Actions）自动化部署。但本地直接 push 到服务器时，需要在服务器上 init 一个裸仓库，然后通过 post-receive hook 检出代码。这中间涉及 SSH key 配置，不熟悉的话会绕很多弯路。

本地上传文件到服务器的避坑指南：老司机的经验之谈

文件名与编码问题

Windows 下的文件名可能是 GBK，服务器是 UTF-8，上传后文件名乱码。建议统一用 UTF-8，或者在上传脚本中转换编码。另外，不要用空格和特殊字符，尽量用下划线或中划线。

大文件上传超时与断点续传

用 rsync 配合 `--partial` 参数，保留部分传输的文件，下次继续传。另外，设置超时时间，`--timeout=60`，避免卡死。

安全加固：密钥登录与防火墙

上产环境，千万不要用密码登录 SSH，改用密钥。另外，限制服务器端口，只开放必要的端口（如 22、443），用 fail2ban 防护暴力破解。

本地上传文件到服务器的性能优化技巧

使用压缩传输节省带宽

`rsync -z` 启用压缩，对于文本文件（代码、配置）效果明显，但图片、视频等已压缩格式，压缩反而增加 CPU 开销，慎用。

并行传输加速

如果多个小文件，可以用 `tar` 打包再传，减少 SSH 连接次数。或者用 `xargs -P` 并行调用 rsync。但要注意服务器负载。

使用专门的上传工具

对于大量小文件，推荐使用 `lrzsz`（在终端中上传下载，但适合小文件）、`Rclone`（支持云存储）、`S3fs`（挂载 S3 为本地磁盘）。

结语

本地上传文件到服务器，最核心的是稳和快。老司机总结：能用 rsync 别用 ftp，能用脚本别手动，安全第一。希望这些避坑经验能让你少走弯路。

老司机 FAQ

1. 为什么我用 rsync 上传后，服务器上的文件权限变成了 600，导致 web 服务器无法读取？

答：这是因为你本地的 umask 设置默认创建文件为 600，并且 rsync 默认不会保留原权限（除非你用了 -a 或 -p）。解决方法：在 rsync 命令中加 `--chmod=Du=rwx,Dgo=rx,Fu=rw,Fgo=r` 来明确设置权限，或者使用 `-p` 参数保留权限，但注意源和目标的 umask 差异。

2. 本地上传大文件总是失败，提示“Connection timed out”，怎么办？

答：大概率是因为网络不稳定或服务器防火墙限制了连接时长。首先检查 SSH 连接是否正常，然后使用 rsync 加 `--partial` 和 `--timeout=60` 参数，支持断点续传。另外，考虑服务器端是否开启了 TCP keepalive，或你的本地网络是否有丢包。还可以考虑在服务器上使用 screen/tmux 会话，即使本地断开，任务继续执行。

3. 上传到服务器后，文件内容乱码，尤其是文本文件？

答：通常是编码问题。Windows 下的文本文件可能是 ANSI/GBK，而服务器默认 UTF-8。解决办法：在本地保存文件时统一使用 UTF-8 编码；如果是 Linux 服务器，可以用 iconv 命令转换编码。另外，检查你的 SSH 终端是否设置了正确的编码（如 UTF-8）。