# apache-ftpserver

**Repository Path**: coderjn/apache-ftpserver

## Basic Information

- **Project Name**: apache-ftpserver
- **Description**: 继续维护 apache ftpserver
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: dev_1.2.0.x
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-09-05
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Apache FtpServer

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)

Apache FtpServer 是一个基于 Apache MINA 的高性能、可扩展的 Java FTP 服务器。

## 版本信息

当前版本: **1.2.0**

## 环境要求

- **JDK**: 17+
- **Maven**: 3.8+

## 主要特性

- 基于 MINA 的高性能 NIO 网络 framework
- 支持主动模式和被动模式数据传输
- 支持 SSL/TLS 安全连接 (FTPS)
- 支持虚拟用户和系统用户
- 支持数据库用户管理
- 支持 Spring 集成配置
- 可嵌入到应用程序中使用
- 支持 Ftplet 扩展机制

## 项目模块

| 模块 | 说明 |
|------|------|
| ftplet-api | Ftplet API 接口定义 |
| core | FTP 服务器核心实现 |
| examples | 示例代码 |
| distribution | 分发包构建 |

## 快速开始

### 构建项目

```bash
git clone https://github.com/apache/mina-ftpserver.git
cd mina-ftpserver
mvn clean install
```

### 嵌入式使用

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

### Spring 集成

```xml
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:ftp="http://mina.apache.org/ftpserver/spring/v1">

    <ftp:server id="ftpServer">
        <ftp:listeners>
            <ftp:nio-listener name="default" port="21"/>
        </ftp:listeners>
    </ftp:server>
</beans>
```

## 更新日志

详见 [RELEASE-NOTES.MD](RELASE-NOTES.MD)

## 许可证

本项目基于 [Apache License 2.0](LICENSE) 许可证发布。

## 相关链接

- [Apache MINA](https://mina.apache.org/)
- [Issue Tracker](https://issues.apache.org/jira/browse/FTPSERVER)
- [GitHub](https://github.com/apache/mina-ftpserver)