在日常开发中,通过 FileZilla 等 FTP 工具实现 Windows 主机与 Ubuntu 虚拟机的文件交互是高频需求。但很多会卡在两个核心问题上:要么连接阶段被服务器拒绝,要么连接成功后上传文件时提示“权限不足”。
本文结合实际操作场景,从“问题定位”到“分步解决”,完整记录 FileZilla 与 Ubuntu 虚拟机的 FTP 连接配置过程,帮你避开常见坑点,快速实现稳定的文件传输。
问题现象:
在开始调试前,先梳理常见的报错现象,方便大家对号入座:
- 连接失败:FileZilla 输入虚拟机 IP、账号密码后,直接弹出
ECONNREFUSED - 连接被服务器拒绝,无法进入登录流程; - 传输失败:连接成功后,向目标路径上传文件时,提示
550 Permission denied,文件传输中断; - 目标路径:本文以 Ubuntu 虚拟机中用户主目录
/home/用户名为例(实际操作需替换为自己的用户名目录)。
分步解决:从安装到配置的完整流程
第一步:检查并安装 vsftpd 服务
连接失败的最常见原因是 Ubuntu 虚拟机未安装 FTP 服务端程序。
1. 检查 vsftpd 状态
打开 Ubuntu 终端,执行以下命令查看 vsftpd 服务是否已安装并运行:
sudo systemctl status vsftpd
- 若输出
Unit vsftpd.service could not be found,说明服务未安装,需执行下一步安装操作; - 若输出
active (running),则跳过安装,直接进入配置环节。
2. 安装 vsftpd
执行以下命令更新软件源并安装 vsftpd:
sudo apt update
sudo apt install vsftpd -y
安装完成后,再次执行 sudo systemctl status vsftpd,确认服务状态为 active (running),表示服务已正常启动。
第二步:配置 vsftpd 核心参数
vsftpd 的默认配置文件(/etc/vsftpd.conf)权限限制较严格,需手动修改核心参数,才能支持文件上传和正常连接。
1. 备份默认配置文件
为避免配置错误无法恢复,先备份默认配置:
sudo cp /etc/vsftpd.conf /etc/vsftpd.conf.bak
2. 编辑 vsftpd 配置文件
使用 nano 或 vim 编辑配置文件(以 nano 为例,操作更简单):
sudo nano /etc/vsftpd.conf
3. 完整配置内容(直接替换或补充)
一直按住Ctrl + K,删掉原有内容
将以下配置内容写入文件,关键参数已标注说明:
# 基础监听配置:启用 IPv4 监听,禁用 IPv6(避免冲突)
listen=YES
listen_ipv6=NO
# 本地用户权限:允许本地用户登录,允许写入操作
local_enable=YES
write_enable=YES
# 设定 FTP 根目录:直接使用用户主目录(替换为自己的用户名,如 /home/你的用户名)
local_root=/home/***
# 锁定用户根目录:防止用户访问主目录以外的路径(提升安全性)
chroot_local_user=YES
# 关键!允许被锁定根目录的用户写入(解决 550 权限拒绝问题)
allow_writeable_chroot=YES
# 被动模式配置(解决连接后无法列出目录的问题)
pasv_enable=YES
pasv_min_port=1024 # 被动模式最小端口
pasv_max_port=1048 # 被动模式最大端口
pasv_address=192.168.1.107 # 替换为你的 Ubuntu 虚拟机局域网 IP
# 日志与欢迎信息配置
xferlog_enable=YES # 启用传输日志
log_file=/var/log/vsftpd.log # 日志存储路径
ftpd_banner=Welcome to Ubuntu FTP Service. # 连接欢迎信息
4. 保存并退出配置文件
按 Ctrl + O 保存文件,按 Enter 确认;
按 Ctrl + X 退出 nano 编辑器。
第三步:设置目录权限(确保用户有读写权)
即使配置文件正确,若用户对主目录没有所有权,仍会出现权限问题。执行以下命令,确保当前用户(如 ***)拥有主目录的完整权限:
# 递归设置目录所有者为 ***(替换为你的用户名)
sudo chown -R ***:*** /home/***
# 设置目录权限为 755(所有者可读可写可执行,其他用户只读)
sudo chmod 755 /home/***
⚠️ 注意:无需设置
777权限,755配合配置文件中的allow_writeable_chroot=YES即可满足上传需求。
第四步:重启 vsftpd 服务
修改配置文件后,必须重启服务才能让参数生效:
sudo systemctl restart vsftpd
重启后,可再次执行 sudo systemctl status vsftpd,确认服务无报错且正常运行。
第五步:FileZilla 客户端连接设置
打开 Windows 上的 FileZilla,按以下参数填写连接信息:
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 主机 | 192.168.1.107 | 你的 Ubuntu 虚拟机局域网 IP |
| 端口 | 21 | FTP 默认端口 |
| 协议 | FTP | 选择“文件传输协议(FTP)” |
| 登录类型 | 正常 | 使用本地用户账号密码登录 |
| 用户 | *** | 你的 Ubuntu 用户名 |
| 密码 | 你的 Ubuntu 用户登录密码 | 确保密码正确,区分大小写 |
填写完成后,点击“快速连接”,若连接成功,FileZilla 右侧会显示 Ubuntu 虚拟机 /home/*** 目录下的文件,左侧显示 Windows 本地文件,此时即可拖拽文件实现上传/下载。
📌 关键问题总结:报错原因与解决方案
| 常见问题 | 根本原因 | 解决方案 |
|---|---|---|
| 连接被拒绝(ECONNREFUSED) | vsftpd 服务未安装或未启动 | 安装 vsftpd(sudo apt install vsftpd)并重启服务 |
| 550 权限拒绝(Permission denied) | 未启用 allow_writeable_chroot,或目录权限不足 | 配置文件添加 allow_writeable_chroot=YES,并执行 chown 命令设置目录所有权 |
FileZilla 与 Ubuntu 虚拟机的 FTP 连接问题,核心在于 vsftpd 配置缺失 和 目录权限不当。只要按照本文步骤,正确安装服务、配置 allow_writeable_chroot 等关键参数,并确保目录权限合理,就能快速解决“连接失败”和“权限拒绝”问题。
如果在操作中遇到其他报错,建议先查看 /var/log/vsftpd.log 日志,根据具体错误信息定位问题——大部分问题都能通过调整配置文件或权限解决。
1120

被折叠的 条评论
为什么被折叠?



