gists/pure-ftpd

Pure-FTPd Docker镜像文档

镜像概述

Pure-FTPd Docker镜像是基于Pure-FTPd构建的容器化解决方案，Pure-FTPd是一款免费（BSD许可）、安全、生产级质量且符合标准的FTP服务器。该镜像提供了便捷的部署方式，适用于需要快速搭建可靠FTP服务的场景。

核心功能与特性

• 免费开源：采用BSD许可协议，可免费用于商业和非商业环境
• 安全可靠：具备生产级稳定性，支持安全的用户认证机制
• 标准兼容：符合FTP协议标准，兼容各类FTP客户端
• 虚拟用户支持：支持虚拟用户管理，与系统用户隔离
• 灵活配置：通过环境变量和配置文件自定义服务参数
• 数据持久化：通过数据卷实现配置文件和用户数据的持久化存储
• PASV模式支持：可配置PASV端口范围，适应不同网络环境

数据卷说明

该镜像使用以下数据卷实现数据持久化：

环境变量配置

支持通过以下环境变量自定义服务行为：

使用方法

Docker run 命令部署

通过以下命令快速启动Pure-FTPd容器：

bash
docker run \
    -d \
    --name pure-ftpd \
    -p 21:21 \
    -p 30000-30009:30000-30009 \
    -v $(pwd)/pureftpd:/etc/pureftpd \
    -v /your/data:/home/ftpuser \
    gists/pure-ftpd

注意：自Docker 1.5版本起，支持端口范围导出。

参数说明：

• -d：后台运行容器
• --name pure-ftpd：指定容器名称为pure-ftpd
• -p 21:21：映射FTP控制端口
• -p 30000-30009:30000-30009：映射PASV模式端口范围
• -v $(pwd)/pureftpd:/etc/pureftpd：挂载本地目录到容器配置目录，持久化配置文件
• -v /your/data:/home/ftpuser：挂载本地数据目录到容器FTP用户数据目录

Docker Compose 配置

使用docker-compose.yml配置文件部署：

yaml
pure-ftpd:
  image: gists/pure-ftpd
  container_name: pure-ftpd
  ports:
    - "21:21"
    - "30000-30009:30000-30009"
  volumes:
    - /your/data:/home/ftpuser  # 本地数据目录挂载
    - ./pureftpd:/etc/pureftpd  # 本地配置目录挂载
  restart: always  # 容器退出时自动重启

用户权限设置

为确保FTP用户能正常访问数据目录，需设置/home/ftpuser目录的权限：

bash
docker exec -it pure-ftpd chown ftpuser:ftpgroup -R /home/ftpuser

FTP用户管理

创建虚拟用户

Pure-FTPd使用虚拟用户进行FTP登录，需通过pure-pw命令创建：

bash
# ftpuser为系统用户，test为创建的FTP虚拟用户
docker exec -it pure-ftpd pure-pw useradd test -m -u ftpuser -d /home/ftpuser/test

• -m：自动生成用户数据库文件
• -u ftpuser：关联虚拟用户到系统用户ftpuser
• -d /home/ftpuser/test：指定虚拟用户的主目录

刷新用户密码文件

创建虚拟用户后，需刷新密码文件才能使新用户生效：

bash
docker exec -it pure-ftpd pure-pw mkdb

核心命令参数说明

Pure-FTPd可通过以下核心参数配置服务（镜像默认已包含常用配置）：