Java使用Apache FtpServer实现嵌入式FTP服务器

Apache FtpServer是一个纯Java实现的FTP服务器,基于大名鼎鼎的网络框架apache MINA实现。它既可以作为一个完整的FTP服务器单独使用,也可以在Java程序中调用,类似于Jetty可以作为嵌入式的HTTP服务器。

下面介绍如何在Java中启动FTP服务器。

Apache FtpServer下载地址,目前最新版是1.0.6:

http://mina.apache.org/ftpserver-project/index.html

解压后在apache-ftpserver-1.0.6\common\lib文件夹中添加需要的jar包:

ftpserver-core-1.0.6.jar
log4j-1.2.14.jar
mina-core-2.0.4.jar
slf4j-api-1.5.2.jar
slf4j-log4j12-1.5.2.jar

另外,项目中还需要加入log4j的配置文件,当然没有话程序也可以跑,只是会出现一些警告信息而且没有日志记录。

1、最简单的FTP服务器

[java]
  1. public static void main(String[] args) throws FtpException {  
  2.       
  3.     FtpServerFactory serverFactory = new FtpServerFactory();  
  4.     FtpServer server = serverFactory.createServer();  
  5.     server.start();  
  6.       
  7. }  

这是最简单的FTP服务器。运行程序,启动FTP服务器后,在地址栏中输入ftp://localhost,可以看到以下界面,要求输入用户名密码。当然这个FTP是进不去的,因为它是最简单的FTP服务器,简单到没有用户。

2、设置匿名用户及对应的服务器文件夹

[java]

  1. public static void main(String[] args) throws FtpException {  
  2.       
  3.     FtpServerFactory serverFactory = new FtpServerFactory();  
  4.   
  5.     BaseUser user = new BaseUser();  
  6.     user.setName(“anonymous”);  
  7.     user.setHomeDirectory(“D:/test”);  
  8.       
  9.     serverFactory.getUserManager().save(user);  
  10.       
  11.     FtpServer server = serverFactory.createServer();  
  12.     server.start();  
  13.       
  14. }  

添加一个匿名用户anonymous,并设置它对应的文件夹是D:/test。再次进入ftp://localhost,可以看到D:/test中的文件。但是此时的FTP权限是只读的,也就是只能查看文件,但是不能增删改。

3、用户可写的权限设置

[java]

  1. public static void main(String[] args) throws FtpException {  
  2.       
  3.     FtpServerFactory serverFactory = new FtpServerFactory();  
  4.   
  5.     BaseUser user = new BaseUser();  
  6.     user.setName(“anonymous”);  
  7.     user.setHomeDirectory(“D:/test”);  
  8.       
  9.     List<Authority> authorities = new ArrayList<Authority>();  
  10.     authorities.add(new WritePermission());  
  11.     user.setAuthorities(authorities);  
  12.       
  13.     serverFactory.getUserManager().save(user);  
  14.       
  15.     FtpServer server = serverFactory.createServer();  
  16.     server.start();  
  17.       
  18. }  

加入可写的权限,此时就能对FTP服务器上的文件进行增删改了。

4、用户登录

[java]

  1. public static void main(String[] args) throws FtpException {  
  2.       
  3.     FtpServerFactory serverFactory = new FtpServerFactory();  
  4.   
  5.     BaseUser user = new BaseUser();  
  6.     user.setName(“test”);  
  7.     user.setPassword(“123456”);  
  8.     user.setHomeDirectory(“D:/test”);  
  9.       
  10.     serverFactory.getUserManager().save(user);  
  11.       
  12.     FtpServer server = serverFactory.createServer();  
  13.     server.start();  
  14.       
  15. }  

添加用户test,密码是123456,此时客户端要想进入ftp,必须输入正确的用户名密码。

5、配置文件设置用户

[java]

  1. public static void main(String[] args) throws FtpException {  
  2.       
  3.     FtpServerFactory serverFactory = new FtpServerFactory();  
  4.   
  5.     PropertiesUserManagerFactory userManagerFactory = new PropertiesUserManagerFactory();  
  6.     userManagerFactory.setFile(new File(“users.properties”));  
  7.       
  8.     serverFactory.setUserManager(userManagerFactory.createUserManager());  
  9.       
  10.     FtpServer server = serverFactory.createServer();  
  11.     server.start();  
  12.       
  13. }  

配置文件users.properties:

[plain]
  1. # Password is “admin”  
  2. ftpserver.user.admin.userpassword=21232F297A57A5A743894A0E4A801FC3  
  3. ftpserver.user.admin.homedirectory=D:/test  
  4. ftpserver.user.admin.enableflag=true  
  5. ftpserver.user.admin.writepermission=true  
  6. ftpserver.user.admin.maxloginnumber=0  
  7. ftpserver.user.admin.maxloginperip=0  
  8. ftpserver.user.admin.idletime=0  
  9. ftpserver.user.admin.uploadrate=0  
  10. ftpserver.user.admin.downloadrate=0  
  11.   
  12. ftpserver.user.anonymous.userpassword=  
  13. ftpserver.user.anonymous.homedirectory=D:/test  
  14. ftpserver.user.anonymous.enableflag=true  
  15. ftpserver.user.anonymous.writepermission=false  
  16. ftpserver.user.anonymous.maxloginnumber=20  
  17. ftpserver.user.anonymous.maxloginperip=2  
  18. ftpserver.user.anonymous.idletime=300  
  19. ftpserver.user.anonymous.uploadrate=4800  
  20. ftpserver.user.anonymous.downloadrate=4800  

这是通过配置文件users.properties设置用户。配置文件中包含两个用户:匿名用户anonymous和admin。anonymous只有只读权限,admin有可写权限。其中userpassword配置项是MD5加密的。其他配置项也很好理解。

标签