用FTP命令向服务器上传文件,核心就一步:登录FTP后执行put命令,将本地文件传输到服务器当前目录,完整流程为连接服务器、验证身份、切换目录、执行上传、确认结果。 这套命令行操作不依赖图形界面,在服务器运维、网站改版、静态资源部署等场景中依然高频使用,但很多人卡在命令记不全、被动模式连不上、中文文件名乱码这些细节上,本文按照实际工作流,把FTP命令上传文件的完整链路拆开讲透,同时覆盖Windows、Linux、macOS三种常见系统环境。
上传前必须先确认的四个基本信息
命令行上传和拖拽上传最大的区别在于:你没有二次确认的弹窗,所有操作必须在前三步就敲对。 连接服务器时,系统会提示你输入账号和密码,但在此之前,你需要手动准备好四样东西,缺一个都连不上。
- 服务器地址:IP地址(如
168.1.10)或域名(如ftp.example.com),均不带协议头,不要输入ftp:// - 端口号:FTP默认端口是
21,除非服务器管理员改过,否则不用刻意指定 - 账号与密码:注意FTP账号常和系统账号分离,很多主机商提供的是单独的FTP子账号,权限限定在一个目录内
- 目标路径:上传到哪个目录,例如网站根目录
/www/wwwroot/example.com或Windows服务器的C:\inetpub\wwwroot
业内专家指出,超过半数的上传失败发生在登录阶段,原因并非密码错误,而是FTP默认端口被防火墙拦截或服务器禁用了被动模式,首次连接前,建议先用telnet或nc测试一下服务器21端口是否通,命令如下:
telnet ftp.example.com 21
如果长时间卡住或提示无法连接,请先检查服务器安全组、防火墙规则,再检查FTP服务端是否已启动,这一步可以帮你避免后续所有因网络层导致的怪异报错。
FTP命令上传文件的具体操作步骤
Windows系统:原生FTP客户端的使用方法
Windows自带的FTP客户端功能比较基础,但它无需安装,适合临时使用,打开命令提示符(Win+R,输入cmd),按顺序执行以下命令:
ftp open ftp.example.com
此时系统会提示输入用户名和密码,输入密码时屏幕不会有任何显示(连星号都没有),这是正常的,直接回车即可,登录成功后,你会看到ftp>提示符,然后执行:
cd /www/wwwroot/example.com binary put D:\local\index.html
按顺序解释:cd切换远程目录;binary确保以二进制模式传输,防止图片、压缩包损坏;put后跟本地文件路径和文件名,将文件上传至当前远程目录。上传结束后,用ls查看文件是否已在远程目录中,再执行bye退出。
如果一次要上传多个文件,推荐用mput配合prompt:
prompt off mput D:\local\.html
prompt off会取消每个文件上传前的确认询问,实现批量静默上传。
Linux/macOS系统:命令更丰富,注意权限控制
Linux和macOS自带的FTP命令基于BSD实现,核心命令与Windows一致,但额外支持reget(断点续传下载)、mdelete(批量删除)等操作,以在Ubuntu服务器上部署网站为例,结合bash脚本可以实现一条命令完成整个静态资源目录的上传:
ftp -n <<EOF open ftp.example.com user your_username your_password binary prompt off cd /var/www/html mput /home/user/dist/ bye EOF
这段脚本中,-n参数禁止FTP客户端自动登录,后续的user命令手动指定账号密码,适合在脚本中免交互执行,但需要明确提示:在bash脚本中明文写入密码存在安全隐患,如果服务器非个人使用,建议使用.netrc文件控制权限,或在命令前用expect工具动态输入密码。
上传大文件时必须掌握的三个命令
hash:每传输一段数据就显示一个号,让你直观看到传输是否卡住,运行hash后再执行put,屏幕会滚出连续的号,一旦长时间不再输出,说明连接可能已断开binary:传输图片、压缩包、视频时强制执行,文本模式传输二进制文件会导致文件损坏,这是更为隐蔽的失败,文件上传成功但实际无法解压或打开quote:直接向FTP服务器发送原始命令,用于处理一些客户端没有暴露的指令,例如quote site chmod 755 index.html可以远程修改文件权限
上传失败:常见问题排查方向与解法
FTP命令上传文件失败时,先不要怀疑命令敲错了,按连接阶段、认证阶段、传输阶段分层排查。 这是运维排查的常用思路,也能帮你避免在错误的方向上浪费时间。
连接阶段:连接超时、被拒、找不到主机
- 现象:
ftp: connect: Connection timed out或Connection refused - 原因:服务器防火墙拦截21端口,FTP服务未启动,IP地址输错
- 验证:先
ping服务器看网络是否通,再telnet 服务器IP 21看端口是否通 - 处理:登录云控制台检查安全组入方向是否放行21端口;如果用的是被动模式,还需要放行FTP服务配置的被动端口范围(常见为30000-40000)
认证阶段:登录成功但切换不了目录
- 现象:
550 Failed to change directory或CWD command failed - 原因:账号对该目录没有读写权限,或目标目录不存在
- 验证:先
pwd显示当前所在目录,再ls查看目录下有哪些内容 - 处理:如果对
/www/wwwroot目录没有写权限,尝试切换到/tmp上传,验证账号本身是否有写权限,再联系服务器管理员确认目录权限
传输阶段:上传到一半卡住、文件为0字节
- 现象:
Connection closed by remote server或上传完成后文件大小为0KB - 原因:网络链路不稳定,FTP服务端超时时间过短,强制开启了防火墙对FTP的深度包检测
- 处理:执行
hash查看传输是否还在进行;如果长时间无数据流动,执行bye后重新登录;如果问题反复出现,重点检查服务端是否启用了vsftpd的pasv_min_port和pasv_max_port参数,没有配置这两项的话,被动模式下的数据连接会被防火墙拦截
Windows下中文乱码与外置FTP工具的对比
Windows自带的FTP命令存在一个比较影响体验的短板对中文文件名支持不佳,如果你的本地文件名或远程目录名包含中文,用put上传后可能出现文件名乱码,或ls看到的文件名显示为问号,目前比较常见的处理方式有两种。
- 改用开源FTP客户端,推荐方案是安装WinSCP或FileZilla,它们的图形界面支持UTF-8编码,可以直接拖拽上传
- 继续用命令行但规避中文在本地把文件名改成拼音或英文再上传,上传完成后在服务器端用
mv命令重命名
从其实用性角度看,图形化FTP工具适合中小型网站文件管理,而命令行的优势在于可脚本化、批量操作和服务端环境兼容性,行业共识认为,在大多数情况下,同时掌握两种方式才能应对不同的工作环境毕竟生产服务器不总是有图形界面。
FTP命令的备选思路:SFTP与SCP的场景差异
如果你觉得FTP命令不够安全所有数据包括密码都是明文传输那么需要对比一下两条常见链路:SFTP(SSH File Transfer Protocol)和SCP。
| 对比项 | FTP命令 | SFTP命令 | SCP命令 |
|---|---|---|---|
| 默认端口 | 21 | 22 | 22 |
| 数据加密 | 否,明文 | 是,SSH加密 | 是,SSH加密 |
| 断点续传 | 部分支持(reget,但只支持下载) | 支持(reget/put -a) |
不支持,需完整重传 |
| 批量上传 | 支持(mput) | 支持(mput) | 支持但语法不同 |
| 适用场景 | 传统主机服务商提供的Web空间 | VPS、云主机管理 | 快速传输少量文件 |
以实际使用场景为例,FTP命令更适合连接老牌虚拟主机商的Web空间(很多低成本海外主机商只开放FTP端口),而SFTP命令是管理自己云服务器时的默认选择,如果你在纠结用什么命令上传,记住一条判断规则:你的服务器能开SSH吗?能开的话直接用scp或sftp,不能开了再考虑FTP。
一个简单的SFTP上传示例:
sftp user@server_ip put /local/path/file.txt /remote/path/
在SFTP交互界面中,put的用法和FTP几乎一致,而上传进度和网络状态比原生FTP命令更稳定,如果你需要反复上传大量文件到云服务器,sftp + lcd(切换本地目录)+ mput三个命令配合,比图形界面更高效。
最后的建议:现学现用,第一次上传花10分钟测试,比看10篇文章都有用。 打开命令行,连上你的服务器,用put传一个小的测试文件,再用ls确认文件存在,然后删除,这10分钟的实操就能帮你掌握FTP命令上传文件的核心链路,熟练之后,再配合脚本自动化,让上传变成一条命令的事。
关于FTP命令上传文件的常见问题
怎么用ftp命令上传文件夹目录?
FTP命令本身不支持直接上传整个目录,需要进入本地目录后逐个上传或批量上传,方法是在FTP命令行中先执行lcd切换到本地目标目录,然后执行mkdir remote_folder在服务器上创建对应目录,再用mput 上传全部文件,或者使用ftp -n配合脚本循环遍历子目录,但更推荐的做法是在客户端工具中使用目录拖拽上传命令行方式处理嵌套子目录比较繁琐。
为什么ftp命令上传的文件在服务器上打不开?
大概率是传输模式没有切换为二进制,FTP默认可能是ASCII文本模式,这种模式会把文件中的换行符按系统平台做转换,但图片、压缩包、可执行文件是二进制数据,任何字节被修改都会导致文件损坏,上传前执行binary命令,再重新传输文件,就能避免这个问题。
ftp命令’put’后传上去的文件为什么是0字节?
上传成功但文件为0字节,多半发生在磁盘空间不足或服务器目录写入配额超限的情况下,但不建议通过查看根目录空间来排查,建议用quote site quota或df -h查看FTP账号所在分区是否满;同时检查服务器端FTP配置文件中的user_config_dir中是否设置了对该用户的write_enable=NO,权限问题之外,还有一种常见情况是本地文件还没有完全写入磁盘就执行了上传确认本地文件保存完成后再重新传输。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/806663.html


![[java漫谈系列152]ftp常用命令](https://i0.hdslb.com/bfs/archive/9a6f1ae1e28f50037586dc82a1ef637d63986a4d.png)