monteops/proftpd

docker-proftpd 镜像文档

概述

docker-proftpd是一个基于ProFTPD的Docker镜像，用于快速部署FTP（文件传输协议）服务器。通过简单的环境变量配置和目录挂载，即可快速搭建功能完善的FTP服务，适用于个人、小型团队或开发环境中需要文件传输的场景。

核心功能与特性

• 简单配置：通过环境变量直接设置FTP用户名和密码，无需手动修改配置文件
• 目录挂载：支持将本地目录挂载为FTP用户的主目录，实现文件持久化存储
• 网络灵活性：支持使用主机网络模式（--net host），简化端口配置
• 轻量级：基于ProFTPD构建，镜像体积小，部署快速

使用场景

• 个人或小型团队需要临时或长期的文件传输服务
• 开发环境中需要快速搭建FTP服务器进行文件共享
• 测试环境中模拟FTP服务进行应用测试

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动一个FTP服务器实例：

bash
docker run -d --net host \
  -e FTP_USERNAME=test -e FTP_PASSWORD=test \
  -v /path/to/your/ftpdir:/home/$FTP_USERNAME \
  monteops/proftpd

参数说明：

• -d：后台运行容器
• --net host：使用主机网络模式，容器直接使用主机的网络栈
• -e FTP_USERNAME=test：设置FTP用户名（必填）
• -e FTP_PASSWORD=test：设置FTP用户密码（必填）
• -v /path/to/your/ftpdir:/home/$FTP_USERNAME：挂载本地目录作为FTP用户的主目录，$FTP_USERNAME会自动替换为环境变量中设置的用户名

环境变量配置

docker-compose 示例

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  proftpd:
    image: monteops/proftpd
    network_mode: host
    environment:
      - FTP_USERNAME=myftpuser
      - FTP_PASSWORD=myftppassword
    volumes:
      - /local/path/to/ftpdata:/home/myftpuser
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 使用--net host模式时，容器会直接使用主机的网络端口（默认FTP端口21），确保主机该端口未被占用
• 挂载的本地目录需要有适当的读写权限，避免容器内权限问题导致文件无法访问
• 生产环境中建议使用更复杂的密码，并考虑添加SSL/TLS加密配置（需额外配置ProFTPD参数）