mrdxdy/ftp-server

FTP服务器镜像

镜像概述

本镜像基于vsftpd构建，提供轻量、易用的FTP服务器功能，支持标准FTP协议的主动与被动传输模式，可快速部署用于文件的上传、下载及存储管理场景。

核心功能

• 支持FTP主动（20-21端口）与被动（40000-40009端口）传输模式
• 可通过环境变量自定义FTP用户账号与密码
• 支持数据卷挂载实现文件持久化存储
• 轻量级镜像，启动速度快，资源占用低

使用场景

• 个人或小型团队的文件共享与跨设备传输
• 开发环境中临时文件交换与测试数据存储
• 轻量级内部文件服务搭建

配置说明

环境变量

• FTP_USER: FTP登录用户名（必填）
• FTP_PASS: FTP登录密码（必填）
• PUBLICHOST: 服务器公网地址（被动模式需配置，确保客户端能连接）

端口映射

• 主动模式：需映射20-21/tcp端口
• 被动模式：需映射40000-40009/tcp端口（可选，根据实际需求开启）

数据卷挂载

将主机目录挂载到容器内用户主目录（如/data:/home/user），实现文件持久化存储

部署示例

通过docker run部署

sh
docker run \
    --detach \
    --env FTP_PASS=123 \
    --env FTP_USER=user \
    --env PUBLICHOST=your-public-ip \
    --name my-ftp-server \
    --publish 20-21:20-21/tcp \
    --publish 40000-40009:40000-40009/tcp \
    --volume /data:/home/user \
    mrdxdy/ftp-server

通过docker compose部署

yml
services:
  ftp-server:
    container_name: my-ftp-server
    environment:
      - FTP_PASS=123
      - FTP_USER=user
      - PUBLICHOST=your-public-ip
    image: mrdxdy/ftp-server
    ports:
      - '20-21:20-21/tcp'
      - '40000-40009:40000-40009/tcp' # 被动模式需开启
    volumes:
      - '/data:/home/user'

许可证

本镜像基于https://raw.githubusercontent.com/garethflowers/docker-ftp-server/master/LICENSE%E5%8F%91%E5%B8%83%E3%80%82 ===END===