Apache FtpServer 1.2.1 介绍与选型指南

目标：基于官方发布渠道与官方文档（查询日期 2026-10-18），介绍 Apache FtpServer 1.2.1 的定位、核心概念、功能特性与同类 FTP 服务端选型建议。本文为认知篇，全部论断溯源至官方来源，不做本地安装实测。

一、信息基准

• 查询日期：2026-10-18（Asia/Shanghai）。
• 本次介绍的版本：Apache FtpServer 1.2.1。

1.1 版本依据

⚠️ 注意：原项目站点 ftpserver.apache.org 在 2026-10-18 当日无法访问（连接失败实查）；官方文档现由 MINA 项目站托管（https://mina.apache.org/ftpserver-project/）。评估采用本软件时应把「社区处于维护模式」作为重要决策输入。

1.2 官方来源清单

• 官方文档（MINA 站）：https://mina.apache.org/ftpserver-project/
• 官方发行目录：https://dlcdn.apache.org/mina/ftpserver/
• Maven Central：https://central.sonatype.com/search?q=g:org.apache.ftpserver
• GitHub 同步副本（陈旧，源码实际位于 Apache SVN mina/ftpserver）：https://github.com/apache/ftpserver
• MINA 项目站：https://mina.apache.org/

💡 说明：FtpServer 最初代码源自已停摆的 Apache Avalon 项目，经孵化后于 2007 年 12 月作为 MINA 子项目毕业（官方文档「History」章节原文）。

二、软件概述

Apache FtpServer 1.2.1 是一个 100% 纯 Java 的 FTP 服务器，官方定位为「完整、可移植的 FTP 服务器引擎方案，基于当前可用的开放协议」（官方 Overview 原文：The Apache FtpServer is a 100% pure Java FTP server. It's designed to be a complete and portable FTP server engine solution based on currently available open protocols）。

它可以三种形态运行：作为 Windows 服务或 Unix/Linux 守护进程独立运行、嵌入 Java 应用、以 Spring 集成方式运行；发行物同时以 OSGi bundle 提供。网络层基于 Apache MINA（高性能异步 IO 库），官方称可支撑大量并发用户。许可为 Apache License 2.0。

需要特别说明的是项目现状：FtpServer 已归入 Apache MINA 项目旗下作为子项目存在，官方文档 Overview 明确「graduated as a MINA subproject in December 2007」；董事会纪要显示其处于维护模式。最新版 1.2.1 发布于 2025 年 1 月，此后无新版本。它更适合「Java 技术栈内嵌 FTP 能力」的场景，而非面向公网的大型文件服务新建设。

三、核心概念

3.1 FtpServerFactory 与 FtpServer

编程入口非常薄：FtpServerFactory 汇集监听器、用户管理器等组件，createServer() 产出 FtpServer 实例，start() 启动（官方《Embedding FtpServer in 5 minutes》原文）。整体是「工厂 + 组装」的库式设计，没有复杂的顶层配置系统。

3.2 Listener：网络监听与端口

Listener 负责网络管理，默认创建名为 default 的监听器，可添加任意多个监听器（例如内网/外网各一个），并可配置端口、FTPS（FTP over SSL，支持显式与隐式模式）。来源：官方嵌入教程。

3.3 Ftplet API：FTP 事件扩展点

Ftplet 是官方提供的 Java API，用于编写处理 FTP 事件通知（连接、上传、下载等生命周期事件）的扩展代码，角色类似 Servlet 之于 HTTP 服务器；ftplet-api 是独立构件。来源：官方 Overview 与 Maven Central 构件列表。

3.4 UserManager 与用户体系

用户管理器负责账号体系，官方提供基于 properties 文件的 PropertiesUserManagerFactory（教程示例 myusers.properties），可自定义实现接入既有账号系统。

3.5 MINA 异步 IO 基础

默认网络层基于 Apache MINA 异步 IO 框架，这是其「大规模并发用户」能力的来源（官方 Overview 原文）；依赖上要求 classpath 含 mina-core 2.0-M3 或更高、slf4j-api 与一个 SLF4J 实现（官方嵌入教程依赖清单）。

四、功能特性

依据官方 Overview 与文档，主要特性如下：

• 纯 Java 实现：跨平台运行，可独立进程（系统服务/守护进程）或嵌入应用。
• 多种运行形态：standalone、嵌入式、Spring 集成、OSGi bundle。
• FTPS 支持：监听器级 SSL 配置（密钥库文件、口令、隐式/显式 SSL，见官方教程示例）。
• 多监听器：可同时暴露多个端口/网络面。
• Ftplet 扩展：Java API 编写 FTP 事件处理逻辑，实现上传钩子、访问控制等业务联动。
• 用户管理抽象：properties 文件用户库开箱即用，接口可扩展。
• 性能基座：基于 MINA 异步 IO，面向高并发连接设计。

