Menu

Plausible 集成

Plausible 是一款轻量、注重隐私的开源站点统计工具（支持 SaaS 托管或自托管）。相较于 GA，它通常更简单、更“少打扰”，也更适合对隐私合规更敏感的产品。

NEXTY.DEV 已内置 Plausible 的脚本注入逻辑：只要你配置好环境变量，就会在生产环境自动加载。

提示

  • NEXTY.DEV 已开启开发环境禁用统计脚本以避免污染数据
  • 如需本地验证，请打开 app/[locale]/layout.tsx，删除 process.env.NODE_ENV === "development" 判断。
  • 如果不需要本地验证，只需完成生产环境变量填写，对应脚本即自动启用。

第一步：在 Plausible 创建站点

  1. 打开 Plausible：https://plausible.io/ 或你的开源部署地址
  2. 注册/登录后，点击 Add a website
  3. 填写你的站点域名（通常不带协议，例如 example.com）
  4. 创建完成后，你会看到安装脚本的说明

第二步：配置 NEXTY.DEV 环境变量

NEXTY.DEV 使用两个环境变量控制 Plausible：

  • NEXT_PUBLIC_PLAUSIBLE_SRC：Plausible 脚本地址（例如：https://your_plausible_address/js/script.file-downloads.outbound-links.pageview-props.revenue.tagged-events.js）
  • NEXT_PUBLIC_PLAUSIBLE_DOMAIN：你的站点域名（例如：nexty.dev）

例如使用 Plausible 官方托管：

.env
NEXT_PUBLIC_PLAUSIBLE_SRC=https://plausible.io/js/script.js
NEXT_PUBLIC_PLAUSIBLE_DOMAIN=example.com

使用 Plausible API

NEXTY.DEV 模板已支持通过 API 获取 Plausible 数据，功能方法在 actions/plausible/index.ts

打开你的 Plausible 后台，进入 API Keys 页面，创建 API Key，复制到环境变量：

.env
PLAUSIBLE_API_KEY=your_api_key
PLAUSIBLE_URL=your_plausible_address
NEXT_PUBLIC_PLAUSIBLE_DOMAIN=your_site_domain
创建并复制 api key