You need to enable JavaScript to run this app. 如何限制Firebase Hosting静态内容仅对授权用户开放
优惠活动
大模型
产品
解决方案
定价
更多

如何限制Firebase Hosting静态内容仅对授权用户开放

解决方案:Firebase Hosting 静态JSDoc页面添加基础身份验证

你当前写法失效的核心原因为:Firebase 云函数部署时仅会打包functions目录下的代码与资源,项目根目录下public文件夹的内容不会同步到函数运行环境,因此express.static无法定位到目标静态资源。

操作步骤

  1. 调整JSDoc静态文件存放位置
    将你生成的所有JSDoc静态页面整体移动到functions目录下,推荐路径为functions/assets/jsdoc,避免打包时被忽略。

  2. 修改云函数的路径配置
    修改express.static的路径为绝对路径,用Node.js内置的__dirname定位当前函数运行目录,代码示例如下:

const path = require('path')
// 其他已有代码保持不变
doc_fun.use(
  '/jsdoc', 
  basicAuth({
    users: {'user': 'password'},
    challenge: true,
  }), 
  // 路径可根据你实际存放jsdoc的位置调整
  express.static(path.join(__dirname, 'assets/jsdoc'))
)
  1. 配置Firebase Hosting路由转发
    在项目根目录的firebase.json中添加rewrite规则,把所有/jsdoc开头的请求转发到你的鉴权云函数上:
{
  "hosting": {
    "public": "public",
    "rewrites": [
      {
        "source": "/rest/**",
        "function": "docs"
      },
      {
        "source": "/jsdoc/**",
        "function": "docs"
      }
      // 其他已有rewrite规则保留
    ]
  }
}
  1. 本地验证后部署
    运行firebase emulators:start本地测试:访问/jsdoc路径会弹出基础认证弹窗,输入账号密码后可正常加载JSDoc页面、样式、脚本资源,验证无误后执行firebase deploy部署即可。

注意事项

  • 不要将JSDoc文件同时放到根目录的public文件夹下,否则未鉴权的用户可以通过直接访问静态资源直链绕过验证
  • 如果子路径下的资源404,可以在express.static配置中添加{ fallthrough: false }强制返回静态资源找不到的错误,方便排查路径问题

内容的提问来源于stack exchange,提问作者cionzo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 10:24:02