详解nginxftp

发布时间：2023-05-23

nginxftp 是一种基于 Nginx 的 FTP 服务器，它是由俄罗斯工程师 Igor Sysoev 和他的团队开发的。nginxftp 不仅可以支持 FTP 协议的文件传输，而且还可以使用 HTTP 协议进行文件的上传和下载。它具有高性能、高并发、高稳定性的特点，是一种非常优秀的 FTP 服务器。

一、安装和配置

1、安装 nginxftp

sudo apt-get install nginx-full nginx-module-geoip
sudo apt-get install nginx-extras
sudo apt-get install nginx-common
sudo apt-get install build-essential nginx-module-njs nginx-module-perl nginx-module-xslt nginx-doc

2、编辑 nginx.conf 文件

user www-data;
worker_processes auto;
pid /run/nginx.pid;
events {
    worker_connections 768;
}
http {
    ## FTP config
    server {
        listen                    *:21;
        server_name               ftp.yourdomain.com;
        server_tokens off;
        log_not_found off;
        charset UTF-8;
        ## Login Settings
        ftp_config_account on;
        ftp_account_db /etc/nginx/ftpaccounts.db;
        ftp_account_rsa_key /etc/nginx/dsa.key;
        ## Passive Settings
           PASVMaxPort          65535;
           PASVMinPort          64000;
           PASVListenAddr       192.168.99.1;
           PASVIgnoreClientIP   on;
        ## Protocal
        ftp_protocol TLS;
        ftp_protocol_type I;
        ## Access Settings
        auth_nginx off;
        auth_http 127.0.0.1:8080/nginx-auth/;
        ## SSL Settings
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers on;
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 5m;
        ssl_certificate           /etc/nginx/ssl/nginx.crt;
        ssl_certificate_key       /etc/nginx/ssl/nginx.key;
        ## Logging Settings
        access_log   /var/log/nginx/access.log ftp_log;
        error_log    /var/log/nginx/error.log;
    }
}

二、HTTP 方式下载文件

通过 HTTP 协议进行文件的下载，是 nginxftp 的一种非常实用的功能，因为 FTP 协议的可用性非常低，而 HTTP 协议的可用性相对较高。下面是一个实现 HTTP 方式下载文件的例子。

location /download/ {
    root /var/www/example.com;
    internal;
    set $download_uri '';
    if ($arg_filename) {
        set $download_uri $arg_filename;
    }
    add_header Content-Disposition 'attachment; filename="$download_uri"';
}

三、FTP 方式上传文件

nginxftp 除了可以支持 HTTP 协议的文件下载外，还可以通过 FTP 协议来实现文件的上传功能。下面是一个实现 FTP 方式上传文件的例子。

listen       21;
server_name  localhost;
# Limit PASV ports to a single range (58008-58018)
# see set_pasv_ports 
# Check the logs for "out of address space" if more ports are required setsid
ftp_protocol TLS;
ftp_protocol_type I;
ftp_listen_port      2121;
ftp_account_jwt_timeout 120m;
set $ftp_home_path "/ftp/home/$remote_addr";
set $ftp_admin_path "/ftp/admin/$remote_addr";
set $ftp_audit_path "/ftp/audit/$remote_addr";
set $ftp_temp_path "/ftp/temp/$remote_addr";
set $ftp_backup_path "/ftp/backup";
## Login Settings
ftp_config_account on;
ftp_account_db /etc/nginx/ftpaccounts.db;

四、权限控制

nginxftp 可以对用户访问 FTP 服务器的权限进行细粒度的控制。下面是一个实现 FTP 用户权限控制的例子。

if (-r $document_root$fastcgi_script_name) {
    rewrite ^(.*)$ /$1 break; 
}
if ($request_method = 'POST') {
    return 405;
}
expires                  epoch;
metro_logger             off;
access_log               off;
sendfile                 on;
sendfile_max_chunk       1m;
tcp_nopush               on;
tcp_nodelay              on;
reset_timedout_connection on;
keepalive_timeout        120;
charset UTF-8;
include conf.d/*.conf;
server {
    listen                  21 ssl;
    server_name             $hostname;
    ftp_protocol            TLS;
    ssl_certificate         /etc/ssl/cert.pem;
    ssl_certificate_key     /etc/ssl/private.key;
    ssl_session_timeout     5m;
    ssl_protocols           TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers             HIGH:!aNULL:!MD5;
    root                    /data/ftp;
    ftp_config_account      on;
    ftp_account_db          /etc/nginx/ftp_accounts.db;
}

五、高可用性和性能优化

nginxftp 支持多种高可用性和性能优化技术。下面是一些实现高可用性和性能优化的方法。 1、使用负载均衡技术

upstream ftp_servers {
    server 10.10.10.1:21;
    server 10.10.10.2:21;
    server 10.10.10.3:21;
}
server {
    listen 21;
    server_name ftp.yourdomain.com;
    location / {
        proxy_pass ftp_servers;
    }
}

2、启用缓存

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=60m;
proxy_cache_key "$scheme$request_method$host$request_uri";
proxy_cache_valid 200 60m;
proxy_cache_valid 404 1m;

3、启用 SSL 协议

listen 443 ssl;
ssl_certificate /etc/nginx/ssl/yourdomain.crt;
ssl_certificate_key /etc/nginx/ssl/yourdomain.key;

4、启用压缩

gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
gzip_vary on;

5、限制访问 IP 列表

allow 192.168.1.2;
allow 192.168.1.0/24;
allow 10.0.0.0/8;
deny all;

六、总结

nginxftp 是一款非常优秀的 FTP 服务器，它具有高性能、高并发、高稳定性的特点，可以支持 FTP 协议和 HTTP 协议的文件传输和访问，在实际应用中非常实用。本文详细介绍了 nginxftp 的安装和配置、HTTP 方式下载文件、FTP 方式上传文件、权限控制、高可用性及性能优化等多个方面。相信在阅读本文后，对于 nginxftp 这个开源的软件有着更深刻的了解和认识。

推荐文章