delfer/alpine-ftp-server

docker-alpine-ftp-server

小巧灵活的Docker镜像，内置vsftpd服务器，支持FTP及FTPS（TLS加密）协议，适用于快速搭建轻量级文件传输服务。

使用方法

bash
docker run -d \
    -p 21:21 \
    -p 21000-21010:21000-21010 \
    -e USERS="one|1234" \
    -e ADDRESS=ftp.site.domain \
    docker.xuanyuan.run/delfer/alpine-ftp-server

配置说明

环境变量

• USERS - 空格和|分隔的用户列表（可选，默认值：alpineftp|alpineftp）
  格式：name1|password1|[folder1][|uid1] name2|password2|[folder2][|uid2]
  （folder为用户主目录，uid为用户ID，均为可选参数）
• ADDRESS - 客户端可连接被动端口的外部地址（可选，需解析为FTP服务器IP）
• MIN_PORT - 被动连接使用的最小端口（可选，默认21000）
• MAX_PORT - 被动连接使用的最大端口（可选，默认21010）
• TLS_CERT - TLS证书文件路径（启用FTPS时必填）
• TLS_KEY - TLS私钥文件路径（启用FTPS时必填）

USERS变量示例

• user|password foo|bar|/home/foo（创建用户user/foo，foo的主目录为/home/foo）
• user|password|/home/user/dir|10000（指定用户主目录为/home/user/dir，UID为***）
• user|password||10000（不指定主目录，仅指定UID为***）

FTPS（文件传输协议+SSL）配置示例

通过Let's Encrypt生成免费SSL证书，并与alpine-ftp-server配合使用以启用FTPS。

1. 获取SSL证书

bash
mkdir -p /etc/letsencrypt
docker run -it --rm \
    -p 80:80 \
    -v "/etc/letsencrypt:/etc/letsencrypt" \
    docker.xuanyuan.run/certbot/certbot certonly \
    --standalone \
    --preferred-challenges http \
    -n --agree-tos \
    --email i@delfer.ru \
    -d ftp.site.domain

2. 启动FTPS服务

bash
docker run -d \
    --name ftp \
    -p 21:21 \
    -p 21000-21010:21000-21010 \
    -e USERS="one|1234" \
    -e ADDRESS=ftp.site.domain \
    -e TLS_CERT="/etc/letsencrypt/live/ftp.site.domain/fullchain.pem" \
    -e TLS_KEY="/etc/letsencrypt/live/ftp.site.domain/privkey.pem" \
    docker.xuanyuan.run/delfer/alpine-ftp-server

注意事项

• 替换ftp.site.domain为指向服务器IP的实际域名
• 确保端口80可用（Let's Encrypt证书申请需通过HTTP验证）
• 证书有效期为3个月，需定期执行certbot renew命令续期

核心特性

• 轻量级：基于Alpine Linux，镜像体积小
• 灵活配置：支持自定义用户、主目录、UID及被动端口范围
• 安全传输：支持FTPS（TLS加密）协议
• 即开即用：无需复杂配置，通过环境变量快速部署