访问分析与近实时视图
访问分析是可选功能。不配置时,短链、登录和链接管理仍可用 — 图表、日志和近实时视图会是空的。
如何启用(三样都要)
需要同时具备:
Analytics Engine 绑定,名称必须是
ANALYTICS- Workers: 通常由部署配置生成(数据集默认
sink) - Pages: Settings → Bindings → Add → Analytics Engine
- 变量名:
ANALYTICS - 数据集:默认
sink。若设置了NUXT_DATASET,这里必须相同
- Workers: 通常由部署配置生成(数据集默认
账户 ID — 把
NUXT_CF_ACCOUNT_ID设为承载本应用的 Cloudflare 账户 ID
(仪表盘侧边栏账户名,或登录后 URL 里可见)API 令牌 — 把
NUXT_CF_API_TOKEN设为加密密钥:- Cloudflare 仪表盘 → 右上角头像 → My Profile → API Tokens → Create Token → Custom Token
- 权限仅需:Account → Account Analytics → Read
- 建议限制到同一账户
缺一或名称不一致,访问分析会一直为空。
能看到什么
成功的访问会进入计数器、图表、热力图、最近事件和位置。可按链接、时间、国家/地区、浏览器、系统、设备、来源筛选。
数字可能是近似值(Cloudflare 会对大流量采样)。低流量时也可能看起来不均匀。
要从统计和点击 Webhook 排除机器人,设置 NUXT_DISABLE_BOT_ACCESS_LOG=true。
近实时页面
不是真正的实时流
这个页面不用 WebSocket。大约每 10 秒刷新一次,并以大约每秒 1 个事件回放。暂停或标签页隐藏会停止回放。请当作“看起来像实时”的概览,而不是完整事件流。
导出
可在仪表盘或统计导出 API 下载筛选后的 CSV(短链码、URL、访客、访问量、来源等)。
链接 JSON 导出是另一项功能 — 见导入/导出。