corpusops/pureftpd

Pure-FTPd Docker镜像

概述

本Docker镜像提供了基于Pure-FTPd的便捷部署方案，旨在简化FTP服务器的搭建与管理过程。Pure-FTPd是一款轻量、安全且符合标准的FTP服务器软件，结合Docker容器化技术，可实现快速部署、环境隔离和灵活配置，适用于个人或企业的文件传输需求。

核心功能与特性

• 标准协议支持：兼容FTP协议，支持FTPS（FTP over SSL/TLS）加密传输，保障数据传输安全
• 用户隔离机制：采用虚拟用户模式，实现不同用户间文件系统隔离，增强服务安全性
• 轻量高效运行：基于Pure-FTPd的轻量级设计，资源占用低，运行稳定，满足高并发场景需求
• Docker化优势：容器化部署简化安装流程，支持跨平台运行，便于集成到现有Docker环境或CI/CD流程
• 灵活配置选项：通过环境变量或配置文件自定义服务器参数，如端口范围、传输速率限制、日志级别等
• 数据持久化：支持挂载宿主机目录，实现用户文件和配置数据的持久化存储，避免容器重启导致数据丢失

使用场景与适用范围

• 个人文件共享：快速搭建个人FTP服务器，用于跨设备、跨网络的文件传输与备份
• 企业内部协作：部门间或团队成员间安全传输工作文件，支持权限隔离与访问控制
• 网站运维部署：作为Web服务器的文件上传通道，用于网站内容更新与维护
• 开发测试环境：在软件开发或测试流程中提供临时FTP服务，支持快速环境搭建与销毁

使用方法与配置说明

快速启动

通过docker run命令直接启动Pure-FTPd容器：

bash
docker run -d \
  --name pureftpd \
  -p 21:21 \
  -p 30000-30009:30000-30009 \
  -v /path/to/local/ftpdata:/home/ftpusers \
  -e FTP_USER=ftpuser \
  -e FTP_PASSWORD=ftppassword \
  corpusops/pureftpd

Docker Compose配置

创建docker-compose.yml文件实现服务编排：

yaml
version: '3'
services:
  pureftpd:
    image: corpusops/pureftpd
    container_name: pureftpd
    ports:
      - "21:21"           # FTP控制端口
      - "30000-30009:30000-30009"  # 被动模式数据端口范围
    volumes:
      - ./ftpdata:/home/ftpusers    # 挂载用户文件存储目录
      - ./pureftpd-config:/etc/pure-ftpd  # 挂载自定义配置目录（可选）
    environment:
      - FTP_USER=ftpuser            # FTP登录用户名（必填）
      - FTP_PASSWORD=ftppassword    # FTP登录密码（必填）
      - PASV_RANGE=30000:30009      # 被动模式端口范围
      - LOG_LEVEL=info              # 日志级别（info/verbose/warn/error）
      - MAX_CLIENTS=50              # 最大并发客户端数
      - MAX_RATE=1024               # 最大传输速率（KB/s，0为无限制）
    restart: unless-stopped         # 容器退出后自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化配置

为确保数据不丢失，建议挂载以下目录：

• 用户文件存储目录：/home/ftpusers
  挂载宿主机目录（如/path/to/local/ftpdata），用于存储FTP用户上传的文件。

• 配置文件目录（可选）：/etc/pure-ftpd
  挂载自定义配置目录，用于覆盖默认配置（如pure-ftpd.conf主配置文件、SSL证书等）。

访问服务器

启动容器后，可通过FTP客户端工具（如FileZilla、WinSCP）连接服务器：

• 主机地址：运行容器的宿主机IP地址
• 端口：21（默认FTP控制端口）
• 用户名：通过FTP_USER环境变量设置的值
• 密码：通过FTP_PASSWORD环境变量设置的值

注意事项

• 被动模式端口开放：需确保宿主机防火墙开放PASV_RANGE指定的端口范围，否则客户端可能无法建立数据连接。
• SSL/TLS配置：如需启用FTPS，需将SSL证书文件（如pure-ftpd.pem）挂载至容器内证书目录（通常为/etc/ssl/private/），并在配置文件中启用TLS。
• 用户权限管理：默认配置下，虚拟用户仅拥有其主目录的访问权限，如需更精细的权限控制，可通过自定义配置文件实现。
• 日志查看：容器日志可通过docker logs pureftpd命令查看，用于排查连接或传输问题。