五、快速上手

以下示例引自官方教程《Embedding FtpServer in 5 minutes》（https://mina.apache.org/ftpserver-project/embedding_ftpserver.html ，2026-10-18 实查），未做本地实测。

最小嵌入服务器（官方原文）：

FtpServerFactory serverFactory = new FtpServerFactory();
FtpServer server = serverFactory.createServer();
server.start();

自定义监听端口（官方原文）：

FtpServerFactory serverFactory = new FtpServerFactory();
ListenerFactory factory = new ListenerFactory();
factory.setPort(2221);                 // 设置监听器端口
serverFactory.addListener("default", factory.createListener());
FtpServer server = serverFactory.createServer();
server.start();

启用 FTPS 与 properties 用户库（官方原文，节选）：

ListenerFactory factory = new ListenerFactory();
factory.setPort(2221);
SslConfigurationFactory ssl = new SslConfigurationFactory();
ssl.setKeystoreFile(new File("src/test/resources/ftpserver.jks"));
ssl.setKeystorePassword("password");
factory.setSslConfiguration(ssl.createSslConfiguration());
factory.setImplicitSsl(true);
serverFactory.addListener("default", factory.createListener());
PropertiesUserManagerFactory userManagerFactory = new PropertiesUserManagerFactory();
userManagerFactory.setFile(new File("myusers.properties"));
serverFactory.setUserManager(userManagerFactory.createUserManager());
FtpServer server = serverFactory.createServer();
server.start();

官方要求 classpath 至少包含：mina-core（2.0-M3+）、slf4j-api、任一 SLF4J 实现、ftplet-api、ftpserver-core。Maven 坐标（Maven Central 实查，版本 1.2.1）：

<dependency>
  <groupId>org.apache.ftpserver</groupId>
  <artifactId>ftpserver-core</artifactId>
  <version>1.2.1</version>
</dependency>

六、适用场景与限制

6.1 适用场景

• Java 应用内嵌 FTP 能力：业务系统需要接收/分发文件而又不想引入独立 FTP 服务时，嵌入 1.2.1 是最贴合的用法。
• 基于 FTP 事件联动的定制服务：借助 Ftplet 在上传/下载事件上挂业务逻辑（入库、回调、校验）。
• JVM 内的测试/开发用 FTP 端点：集成测试中快速起一个本地 FTP 服务。

6.2 限制与注意

• 维护模式：官方董事会纪要明示低活跃，1.2.1 为 2025 年 1 月发布，安全响应节奏无法与活跃项目相比；上生产前务必自行评估 CVE 面与兜底方案。
• 协议面：定位是 FTP/FTPS 服务器引擎，不提供 SFTP（SFTP 属 SSH 协议族，应考虑 MINA SSHd 或 OpenSSH）。
• FTP 协议先天短板：明文控制信道（除非 FTPS）、防火墙/NAT 下的数据端口协商复杂；面向互联网的新建设议优先评估 HTTPS/SFTP 方案。
• 性能与规模：官方宣称基于 MINA 可扩展到大量并发用户，但缺少现代基准数据，大规模场景应自行压测。

七、同类选型对比

对比口径说明：版本与发布信息均于 2026-10-18 经官方渠道实查（Maven Central、各官网、发行目录）。

选型建议：Java 技术栈内嵌 FTP 能力选 FtpServer 1.2.1，同时正视其维护模式现状并做好安全兜底；Linux 系统级标准 FTP 服务选 vsftpd（默认安装、久经考验）；需要复杂虚拟主机/细粒度权限选 ProFTPD（1.3.9d 仍在正常维护）；仅 Python 进程内测试或轻量服务选 pyftpdlib；面向互联网的新建文件传输需求，优先考虑 HTTPS/SFTP 而非任何 FTP 系方案。

八、参考链接

• 官方文档（MINA 站）：https://mina.apache.org/ftpserver-project/
• 官方 Overview：https://mina.apache.org/ftpserver-project/index.html
• 嵌入教程：https://mina.apache.org/ftpserver-project/embedding_ftpserver.html
• 官方发行目录：https://dlcdn.apache.org/mina/ftpserver/
• Maven Central（ftpserver-core）：https://central.sonatype.com/artifact/org.apache.ftpserver/ftpserver-core
• GitHub 同步副本：https://github.com/apache/ftpserver
• MINA 项目站：https://mina.apache.org/
• ASF 董事会纪要（MINA 项目状态）：https://whimsy.apache.org/board/minutes/MINA.html