返回文章列表

在 Nginx Proxy Manager (NPM) 中配置静态资源访问

分类
标签
SilentBlade
SilentBlade
2026-07-31 3 分钟阅读 25 阅读

本教程将指导你如何在 Nginx Proxy Manager (NPM) 中配置自定义 Nginx 指令,直接托管服务器本地的静态文件。这非常适合用来存放网站资源、图片、文档等无需后端处理的静态内容。

步骤一:创建或编辑代理主机

  1. 登录 Nginx Proxy Manager 管理面板。
  2. 进入 "Proxy Hosts" (代理主机) 页面。
  3. 点击 "Add Proxy Host" 创建新主机,或者直接编辑现有的主机。

步骤二:配置代理主机基本信息 (占位符)

因为我们要用自定义配置来直接托管静态文件,所以 NPM 面板必填的 "Forward Hostname / IP" 和 "Forward Port" 字段在这里其实用不上。我们只需要填写本地占位符即可:

  • Domain Names (域名): 填写你准备用来访问静态资源的域名 (例如 s.yourdomain.com)。
  • Scheme (协议): http
  • Forward Hostname / IP (转发主机名/IP): 127.0.0.1
  • Forward Port (转发端口): 80 (或任意未使用的本地端口,如 8080)
  • 根据需要,可以勾选 "Cache Assets" 和 "Block Common Exploits"。
  • 在 "SSL" 标签页配置好你的 SSL 证书 (推荐)。

步骤三:添加自定义 Nginx 配置

  1. 切换到 "Advanced" (高级) 标签页。

  2. 在 "Custom Nginx Configuration" 文本框中,粘贴以下配置:

    nginx
    location / {
        root /data/www;  # 替换为你的静态文件实际存放路径
        index index.html index.htm; # 定义默认索引文件,可根据需要添加
        try_files $uri $uri/ =404; # 尝试查找文件或目录,否则返回404
    }
    
    • root /data/www;必填。指定 Nginx 查找静态文件的根目录,请务必替换为你服务器上实际存放静态文件的路径。
    • index index.html index.htm;:当请求一个目录时(例如 https://s.zyunt.cn/),Nginx 会尝试在该目录下查找并返回 index.htmlindex.htm 文件。
    • try_files $uri $uri/ =404;:用于检查请求的文件或目录是否存在。如果 $uri(请求的文件)存在则直接返回;如果 $uri/(请求的目录)存在,则尝试返回目录下的默认索引文件;如果两者都不存在,则返回 404 错误。

步骤四:保存并放置静态文件

  1. 点击 "Save" 按钮保存配置。
  2. 在服务器上,将你的静态文件(例如 logo.png)上传到刚才在 root 指令中指定的目录(例如 /data/www/)。

步骤五:访问验证

现在,你就可以通过配置的域名和路径来访问静态资源了。

例如,如果域名是 https://s.zyunt.cn,且你已经在 /data/www/ 目录下放了 logo.png,直接访问 https://s.zyunt.cn/logo.png 即可。

重要提示

  • 确保你在 root 指令中指定的目录(如 /data/www)及其子文件对 Nginx 进程是可读的,否则访问时会报错。
  • 本教程中的 location / 会接管根路径下的所有请求。如果你的静态文件路径与现有的后端服务冲突,建议配置更具体的路径,例如使用 location /static/ { ... } 来进行分流。

评论 0

使用 GitHub 身份参与讨论

可以先写评论,登录后草稿会自动恢复。

访
暂无评论,来发表第一条评论吧。