zloystrelok/vsftpd

VSFTPD Docker镜像

镜像概述

这是一个VSFTPD的微服务镜像，用于快速部署FTP服务器。需注意：若使用容器网络，需确保客户端与容器间有直接路由；推荐使用--net host主机网络模式以避免网络限制。

核心功能

• 虚拟用户管理：所有登录用户使用统一系统UID/GID（默认48:48，可通过构建参数FTP_UID/FTP_GID修改）。
• 多用户支持：通过FTP_USER_*环境变量添加多个用户，支持哈希密码（推荐使用mkpasswd -m sha-512生成）。
• 目录隔离：设置FTP_USERS_ROOT=yes后，每个用户将被chroot到独立目录/srv/$USER。
• SSL加密：可挂载证书和密钥启用SSL传输，提升数据安全性。
• 日志持久化：支持将日志目录/var/log挂载到容器外，方便日志查看与分析。

使用场景

• 个人/团队内部文件共享与传输。
• 网站服务器的文件上传（如CMS内容更新、静态资源部署）。
• 需要加密传输的敏感文件交换场景。

配置说明

支持以下环境变量配置：

• FTP_USER：设置默认FTP用户。
• FTP_PASSWORD：明文密码（不推荐）。
• FTP_PASSWORD_HASH：用户的哈希密码（推荐使用sha-512格式）。
• FTP_USER_*：添加多用户，格式为用户名:哈希密码（不可与FTP_USER/FTP_PASSWORD同时使用）。
• FTP_USERS_ROOT：启用时，每个用户chroot到独立目录/srv/$USER。
• FTP_CHOWN_ROOT：启用时，将/srv目录的所有者设为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加密示例

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

安全注意事项

当前allow_writeable_chroot默认开启（不推荐作为安全最佳实践），未来可能支持配置。关闭该选项后，local_root目录不可被FTP用户写入，需注意目录权限设置。详情可参考ServerFault相关问题。