instantlinux/proftpd

proftpd

一个易用、轻量且功能齐全的ProFTPD安装。

镜像概述和主要用途

本镜像提供了ProFTPD的轻量级部署方案，支持FTP和SFTP协议，可通过环境变量快速配置核心功能，也支持挂载自定义配置文件进行高级定制。适用于Docker和Kubernetes环境中的文件传输服务，尤其适合需要快速部署***FTP服务或指定用户上传服务的场景。

核心功能和特性

• 支持FTP和SFTP协议，可通过环境变量切换
• 提供丰富的配置选项，覆盖用户管理、权限控制、连接限制等核心功能
• 轻量级设计，支持多平台架构（amd64、arm64、arm/v6、arm/v7）
• 支持持久化存储配置和密钥，确保服务稳定性
• 可集成Docker Swarm和Kubernetes进行容器编排

使用场景和适用范围

• 搭建***只读FTP服务，共享公共文件
• 配置指定用户的文件上传/下载服务
• 在容器化环境中提供标准化的文件传输服务
• 需要快速部署且配置简单的FTP/SFTP服务场景

使用方法和配置说明

基本配置

最常用的配置项可通过环境变量指定，其中PASV_ADDRESS为必填项。如需进一步自定义，可将配置文件挂载到/etc/proftpd.d和/etc/proftpd/modules.d目录。

若启用SFTP，需创建持久化卷并挂载到/etc/ssh，避免每次创建容器时重新生成SSH密钥。

创建上传用户密码密钥

可通过FTPUSER_xxx变量指定单个上传用户，需先创建加密密码密钥：

bash
python -c "import crypt,random,string; \
  print crypt.crypt('YOURPASSWORD', '\$6\

#### 部署示例

##### Docker Compose
提供了`docker-compose.yml`示例，适用于在Docker Swarm中共享网络附加卷作为只读***FTP服务的常见场景。

##### Kubernetes部署
可通过helm或kubernetes.yaml部署，克隆仓库后使用`make`命令：
```bash
git clone https://github.com/instantlinux/docker-tools.git
cd docker-tools/k8s
make proftpd

（需自定义https://github.com/instantlinux/docker-tools/blob/main/k8s/Makefile.vars%E9%85%8D%E7%BD%AE%EF%BC%89

环境变量

以下环境变量可在kubernetes.yaml或docker-compose.yml中指定：

密钥

贡献

如果您想对此镜像进行改进，请参阅https://github.com/instantlinux/docker-tools/blob/main/CONTRIBUTING.md%E3%80%82

+ ''.join(
[random.choice(string.ascii_letters + string.digits)
for _ in range(16)]))" |
docker secret create ftp-user-password-secret -

#### 部署示例

##### Docker Compose
提供了__CODE_TOKEN_7__示例，适用于在Docker Swarm中共享网络附加卷作为只读***FTP服务的常见场景。

##### Kubernetes部署
可通过helm或kubernetes.yaml部署，克隆仓库后使用__CODE_TOKEN_8__命令：
__CODE_TOKEN_1__
（需自定义https://github.com/instantlinux/docker-tools/blob/main/k8s/Makefile.vars配置）

### 环境变量
以下环境变量可在kubernetes.yaml或docker-compose.yml中指定：

| 变量                | 默认值                  | 描述                                   |
|---------------------|-------------------------|----------------------------------------|
| ALLOW_OVERWRITE     | on                      | 允许客户端修改文件                     |
| ANONYMOUS_DISABLE   | off                     | ***登录                               |
| ANON_UPLOAD_ENABLE  | DenyAll                 | ***上传                               |
| FTPUSER_NAME        | ftpuser                 | 上传用户名                             |
| FTPUSER_SECRETNAME  | ftp-user-password-secret| 加密密码密钥名称                       |
| FTPUSER_UID         | 1001                    | 上传文件的所有者UID                    |
| LOCAL_UMASK         | 022                     | 上传文件的权限掩码                     |
| MAX_CLIENTS         | 10                      | 最大同时登录数                         |
| MAX_INSTANCES       | 30                      | 进程限制                               |
| PASV_ADDRESS        |                         | 必填——Docker引擎的地址                 |
| PASV_MAX_PORT       | 30100                   | 客户端端口范围（修改需重建镜像）       |
| PASV_MIN_PORT       | 30091                   |                                        |
| SFTP_ENABLE         | off                     | 使用SFTP而非FTP                        |
| SFTP_PORT           | 2222                    | SFTP端口                               |
| TIMES_GMT           | off                     | 目录列表使用本地时间                   |
| TZ                  | UTC                     | 本地时区                               |
| WRITE_ENABLE        | AllowAll                | 允许上传/删除操作                      |

### 密钥
| 密钥                     | 描述                               |
|--------------------------|------------------------------------|
| ftp-user-password-secret | （可选）上传用户的加密密码         |

### 贡献
如果您想对此镜像进行改进，请参阅https://github.com/instantlinux/docker-tools/blob/main/CONTRIBUTING.md。

![]([***] "License badge") ![](https://github.com/proftpd/proftpd "Code repo")