vimagick/pure-ftpd

pure-ftpd

!Pure-FTPd

Pure-FTPd 是一款免费（BSD许可）、安全、生产级且符合标准的FTP服务器。它不提供无用的花哨功能，而是专注于效率和易用性。它为常见需求提供简单解决方案，并为个人用户和托管服务提供商提供独特的实用功能。

镜像概述和主要用途

pure-ftpd镜像基于Pure-FTPd构建，提供了一个轻量、安全且高效的FTP服务器环境。适用于需要快速部署FTP服务的场景，支持用户管理、文件传输控制等核心功能，满足个人文件共享和企业级托管需求。

核心功能和特性

• 免费开源：采用BSD许可协议，可自由使用和修改
• 安全性：内置安全机制，保障文件传输过程的安全性
• 生产级质量：稳定可靠，适合生产环境部署
• 标准合规：符合FTP协议标准，兼容各类FTP客户端
• 高效易用：专注核心功能，配置简单，运行高效
• 灵活的用户管理：支持用户添加、删除、密码修改等操作
• 资源控制：可限制用户带宽、存储空间等资源使用

使用场景和适用范围

• 个人用户文件共享和备份
• 小型团队内部文件传输
• 网站托管服务提供商的FTP服务
• 需要简单、安全FTP服务的各类应用场景

使用方法和配置说明

docker-compose.yml 配置

yaml
pure-ftpd:
  image: vimagick/pure-ftpd
  net: host
  volumes:
    - ./data/ftpuser:/home/ftpuser  # FTP用户主目录挂载
    - ./data/pure-ftpd:/etc/pure-ftpd  # 配置文件挂载
  privileged: true  # 需要特权模式以确保权限正确
  restart: always  # 容器退出时自动重启

请根据PassivePortRange配置防火墙，确保被动模式下的端口可访问。

服务器端操作

启动服务

bash
$ cd ~/fig/pure-ftpd/  # 进入包含docker-compose.yml的目录
$ docker-compose up -d  # 后台启动服务

管理FTP用户

进入容器后使用pure-pw命令管理用户：

bash
$ docker-compose exec pure-ftpd bash  # 进入容器内部

# 添加用户（示例：用户名为kev，限制存储空间1024MB，带宽1024KB/s，账号有效期1天）
>>> pure-pw useradd kev -u ftpuser -d /home/ftpuser/kev -t 1024 -T 1024 -y 1 -m

# 列出所有用户
>>> pure-pw list

# 显示指定用户信息
>>> pure-pw show kev

# 修改用户密码
>>> pure-pw passwd kev -m

# 删除用户
>>> pure-pw userdel kev -m

# 查看当前FTP连接
>>> pure-ftpwho -n

>>> exit  # 退出容器

目录结构示例

.
├── docker-compose.yml       # 服务配置文件
└── data/
    ├── ftpuser/             # FTP用户数据目录
    │   └── kev/             # 用户kev的主目录
    │       └── file.txt     # 用户文件示例
    └── pure-ftpd/           # 服务器配置目录
        ├── pure-ftpd.conf   # 主配置文件
        ├── pureftpd.passwd  # 用户密码文件
        └── pureftpd.pdb     # 用户数据库文件

客户端操作

使用标准FTP客户端连接服务器：

bash
$ ftp remote-server  # 连接远程FTP服务器（将remote-server替换为实际服务器地址）
Name: kev  # 输入用户名
Password: ******  # 输入密码

# 客户端操作示例
ftp> !touch file.txt  # 在本地创建测试文件
ftp> !ls  # 查看本地文件
ftp> put file.txt  # 上传文件到服务器
ftp> !rm file.txt  # 删除本地文件
ftp> get file.txt  # 从服务器下载文件
ftp> del file.txt  # 删除服务器上的文件
ftp> ls  # 列出服务器当前目录文件
ftp> bye  # 退出FTP连接