@fastly/compute-js-static-publish

中文文档
8.0.2发布于 2026/11/16MITTypeScriptES Module构建来源已验证近 30 天下载 8140

快速计算 JavaScript 的静态发布器

中文使用文档
文档目录7 节
  1. 快速启动
  2. QQ 本地预览
  3. 部署到生产部门
  4. 特征
  5. 文档
  6. 安全问题
  7. 许可证

@ fastly/compute-js-static-publish (英语)

快速计算 + KV 为静态网站和网络应用存储.

这个CLI工具帮助您:

  • 部署静态站点以零后端快速计算
  • QQ 在快速 KV 存储中高效存储文件
    • QQ 在 v8 中新建: 支持 S3 兼容存储, 如快速对象存储 (Beta)
  • QQ 出版到命名的收藏(live, (中文(简体) ), preview-42页:1
  • 在运行时切换收藏
  • * 清理已过时或已过期的资产

快速启动

为您的工程创建目录, 将您的静态文件放入 ./public,然后键入:

npx @fastly/compute-js-static-publish@latest --root-dir=./public --kv-store-name=site-content

V8 中新建 : S3相容存储(如快取对象存储)也被支持(Beta). 要使用此模式, 类型 :

npx @fastly/compute-js-static-publish@latest --root-dir=./public --storage-mode=s3 --s3-region=<region> --s3-bucket=<bucket-name>

如果存储像快速对象存储那样需要自定义端点,则添加 --s3-endpoint=<endpoint> (例如, --s3-endpoint=https://us-east-1.object.fastlystorage.app) (中文(简体) ).

详情见 S3 兼容存储 页:1.

QQ 本地预览

cd compute-js
npm install
npm run dev:publish  # 'publish' your files to the simulated local KV Store
npm run dev:start    # preview locally

服务你的应用 http://127.0.0.1:7676。如果应用程序正在使用 KV Store,则您的内容会通过开发服务器管理的模拟 KV Store 服务.

如果应用程序使用 S3 兼容存储, 请使用 npm run s3:publish 替换 npm run dev:publish上传到桶中。 设定 S3_ACCESS_KEY_ID 财务报告和审定财务报表 S3_SECRET_ACCESS_KEY 运行前的环境变量 s3:publish 财务报告和审定财务报表 dev:start。 。 。 .

部署到生产部门

当你准备好去生活, 创建免费快速账户 如果你还没有,然后:

cd compute-js
npm run fastly:deploy        # deploy the app
npm run fastly:publish       # upload your static files

fastly:publish 需要快速的 API 令牌, 可以写入 KV Store 。 设定 FASTLY_API_TOKEN 环境变量,或添加 -- --fastly-api-token=<token>。命令不读取您的快速 CLI 配置文件的符号。 如果您在快速CLI中登录,您可以给它这个标志:

FASTLY_API_TOKEN=$(npx fastly auth token) npm run fastly:publish

将来,除非你有 进一步的修改 你的应用本身,你可以 向静态文件上传进一步更新 :

cd compute-js
npm run fastly:publish       # upload your static files

如果应用程序使用 S3 兼容存储, 您的文件在程序完成后已经在桶中 npm run s3:publish运行 npm run fastly:deploy 用于部署应用程序,并使用 npm run s3:publish 上传更新。 部署后, fastly.toml 有服务ID,所以 s3:publish 并清理服务缓存. 对于这次清洗,设置 FASTLY_API_TOKEN 我也一样。 没有它, s3:publish 在上传文件前有错误停止.

特征

  • 命名预览、中继、制作的收藏
  • SPA + 倒置处理
  • 预压缩的 Brotli/gzip 支持
  • 用于出版、宣传和清理的CLI工具

文档

📘 此软件包包含完整文档 文 件. md,此版本的CLI参考. 也可在GitHub上查阅:
https://github.com/fastly/compute-js-static-publish/tree/main 页面存档备份,存于互联网档案馆

安全问题

请看我们的 警卫 指导如何报告与安全有关的问题.

许可证

麻省理工学院。 。 。 .

版本与发布记录

@fastly/compute-js-static-publish 共发布 105 个版本,首次发布于 2022/07/14;过去 12 个月发布了 34 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.0.2latest2026/11/16今天
8.1.0-beta.6beta2026/11/16今天
8.1.0-beta.52026/11/142 天前
8.1.0-beta.42026/11/133 天前
8.1.0-beta.32026/11/115 天前
8.1.0-beta.22026/11/106 天前

其他发布通道:latest-v7 → 7.0.9,beta → 8.1.0-beta.6。

关于 @fastly/compute-js-static-publish 的常见问题

@fastly/compute-js-static-publish 是什么?

快速计算 JavaScript 的静态发布器

如何安装 @fastly/compute-js-static-publish?

在项目目录运行 npm install @fastly/compute-js-static-publish,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@fastly/js-compute(^3.33.2 || ^4.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 compute-js-static-publish,可以用 npx compute-js-static-publish 直接运行。

@fastly/compute-js-static-publish 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fastly/compute-js-static-publish 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fastly/compute-js-static-publish 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.11.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fastly/compute-js-static-publish 可以商用吗?

@fastly/compute-js-static-publish 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fastly/compute-js-static-publish 的下载量有多少?

根据 npm 官方下载统计,@fastly/compute-js-static-publish 在 2026/10/15 – 2026/11/13 这 30 天内被下载 8,140 次,日均约 271 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fastly/compute-js-static-publish 还在维护吗?

最新版本 8.0.2 发布于 2026/11/16(今天);至今共发布 105 个版本,其中过去 12 个月发布了 34 个;首次发布于 2022/07/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。