Nginx 文件服务器实战：FancyIndex 长文件名显示优化（Nginx 系列第 3 期）

location /releases/ {
    alias /data/releases/android/;
    autoindex on;
    autoindex_exact_size off;
    autoindex_localtime on;
    charset utf-8;

    # 注入 CSS 前
    sub_filter '</head>' '
    <style>
        /* 覆盖默认表格样式 */
        pre {
            white-space: pre-wrap;
            word-break: break-all;
        }
        /* 扩大文件名列宽 */
        table tr td:first-child {
            min-width: 600px;
            word-break: break-all;
        }
    </style>
    </head>';
    sub_filter_once on;
    sub_filter_types text/html;
}

cd nginx-1.30.3

./configure \
    --prefix=/usr/share/nginx \
    --sbin-path=/usr/sbin/nginx \
    --conf-path=/etc/nginx/nginx.conf \
    --error-log-path=/var/log/nginx/error.log \
    --http-log-path=/var/log/nginx/access.log \
    --pid-path=/run/nginx.pid \
    --lock-path=/run/nginx.lock \
    --http-client-body-temp-path=/var/lib/nginx/client_body \
    --http-proxy-temp-path=/var/lib/nginx/proxy \
    --http-fastcgi-temp-path=/var/lib/nginx/fastcgi \
    --user=www-data \
    --group=www-data \
    --with-http_ssl_module \
    --with-http_v2_module \
    --with-http_realip_module \
    --with-http_sub_module \
    --with-http_addition_module \
    --with-http_gzip_static_module \
    --with-http_stub_status_module \
    --with-stream \
    --with-stream_ssl_module \
    --add-module=../ngx-fancyindex-0.5.2

make -j$(nproc) && make install

cat > /etc/systemd/system/nginx.service << 'EOF'
[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target

[Service]
Type=forking
PIDFile=/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t -c /etc/nginx/nginx.conf
ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now nginx

server {
    listen 80;
    server_name filebox.example.com;

    location / {
        root /data/releases;
        fancyindex on;
        fancyindex_exact_size off;
        fancyindex_localtime on;
    }
}

server {
    listen 80;
    server_name filebox.example.com;

    # 文件下载基础路径
    root /data/releases;

    # --- 访问日志（JSON 格式，详见第 2 期）---
    access_log /var/log/nginx/filebox.access.log json;
    error_log  /var/log/nginx/filebox.error.log;

    # --- 文件下载优化 ---
    sendfile on;
    tcp_nopush on;
    aio threads;
    directio 512;
    output_buffers 2 1m;

    location / {
        # ===== FancyIndex 核心配置 =====
        fancyindex on;
        fancyindex_exact_size off;              # 显示 "1.2 GB" 而非原始字节
        fancyindex_localtime on;                # 显示本地时间（Asia/Shanghai）
        fancyindex_default_sort date_desc;      # 默认按修改时间倒序（最新在前）
        fancyindex_directories_first on;        # 目录排在文件前面
        fancyindex_show_dotfiles off;           # 不显示 .hidden 文件
        fancyindex_case_sensitive off;          # 文件名排序不区分大小写

        # ===== 隐藏不展示的文件（Nginx 内置的正则匹配）=====
        fancyindex_ignore "README.md";
        fancyindex_ignore "\.gitkeep";
        fancyindex_ignore "\.DS_Store";

        # ===== 自定义 CSS（长文件名完整显示）=====
        fancyindex_css_href /fancyindex/style.css;

        # ===== 自定义页头 =====
        fancyindex_header "/fancyindex/header.html";

        # ===== 自定义页脚 =====
        fancyindex_footer "/fancyindex/footer.html";
    }

    # ===== FancyIndex 静态资源 =====
    location /fancyindex/ {
        alias /etc/nginx/fancyindex/;
    }
}

/* /etc/nginx/fancyindex/style.css */

/* 让文件名列足够宽，不截断 */
table {
    width: 100%;
    table-layout: auto;
}

/* 文件名列 */
td:first-of-type, th:first-of-type {
    white-space: nowrap;
}

/* 长文件名处理 */
td:first-of-type a {
    word-break: break-all;
    overflow-wrap: break-word;
}

/* 整体字距 */
body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
    max-width: 1200px;
    margin: 0 auto;
    padding: 20px;
    color: #333;
    background: #f8f9fa;
}

/* 表格行悬停效果 */
tr:hover {
    background: #e9ecef;
}

/* 链接样式 */
a {
    color: #0366d6;
    text-decoration: none;
}

a:hover {
    text-decoration: underline;
}

<!-- /etc/nginx/fancyindex/header.html -->
<div style="background:#1a1a2e;color:#eee;padding:15px 20px;margin-bottom:20px;border-radius:6px;">
    <h1 style="margin:0;font-size:24px;">📦 Android 代码发包平台</h1>
    <p style="margin:5px 0 0;font-size:14px;color:#aaa;">
        最后更新：<span id="update-time"></span> &nbsp;|&nbsp;
        管理员：devops@example.com
    </p>
</div>
<script>
// 自动更新最后修改时间
document.getElementById('update-time').textContent = new Date().toLocaleString('zh-CN');
</script>

# 限制并发连接数（每个 IP 最多 2 个连接同时下载）
limit_conn_zone $binary_remote_addr zone=perip:10m;
limit_conn perip 2;

# 限制下载速率（每个连接最多 50 MB/s）
limit_rate 50m;

# 禁止外部站点盗用下载链接
valid_referers none blocked *.example.com;
if ($invalid_referer) {
    return 403;
}