ulink 使用文档
一段 JS 代码，看清网站每一次访问 —— 访问量、独立访客、来源、地区属地、设备；还能生成短链追踪点击。自托管、无 Cookie、隐私友好。
<head>快速开始
三步上线统计：
- 登录 控制台 → 网站统计 → 新建站点，填站点名称（域名可选）。
- 创建后会得到一段 统计代码，复制它。
- 把代码粘贴到你网页的
</head>之前，保存上线即可。几秒后回控制台就能看到数据。
安装统计代码
每个站点的代码里 data-site 是该站点专属 ID（在站点详情页「统计代码」卡片可复制，下面示例中的 YOUR_SITE_ID 换成你的）。
就这一行。defer 保证它不阻塞页面加载；脚本异步上报，不影响网站性能与体验。
各平台接入示例
纯 HTML 网站
在每个页面（或公共头部）的 <head> 内加入：
WordPress
方式一：主题的 header.php 里 </head> 前粘贴那行代码。
方式二：用「Insert Headers and Footers」类插件，把代码贴进「头部」区域，免改主题。
Vue / React / 单页应用(SPA)
SPA 路由切换不刷新页面，ulink 已自动监听路由变化（pushState / popstate），切页会自动再上报一次，无需额外处理。直接把代码放进 public/index.html 的 <head>：
Next.js / Nuxt
Next.js(App Router) 用内置 next/script：
Typecho / Hexo / 静态博客
找到主题的公共头部模板（Typecho 的 header.php、Hexo 的 layout/_partial/head 等），把统计代码放进 <head> 即可。
指标说明
| 指标 | 含义 |
|---|---|
| 浏览量 PV | 页面被打开的总次数，每次访问 +1。 |
| 访客 UV | 独立访客数，按「当日指纹」去重，同一访客当天多次访问只算 1。 |
| 独立 IP | 去重后的独立 IP 数量，反映独立网络来源。 |
| 当前在线 | 近 5 分钟内有活动的独立访客数，实时刷新。 |
| 属地 | 由访客 IP 解析出的省份 / 城市 / 运营商。 |
| 来源渠道 | 访客从哪个网站跳转而来（来路域名）；直接输入网址为「直接访问」。 |
概况表展示「今日 / 昨日 / 本月 / 总计」四个时段的 PV·UV·IP；趋势图可同时看三条曲线，鼠标悬停查看任意时间点的精确数值。
实时与属地
站点详情页的「实时访客明细」表逐条展示最近 30 次访问：访问时间、IP 地址、属地（省市+运营商）、访问页面、来源、终端（浏览器/系统/设备）。控制台每 15 秒自动刷新，无需手动操作。
属地基于公网 IP 实时解析并缓存，内网 / 本机访问显示「局域网」。
短链统计
把长链接变短，分发到不同渠道，追踪每一次点击：
- 控制台 → 短链统计 → 新建短链，填目标网址（可自定义短码、备注名称）。
- 得到形如
{ORIGIN-INLINE}/l/spring的短链，发出去即可。 - 每次点击都会被记录，详情页可看点击量、独立人数、地区属地、来源、设备与实时点击明细。
数据上报 API(进阶)
绝大多数场景用 u.js 即可。如果你要在非浏览器环境或自定义场景手动上报一次浏览，可直接调用上报接口：
浏览器/系统/设备/IP 属地由请求头自动识别。接口返回一个 1×1 透明 gif，无需处理响应。前端用 navigator.sendBeacon 上报，不产生跨域问题、不阻塞页面。
自定义事件(转化统计)
装好统计代码后，全局会多出一个 ulink() 函数。在任意交互处调用它，即可统计注册、下单、点击广告等转化事件，详情页「自定义事件 · 转化」会显示每个事件的触发次数与触发人数。
注册 / signup），不超过 40 字。同一访客多次触发会分别计入「次数」，按指纹去重计入「人数」。隐私与工作原理
- 不写 Cookie、不做跨站跟踪。访客用「当日指纹」
sha256(日期+IP+UA+密钥)去重，隔天自动重置，无法跨天跨站关联个人。 - 上报内容仅含：页面路径、来源、语言、UA（用于识别浏览器/系统/设备）。
- IP 仅用于去重与属地解析，存储在你自己的服务器上。
- 数据完全自托管，不经过任何第三方分析平台。
常见问题
数据多久更新一次？
装了代码却没数据？
<head> 内且 data-site 正确；② 若网站是 HTTPS 而统计服务是 HTTP，会被浏览器拦截，需让两者协议一致；③ 浏览器拦截插件可能屏蔽上报，可换设备测试。UV 和独立 IP 有什么区别？
会拖慢我的网站吗？
defer 异步加载，用 sendBeacon 在后台静默上报，不阻塞页面渲染。