monteops/vsftpd

VSFTPD Docker镜像

镜像概述和主要用途

本镜像为VSFTPD的微服务镜像，基于Debian 11构建，支持SSL/FTPS。适用于需要轻量级FTP服务的场景，尤其适合对文件传输安全性有要求的环境。使用时需注意：需采用主机网络（--net host）或确保Docker容器与客户端之间存在直接路由网络，否则可能存在功能限制。

核心功能和特性

虚拟用户机制

• 采用虚拟用户登录，所有登录用户共享相同的系统UID和GID
• 默认UID/GID为48:48，可通过构建参数修改：--build-arg FTP_UID=1000 --build-arg FTP_GID=1000（示例将UID/GID设为1000:1000）

灵活的用户配置

• 支持单用户和多用户配置
• 支持密码明文或哈希方式设置
• 可配置用户独立根目录或共享根目录

安全特性

• 支持SSL/FTPS加密传输
• 可配置目录权限控制

使用场景和适用范围

• 个人或小型团队的文件共享服务
• 需要安全传输的文件分发场景
• 开发环境中的临时文件传输服务
• 需隔离用户访问目录的FTP服务

使用方法和配置说明

环境变量配置

部署示例

单用户基本使用

bash
docker run --rm -it -p 21:21 -p 4559-4564:4559-4564 -e FTP_USER=ftp -e FTP_PASSWORD=ftp docker.io/panubo/vsftpd:latest

多用户配置示例

bash
docker run --rm -it \
-p 21:21 -p 4559-4564:4559-4564 -e FTP_USERS_ROOT=yes \
-e FTP_USER_1=foo:$6$kbj...sDm1 \
-e FTP_USER_2=bar:$6$/doix...kkk1 \
-v /www/foo:/srv/foo -v /www/bar:/srv/bar \
docker.io/panubo/vsftpd:latest

SSL/FTPS配置示例

默认不启用SSL，配置SSL需挂载证书和密钥，并使用vsftpd_ssl.conf配置文件：

bash
docker run --rm -it \
-e FTP_USER=panubo -e FTP_PASSWORD_HASH='$6$XWpu...DwK1' \
-v `pwd`/server.pem:/etc/ssl/certs/vsftpd.crt:ro \
-v `pwd`/server.pem:/etc/ssl/private/vsftpd.key:ro \
docker.io/panubo/vsftpd vsftpd /etc/vsftpd_ssl.conf

日志配置

如需获取FTP日志，需将/var/log目录挂载到容器外部：

bash
docker run --rm -it -v /var/log/ftp:/var/log [其他参数] docker.io/panubo/vsftpd:latest

安全性说明

当前默认启用allow_writeable_chroot=YES，这在安全角度不推荐。禁用此选项的主要影响是local_root目录不能被FTP用户写入。有关此设置的安全风险详情，请参考serverfault: vsftp: why is allow_writable_chroot=YES a bad idea?。未来可能会将此配置设为可调整选项。