nginx搭建内网软件仓库的核心是正确配置root指定静态文件根路径、index定义默认响应页，并启用autoindex on实现目录浏览；配合alias、content-disposition头、内网访问限制等可提升实用性。
用 Nginx 搭建内网软件仓库，核心就是让 Nginx 正确暴露文件目录，并支持索引浏览和直接下载。关键不在复杂配置，而在 root 定义静态文件根路径，index 指定默认响应页（如 index.html 或自动生成的目录列表），再配合少量增强配置即可实用。
明确 root 与 index 的分工
root 指令决定请求 URI 的“文件系统起点”；index 指令决定当访问一个目录（如 /repo/）时，Nginx 尝试查找并返回哪个文件。两者配合，才能让 http://intranet/repo/ 自动展示仓库内容。
- 若
root /var/www/repo;，则请求/repo/debian/pool/main/a/apt/实际映射到/var/www/repo/debian/pool/main/a/apt/ - 若
index index.html;，且该目录下存在index.html，就返回它；否则默认 403（禁止列目录） - 要启用自动目录列表，需额外开启
autoindex on;，此时index指令会被忽略（因为不找文件，而是生成列表）
基础仓库配置示例
假设你把所有软件包（.deb、.rpm、tar.gz 等）放在 /data/repo/ 下，结构类似：
/data/repo/ ├── debian/ ├── centos/ ├── tools/ └── index.html ← 可选，用于美化首页
对应 Nginx server 块配置如下：
server {
listen 80;
server_name repo.internal;
<pre class="brush:php;toolbar:false;">location / {
root /data;
index index.html;
autoindex on; # 启用目录浏览
autoindex_format html; # 输出 HTML 格式（默认）
autoindex_exact_size off; # 显示易读文件大小（如 1.2M）
autoindex_localtime on; # 使用本地时间而非 GMT
}}
这样访问 http://repo.internal/repo/ 就能看到完整目录树，点击即可下载任意文件。
提升实用性的小技巧
纯 autoindex 虽简单，但对团队使用不够友好。可加几项优化：
- 用
alias替代root实现更灵活的 URL 映射（例如把/repo/指向/data/repo/，而不用暴露/data上层） - 添加
add_header Content-Disposition "attachment";强制浏览器下载（适合二进制包，避免被 inline 渲染） - 限制只允许内网访问：
allow 192.168.0.0/16;+deny all; - 为大文件启用范围请求支持（默认已开），确保断点续传和分片下载正常
验证与调试要点
配置完成后别急着 reload，先检查三件事：
- 确认 Nginx 进程有权限读取
/data/repo/目录及其中文件（常用chown -R www-data:www-data /data/repo） - 用
nginx -t测试语法，避免 reload 失败导致服务中断 - 访问目录时若看到 403，优先检查
autoindex on;是否在对应location块内，且该 location 没被其他规则覆盖
不复杂但容易忽略：Nginx 不会自动创建 index.html，也不强制要求它存在——是否启用目录列表，取决于你是否开了 autoindex，而不是有没有 index 文件。
