Pure-FTPd Docker镜像文档

镜像概述

本镜像为基于Alpine Linux的轻量级Pure-FTPd FTP服务器实现，集成了对MySQL、PostgreSQL数据库及LDAP目录服务的认证支持，适用于需要灵活用户认证机制的FTP服务场景。Alpine基础确保镜像体积小、资源占用低，同时保持Pure-FTPd的稳定性和功能完整性。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低
• 多认证支持：
  • MySQL数据库认证
  • PostgreSQL数据库认证
  • LDAP目录服务认证
• 标准FTP功能：支持主动/被动模式、SSL/TLS加密、虚拟用户、带宽限制等Pure-FTPd核心功能
• 可配置性：通过环境变量和配置文件灵活调整服务参数

使用场景

• 企业内部文件共享服务，需通过LDAP统一用户认证
• 网站或应用的文件上传服务，需通过数据库管理FTP用户
• 需要轻量级FTP服务且对资源占用敏感的环境
• 开发/测试环境中的临时文件传输服务

使用方法

基本运行示例

bash
docker run -d \
  --name pure-ftpd \
  -p 21:21 \
  -p 30000-30009:30000-30009 \
  -v /path/to/ftp-data:/data \
  -e AUTH_METHOD=mysql \
  -e MYSQL_HOST=db-host \
  -e MYSQL_USER=ftpuser \
  -e MYSQL_PASSWORD=ftppass \
  -e MYSQL_DB=ftpdb \
  crazy-max/pure-ftpd

Docker Compose示例

yaml
version: '3'
services:
  pure-ftpd:
    image: crazy-max/pure-ftpd
    container_name: pure-ftpd
    ports:
      - "21:21"
      - "30000-30009:30000-30009"
    volumes:
      - ./ftp-data:/data
      - ./ssl:/etc/ssl/pure-ftpd
    environment:
      - AUTH_METHOD=ldap
      - LDAP_SERVER=ldap://ldap-host:389
      - LDAP_BASE_DN=ou=ftpusers,dc=example,dc=com
      - LDAP_BIND_DN=cn=admin,dc=example,dc=com
      - LDAP_BIND_PW=ldapadminpass
    restart: unless-stopped

环境变量说明

数据持久化

建议挂载以下目录以实现数据持久化：

• /data：FTP用户根目录，存储上传/下载的文件
• /etc/pure-ftpd：配置文件目录（如需自定义配置）
• /etc/ssl/pure-ftpd：SSL/TLS证书目录（启用加密时）

启用SSL/TLS

1. 将SSL证书文件（如pure-ftpd.pem）挂载至/etc/ssl/pure-ftpd/目录
2. 添加环境变量SSL=on启用加密

示例命令：

bash
docker run -d \
  --name pure-ftpd \
  -p 21:21 \
  -p 30000-30009:30000-30009 \
  -v /path/to/ftp-data:/data \
  -v /path/to/ssl:/etc/ssl/pure-ftpd \
  -e AUTH_METHOD=ldap \
  -e LDAP_SERVER=ldap://ldap.example.com \
  -e SSL=on \
  crazy-max/pure-ftpd

更多信息

完整配置说明及高级用法请参考项目GitHub仓库：[***]