Nginx 本身不支持目录镜像或自动同步，需结合 rsync/curl 等外部工具实现伪镜像：先定时拉取远程资源到本地目录，再用 Nginx 静态服务对外提供访问，并通过 flock、校验和缓存头等保障一致性与性能。
nginx 本身不提供目录镜像或自动同步功能，它只是一个 HTTP 服务器和反向代理，不能主动拉取远程文件、监听变化或执行 rsync/curl 等同步操作。所谓“Nginx 目录镜像配置”，实际是通过组合外部工具 + Nginx 静态服务实现的伪镜像效果：先用其他工具（如 rsync、curl、wget 或专用同步脚本）把远程资源拉到本地目录，再用 Nginx 将该目录设为静态根路径对外提供访问。
核心思路：分离职责，各司其职
把“同步”和“服务”拆开做：
-
同步层：由 cron 定时任务、systemd timer 或 CI/CD 流水线触发 rsync / curl / rclone 等命令，将远程 HTTP/FTP/S3/另一台服务器上的资源下载到本地指定目录（如
/var/www/mirror）； - 服务层：Nginx 配置一个 server 块，root 指向该本地目录，并启用 autoindex（可选）、缓存头、防盗链等增强体验；
-
一致性保障：同步过程建议加锁（如
flock）、校验（如 --checksum）、增量更新（rsync -avz），避免中断导致脏数据。
典型 rsync 同步示例（从远程服务器拉取）
假设远程有 rsync 服务（如 rsync://mirror.example.com/pub/），在本地执行：
flock -n /tmp/mirror.lock -c 'rsync -avz --delete rsync://mirror.example.com/pub/ /var/www/mirror/'
加入 crontab 每小时同步一次：
0 * * * * /usr/bin/flock -n /tmp/mirror.lock -c '/usr/bin/rsync -avz --delete rsync://mirror.example.com/pub/ /var/www/mirror/ > /var/log/mirror-sync.log 2>&1'
Nginx 静态镜像服务配置
在 /etc/nginx/conf.d/mirror.conf 中添加：
server {
listen 80;
server_name mirror.local;
<pre class="brush:php;toolbar:false;">root /var/www/mirror;
index index.html;
# 开启目录浏览（可选）
autoindex on;
autoindex_exact_size off;
autoindex_format html;
# 强制缓存静态资源（提升性能，减少重复请求）
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf)$ {
expires 1h;
add_header Cache-Control "public, immutable";
}
# 禁止访问敏感文件
location ~ /\.(htaccess|htpasswd|git|svn) {
deny all;
}}
重载生效：nginx -t && systemctl reload nginx
替代方案：HTTP 反向代理 + 缓存（适合只读远程 HTTP 源）
如果远程资源仅通过 HTTP 提供（如官方仓库），可用 Nginx 的 proxy_cache 实现“被动镜像”：
- 不预先下载，而是首次请求时由 Nginx 自动回源获取并缓存；
- 需配置
proxy_cache_path、proxy_cache、proxy_cache_valid等指令； - 适合带宽充足、对首次延迟不敏感、且远程支持 Range 请求的场景；
- 注意：无法镜像目录列表（autoindex 不生效），也不支持 HEAD/404 缓存穿透控制，功能弱于主动同步。
