blacklabelops/proftp

BlackLabelOps/ProFTP

该Docker镜像基于ProFTPd构建，包含Dockerfile及支持脚本，用于创建和管理ProFTPd容器，提供主动FTP服务及用户管理功能。

核心功能

• 设置用户及上传配额
• 添加只读技术用户
• 提供容器管理脚本（构建、运行、备份等）
• 支持Docker Compose部署

快速使用

bash
docker run -d -p 42042:21 --name="proftp_proftp_1" docker.xuanyuan.run/blacklabelops/proftp

FTP服务将在42042端口可用。

项目使用

该项目可通过命令行、bash脚本或Docker Compose工具使用，推荐使用脚本进行容器管理。

推荐运行方式

bash
$ ./scripts/run.sh

此命令将使用scripts/container.cfg配置运行容器。

Docker Compose运行

bash
$ docker-compose up -d

以detached模式运行容器，使用docker-compose.yml配置。

推荐构建方式

bash
$ ./scripts/build.sh

从scratch构建容器，包含所有必要参数。

Docker Compose构建

bash
docker-compose -f docker-compose-dev.yml build

根据docker-compose-dev.yml文件构建容器。

Docker命令行构建

bash
docker build -t="blacklabelops/proftp" .

从scratch构建容器。

容器内脚本

容器内包含用户管理相关脚本，可通过以下命令进入容器bash控制台：

bash
$ ./scripts/mng.sh

可用符号链接：

• addftpuser：添加FTP用户
• removeftpuser：删除FTP用户
• disableftpuser：禁用FTP用户
• enableftpuser：启用FTP用户
• chpassftpuser：修改用户密码
• quotaftpset：设置用户上传配额（单位：MB）
• addtechuser：添加具有有限权限的技术用户

用户管理

所有用户管理脚本需指定用户名（通过-u参数）。示例：

bash
$ chpassftpuser -u SomeUserName

quotaftpset还需指定配额值（通过-q参数）：

bash
$ quotaftpset -u UserWithQuota -q 100

运行任何自定义脚本可查看现有用户：

bash
$ removeftpuser
            Username                 Status            Quota limit             Quota used
_____________________________________________________________________________________________

             ftpuser                ENABLED

添加用户示例

bash
$ addftpuser -u newuser1
                Create new user newuser1
         RANDOM PASSWD: e1esAcfp
ftpasswd: using alternate file: /var/ftp/ftpd.passwd
ftpasswd: creating passwd entry for user newuser1

Password:
Re-type password:

ftpasswd: entry created


        Don't forget to set up quota to that user! Use command like this
        quotaftpset -u newuser1 -q QUOTA

设置配额示例

bash
$ quotaftpset -u newuser2 -q12
$ quotaftpset
            Username                 Status            Quota limit             Quota used
_____________________________________________________________________________________________

             ftpuser                ENABLED
            newuser1                ENABLED
            newuser2                ENABLED                  12.00

禁用/启用用户示例

bash
$ disableftpuser -u newuser2
User newuser2  disabled
$ enableftpuser -u newuser2
User newuser2 enabled

添加技术用户示例

bash
Usage: /usr/bin/addtechuser -u Username -t TechUsername

$ addtechuser -u ftpuser -t tech

Docker包装脚本

容器和镜像管理的便捷包装脚本，默认管理一个容器。若需管理多个容器，复制脚本并调整scripts/container.cfg。

直接在项目文件夹中执行命令即可。

功能脚本

容器的功能脚本，默认管理一个容器。若需管理多个容器，复制脚本并调整scripts/container.cfg。

logs.sh使用

bash
$ ./scripts/logs.sh

日志文件以时间戳命名，后缀为.log，位于项目的logs文件夹中。

backup.sh使用

bash
$ ./scripts/backup.sh

备份文件将保存到项目的backups文件夹中。

restore.sh使用

bash
$ ./scripts/restore.sh ./backups/ProFTPBackup-2015-03-08-16-28-40.tar

创建临时容器，将备份文件解压到Docker卷，之后停止并重启容器。

管理多个容器

通过复制项目文件夹并调整scripts/container.cfg配置，可支持同一主机上的多个容器管理。配置项说明：

注意：CONTAINER_VOLUME不可修改。

Docker Compose使用

该项目支持Docker Compose，配置文件为docker-compose.yml。示例：

bash
$ docker-compose up -d

启动detached模式的Docker容器。

更多细节请参考https://docs.docker.com/compose/%E3%80%82

支持

可在Hipchat留言提问：blacklabelops/hipchat

参考链接

• https://www.docker.com/
• https://docs.docker.com/compose/
• https://docs.docker.com/userguide/
• ProFTP官网