fclairamb/ftpserver

fclairamb/ftpserver Docker镜像文档

镜像概述

fclairamb/ftpserver是一个基于Golang开发的轻量级FTP服务器镜像，实现了标准FTP协议(RFC 959)，旨在提供简单、高效且易于部署的文件传输解决方案。源代码托管于https://github.com/fclairamb/ftpserver%E3%80%82

核心功能与特性

• 轻量级设计：基于Golang编写，资源占用低，启动速度快
• 标准协议支持：完全兼容FTP标准协议，支持主动(PORT)和被动(PASV)模式
• 灵活配置：支持通过环境变量或配置文件自定义服务器参数
• 用户认证：支持基本用户名/密码认证机制
• 目录映射：可将容器内目录与宿主机目录灵活挂载
• 跨平台兼容：支持多架构Docker环境运行

适用场景

• 个人文件临时传输服务
• 小型团队内部文件共享
• 开发/测试环境文件交换
• 嵌入式系统或资源受限环境的文件服务
• 需要快速部署的临时文件传输节点

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name ftpserver \
  -p 21:21 \
  -p 20000-20010:20000-20010 \
  -v /path/to/local/files:/data \
  -e FTP_USER=ftpuser \
  -e FTP_PASS=ftppassword \
  fclairamb/ftpserver

参数说明：

• -p 21:21：映射FTP控制端口
• -p 20000-20010:20000-20010：映射被动模式数据端口范围（建议保留10-20个端口）
• -v /path/to/local/files:/data：挂载宿主机目录到容器内/data（作为FTP根目录）
• -e FTP_USER：设置FTP登录用户名
• -e FTP_PASS：设置FTP登录密码

高级配置（使用配置文件）

1. 创建本地配置文件（如ftpserver.json）：

json
{
  "listen_addr": ":21",
  "data_port_range": "20000-20010",
  "users": [
    {
      "username": "admin",
      "password": "securepass",
      "root_dir": "/data/admin",
      "permissions": "read,write"
    },
    {
      "username": "guest",
      "password": "guest",
      "root_dir": "/data/guest",
      "permissions": "read"
    }
  ]
}

2. 通过配置文件启动容器：

bash
docker run -d \
  --name ftpserver \
  -p 21:21 \
  -p 20000-20010:20000-20010 \
  -v /path/to/local/config:/config \
  -v /path/to/local/files:/data \
  fclairamb/ftpserver --config /config/ftpserver.json

注意事项

• 生产环境中建议：
  • 使用非root用户运行容器
  • 限制挂载目录的读写权限
  • 通过环境变量或配置文件设置强密码
  • 配合反向代理实现TLS加密传输
• 被动模式下需确保端口范围在防火墙中正确开放
• 高并发场景下可适当增加数据端口范围数量

常用环境变量