pockost/proftpd

docker-proftpd

镜像概述和主要用途

docker-proftpd是一个基于Alpine的ProFTPD容器，集成了MySQL、配额管理和SFTP模块。该镜像提供轻量级的FTP/SFTP服务解决方案，支持通过MySQL进行用户认证管理，并具备磁盘配额控制功能，适用于需要可靠文件传输服务的场景。

核心功能和特性

• 多协议支持：集成SFTP协议，同时支持传统FTP服务
• 用户管理：通过MySQL数据库进行用户认证和权限管理
• 配额控制：支持磁盘配额功能，可限制用户存储空间
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 端口范围配置：预设被动模式端口范围（60000-60100），便于网络配置

使用场景和适用范围

• 个人或小型团队的文件共享服务器
• 需要用户配额管理的FTP服务环境
• 开发/测试环境中的临时文件传输服务
• 需要MySQL集成进行用户管理的FTP/SFTP服务

使用方法和配置说明

无需编译方式

1. 创建docker-compose.yml文件

在项目根目录创建docker-compose.yml，可根据需要修改MySQL凭证：

yaml
proftpd:
  image: pockost/proftpd
  volumes:
    - ./proftpd.conf:/usr/local/etc/proftpd.conf
    - ./data/ftp:/data
    - ./data/ssh:/etc/ssh
  links:
    - mysql
  ports:
    - "20:20"
    - "21:21"
    - "22:22"
    - "60000-60100:60000-60100"
mysql:
  image: mariadb
  ports:
    - 3306:3306
  environment:
    - MYSQL_ROOT_PASSWORD=password
    - MYSQL_DATABASE=proftpd

2. 获取ProFTPD配置文件

下载示例配置文件：

bash
curl https://raw.githubusercontent.com/pockost/docker-proftpd/master/sftp/proftpd.conf > proftpd.conf

3. 启动数据库并初始化

启动MySQL容器：

bash
docker-compose up -d mysql

创建ProFTPD数据库表结构：

bash
curl -sL https://raw.githubusercontent.com/pockost/docker-proftpd/master/sftp/create_table.sql | mysql --protocol=tcp -hlocalhost -uroot -p

生成SSH密钥：

bash
ssh-keygen -f ./data/ssh/ssh_host_rsa_key -N '' -t rsa
ssh-keygen -f ./data/ssh/ssh_host_dsa_key -N '' -t dsa

4. 启动ProFTPD服务

bash
docker-compose up -d proftpd

5. 添加用户

用户添加示例可参考：https://github.com/pockost/docker-proftpd/blob/master/sftp/create_user.sql

编译方式

1. 进入sftp目录

bash
cd sftp

2. 构建并启动容器

bash
docker-compose build
docker-compose up -d

3. 初始化数据库表

bash
cat create_table.sql | mysql --protocol=tcp -hlocalhost -uroot -p

注意事项

• 在镜像的quota文件夹中可找到仅包含配额功能的版本
• 在mysql文件夹中可找到包含MySQL和配额功能的版本
• 首次使用前需确保正确配置ProFTPD配置文件和数据库表结构
• SSH密钥生成是SFTP功能正常运行的必要步骤