解决 FileZilla 连接 Ubuntu 虚拟机失败与文件传输权限被拒问题

该文章已生成可运行项目,

在日常开发中,通过 FileZilla 等 FTP 工具实现 Windows 主机与 Ubuntu 虚拟机的文件交互是高频需求。但很多会卡在两个核心问题上:要么连接阶段被服务器拒绝,要么连接成功后上传文件时提示“权限不足”。

本文结合实际操作场景,从“问题定位”到“分步解决”,完整记录 FileZilla 与 Ubuntu 虚拟机的 FTP 连接配置过程,帮你避开常见坑点,快速实现稳定的文件传输。

问题现象:

在开始调试前,先梳理常见的报错现象,方便大家对号入座:

  1. 连接失败:FileZilla 输入虚拟机 IP、账号密码后,直接弹出 ECONNREFUSED - 连接被服务器拒绝,无法进入登录流程;
  2. 传输失败:连接成功后,向目标路径上传文件时,提示 550 Permission denied,文件传输中断;
  3. 目标路径:本文以 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 配置文件

使用 nanovim 编辑配置文件(以 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
端口21FTP 默认端口
协议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 日志,根据具体错误信息定位问题——大部分问题都能通过调整配置文件或权限解决。

本文章已经生成可运行项目
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值