rreignier/pure-ftpd

Docker Pure-ftpd Server镜像说明

镜像概述

本镜像基于Pure-FTPd构建，提供Docker化的FTP服务解决方案，支持虚拟用户管理、被动模式配置、TLS加密等功能，便于快速部署和维护安全的文件传输服务。

核心功能

• 虚拟用户管理：支持创建虚拟用户，指定用户目录、UID/GID及权限。
• 被动模式支持：可配置被动端口范围，适配不同网络环境需求。
• TLS加密：支持TLS/SSL加密传输，保障数据传输安全。
• 日志记录：提供访问和传输日志，便于监控与审计。
• Docker卷支持：通过卷持久化用户数据和配置文件，确保数据不丢失。

使用场景

• 个人/团队文件共享与跨设备传输。
• 网站服务器文件上传与更新。
• 数据备份与同步。

配置说明

关键环境变量

• PUBLICHOST：被动模式使用的IP/主机名。
• FTP_USER_NAME：初始FTP用户名（可选）。
• FTP_USER_PASS：初始FTP密码（可选）。
• FTP_PASSIVE_PORTS：被动端口范围，默认30000-30009。
• ADDED_FLAGS：额外Pure-FTPd参数（如--tls=2启用强制TLS）。

部署示例

Docker Run命令

bash
docker run -d --name ftpd_server \
  -p 21:21 \
  -p 30000-30009:30000-30009 \
  -e "PUBLICHOST=your-domain.com" \
  -v ftp_data:/home/ftpusers \
  -v ftp_config:/etc/pure-ftpd/passwd \
  docker.xuanyuan.run/rreignier/pure-ftpd

Docker Compose示例

yaml
version: '3'
services:
  ftpd:
    image: docker.xuanyuan.run/rreignier/pure-ftpd
    ports:
      - "21:21"
      - "30000-30009:30000-30009"
    environment:
      - PUBLICHOST=localhost
      - FTP_USER_NAME=bob
      - FTP_USER_PASS=12345
      - FTP_USER_HOME=/home/bob
    volumes:
      - ftp_data:/home/ftpusers
      - ftp_config:/etc/pure-ftpd/passwd
volumes:
  ftp_data:
  ftp_config:

用户管理

创建虚拟用户：

bash
docker exec -it ftpd_server pure-pw useradd bob -f /etc/pure-ftpd/passwd/pureftpd.passwd -m -u ftpuser -d /home/ftpusers/bob

修改用户密码：

bash
docker exec -it ftpd_server pure-pw passwd bob -f /etc/pure-ftpd/passwd/pureftpd.passwd -m

TLS配置

1. 容器内生成自签名证书：

bash
mkdir -p /etc/ssl/private
openssl dhparam -out /etc/ssl/private/pure-ftpd-dhparams.pem 2048
openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout /etc/ssl/private/pure-ftpd.pem -out /etc/ssl/private/pure-ftpd.pem
chmod 600 /etc/ssl/private/*.pem

2. 通过卷挂载证书文件，镜像自动启用TLS。

bash
docker run -v ./ssl:/etc/ssl/private ... rreignier/pure-ftpd