undying/vsftpd

Vsftpd Docker容器

镜像概述

Vsftpd是一款安全、高效的开源FTP服务器软件，本Docker容器封装了Vsftpd，支持多种认证方式，可通过环境变量灵活配置，帮助用户快速部署稳定的FTP服务。

核心功能

• 支持htpasswd、BerkeleyDB、LDAP三种用户认证方式
• 通过环境变量直接配置vsftpd.conf和ldap.conf参数（前缀分别为VSFTPD_和LDAP_）
• 支持被动模式，可指定端口范围确保网络连通性
• 提供内置工具crypt用于生成htpasswd格式的密码文件

使用场景

• 企业内部员工间的文件共享与传输
• 个人或团队的文件备份与分发
• 需要多认证方式的安全文件服务场景

配置说明

构建容器

bash
docker build -t vsftpd .

运行容器示例（LDAP支持+开启guest模式）

bash
docker run -d \
  --env=LDAP_URI=ldaps://ldap.company.org \
  --env=VSFTPD_GUEST_ENABLE=YES \
  -p 10100:10100 \
  -p 10101:10101 \
  vsftpd

认证方式配置

1. htpasswd认证

• 将包含用户名:密码的htpasswd文件挂载到容器/etc/vsftpd/passwd路径
• 使用内置工具生成密码文件：

  bash
  crypt /etc/vsftpd/passwd <用户名> <密码>
  

2. BerkeleyDB认证

• 生成用户名\n密码格式的文本文件（如logins.txt）
• 转换为BerkeleyDB文件：

  bash
  db_load -T -t hash -f logins.txt /etc/vsftpd/users.db
  

• 将users.db挂载到容器/etc/vsftpd/users.db路径

3. LDAP认证

• 通过环境变量配置LDAP参数示例：

  bash
  docker run -d \
    --env=LDAP_URI=ldaps://ldap.corp.org \
    --env=LDAP_BINDDN=cn=ProxyUser,ou=ServiceAccounts,dc=corp,dc=org \
    --env=LDAP_BINDPW=123456 \
    --env=LDAP_BASE=dc=corp,dc=org \
    --env=LDAP_TLS_CACERTFILE=/etc/ldap/ssl/CA.crt \
    vsftpd
  

被动模式配置

• 在vsftpd.conf中设置：

  pasv_enable=Yes
  pasv_addr_resolve=NO
  pasv_address=<Docker主机IP>
  pasv_min_port=10100
  pasv_max_port=10101
  

• 运行容器时映射端口：-p 10100:10100 -p 10101:10101

故障排除

• 连接问题：确保被动模式端口已映射且主机IP配置正确
• BerkeleyDB认证530错误：检查users.db是否正确挂载到指定路径