访问统计与浏览量
校对日期:2026-11-16。适用于社区版及全部商业版。专题的浏览量需要商业版标准版及以上。
系统里有两套互不相干的数字。访问统计 是控制台 统计 菜单下的报表:全站的浏览量、访客数、来源、地域、设备; 浏览量 是记在每篇文章、每个栏目和站点上的计数,用来显示在页面上、给文章排“热门”。 两者都靠页面里的一段脚本向服务器上报,因为静态页和被缓存的页面不经过程序。默认主题两段脚本都有; 自己做的主题没有加,报表和浏览量就一直是空的。
一、查看访问统计
进入 统计 → 流量分析 或 统计 → 访客分析,选一张报表,再在上方选统计时段(今日 到 全部,默认 最近30日)。

| 菜单 | 报表 | 内容 |
|---|---|---|
| 流量分析 | 访问趋势 | 浏览量(PV)、访客数(UV)、IP数三条折线。时段短按小时画,长则按天、按月 |
| 受访页面 | 每个页面地址的浏览量、访客数、IP数 | |
| 入口页面 | 访客每次访问打开的第一个页面 | |
| 访问来源 | 访客从哪个网站来。直接输入地址或从收藏夹打开的记为 DIRECT,站内跳转记为 INNER | |
| 访客分析 | 新老访客 | 新访客、老访客各自的浏览量、访客数、跳出率、平均访问时长、平均访问页数 |
| 地域分布 | 按 IP 归属地统计的国家分布、省份分布(省份只统计中国的访问) | |
| 访客环境 | 设备、操作系统、浏览器 |

- 报表只统计当前站点。多站点时在右上角切换站点后分别查看。
- 控制台首页的 流量 卡片是同一份数据:今日 PV、今日 UV、最近 30 天的折线和访问来源。
- 在 用户 → 角色管理 的权限树里,七张报表各是 统计 下的一项权限,可以分别授予。
报表里的几个指标:
| 指标 | 含义 |
|---|---|
| 浏览量(PV) | 页面被打开的次数,刷新一次也算一次 |
| 访客数(UV) | 访客的个数。访客按浏览器区分:同一个浏览器多次访问算一个,换浏览器或清除了浏览器数据算新的 |
| IP数 | 不同 IP 地址的个数 |
| 新访客 | 这个浏览器第一次访问本站,这一次访问期间都算新访客 |
| 跳出率 | 只看了一个页面就离开的访问所占的比例 |
| 平均访问时长 | 一次访问里页面处于可见状态的时间,取平均。离开超过 2 小时再回来,算一次新的访问 |
二、统计数据怎样产生
访客打开页面时,页面里的脚本 visit.js 向服务器上报一次访问(页面地址、来源地址、访客标识等); 访客离开或切到别的标签页时再上报一次,用来计算访问时长。服务器记下访问,每分钟汇总一次,报表读的是汇总结果。
- 延迟:访问先记在内存里,每分钟写入数据库一次,随后汇总。刚发生的访问一般要等一两分钟才出现在报表里。
- 页面地址不含参数:
?后面的部分会被去掉,/search?q=新闻与/search?q=体育记为同一个页面。地址最长记 255 个字符。 - 搜索引擎的蜘蛛不计入:服务器按请求的 User-Agent 识别,识别为爬虫的访问不记录。带自动化标记的浏览器 (自动化测试工具打开的页面)脚本不上报。
- 来源里的“搜索引擎” 只认百度、必应、搜狗、360、Google 的域名,其余站外来源都算外部链接。
- IP 与地域:地域按 IP 用内置的地址库查出。程序前面有 Nginx、CDN 时要设置
ujcms.,否则记到的都是代理服务器的 IP, 见 Nginx 反向代理的“让程序拿到访客的真实 IP”一节。内网地址的国家显示为ip-proxy-depth LAN。内置地址库只有 IPv4,IPv6 访客的地域显示为UNKNOWN; 需要时用application.里的yaml ujcms.指定 IPv6 地址库文件。ip2region-v6-path - 保留时间:系统自动清理旧数据,不需要手工维护。
| 数据 | 保留 |
|---|---|
| 逐条的访问记录 | 3 天 |
| 访问趋势:按分钟 / 按小时 / 按天 / 按月 | 2 天 / 31 天 / 2 年 / 一直保留 |
| 受访页面、入口页面、访问来源、新老访客、地域、访客环境 | 3 年 |
三、在主题里接入访问统计
visit.js 由系统提供,所有主题共用,地址是 ${ctx}/,不需要复制到主题里。在每个页面都会包含的片段里加一行 (默认主题写在 snippets/):
[#escape x as (x)!?html]
<script src="${ctx}/static/visit.js?v=${v}" data-api="${api}" data-site-id="${site.id?c}" defer nonce="${csp_nonce!''}"></script>
[/#escape]| 属性 | 说明 |
|---|---|
data-api | 接口前缀,写 ${api} |
data-site-id | 站点 ID,写 ${site.id?c}。缺少时脚本不做任何事 |
data-consent | 是否先征求访客同意,见下。不写等于 off |
脚本自己取 CSRF 令牌、自己保存访客标识(浏览器的本地存储,不用 Cookie),静态页、被缓存的页面里同样有效,不需要再写别的代码。 只在想统计的页面里加这一行也可以,没有加的页面不会出现在报表里。
征求访客同意。 面向有隐私合规要求的访客时,用 data-consent 控制:
| 取值 | 行为 |
|---|---|
off | 不征求同意,直接统计(默认主题的写法) |
optional | 先统计,同时在页面底部显示同意条。访客点了拒绝,或浏览器开启了“请勿跟踪”/ GPC,就不再保存访客标识 |
required | 访客点同意之前不上报任何数据 |
同意条的文字可以用 data-consent-text、data-consent-accept、data-consent-reject、data-consent-link(“了解更多”的链接地址)、 data-consent-link-text 改写。要用主题自己的同意条,给它的容器加上 data-ujcms-consent-banner 属性(系统就不再显示自带的), 在按钮里调用 window. 或 window.。
在线访客数。 GET ${api}/ 返回最近 20 分钟内有过访问的访客数(全部站点合计),默认主题显示在页脚。
不用模板的站点(Vue、小程序等自己渲染页面的前端)调用 POST /,请求体是 JSON:url(页面地址)、entryUrl(入口页面)、 referrer(来源地址)、si(本次访问的随机编号)、uv(访客的随机编号,长期保存)、newVisitor、count(打开页面传 1,离开页面传 0)、 duration(本次访问已持续的秒数)。各字段的要求见文档站的“API 和标签”部分。
四、文章、栏目和站点的浏览量
浏览量是另一组接口,调用一次加 1,同时返回当前的数字:
| 对象 | 接口 | 返回 | 同时还会 |
|---|---|---|---|
| 文章 | GET ${api}/ | 文章的总浏览量 | 给所在栏目及其各级上级栏目、所属站点各加 1 |
| 栏目 | GET ${api}/ | 栏目页自身被浏览的次数 | 给各级上级栏目、所属站点各加 1 |
| 专题(标准版起) | GET ${api}/ | 专题页自身被浏览的次数 | 给各级上级专题、所属站点各加 1 |
| 站点 | GET ${api}/ | views(总访问量)、todayViews(今日)、yesterdayViews(昨日)、maxViews 与 maxDate(单日最高及其日期) | — |
文章页里显示并累加浏览量(默认主题 templates/ 的写法):
[#escape x as (x)!?html]
<span id="articleViews">—</span>
<script nonce="${csp_nonce!''}">
fetch('${api}/article/view/${article.id?c}').then(r => r.json()).then(n => {
document.getElementById('articleViews').textContent = n;
}).catch(() => {});
</script>
[/#escape]栏目页一般不显示数字,只上报:
<script nonce="${csp_nonce!''}">fetch('${api}/channel/view/${channel.id?c}').catch(()=>{});</script>页脚显示站点的访问量(默认主题 snippets/)。文章页、栏目页、专题页已经通过各自的接口给站点加了 1, 这些模板开头写 [#assign pageViewCounted = true/],页脚见到它就改用只读的 site/buffer 接口,其余页面才调用 site/view 计数:
<script nonce="${csp_nonce!''}">
fetch('${api}/site/${(pageViewCounted!false)?then('buffer', 'view')}/${site.id?c}').then(r => r.json()).then(d => {
document.getElementById('siteTodayViews').textContent = d.todayViews;
document.getElementById('siteYesterdayViews').textContent = d.yesterdayViews;
document.getElementById('siteViews').textContent = d.views;
}).catch(() => {});
</script>
规则:
- 不去重。 每调用一次就加 1,同一个访客刷新页面会重复计数;这组数字与访问统计报表里的浏览量(PV)是分开记的,两边不会相等。
- 延迟一到两分钟。 计数先记在内存里,每分钟写入数据库一次,接口返回的是数据库里的数字,所以刚加的这一次不会马上反映出来。
- 站点访问量是累加出来的。 文章、栏目、专题的接口已经给站点加了 1,站点接口每调用一次再加 1。同一个页面既调用文章(栏目、专题)接口 又调用站点接口,站点访问量就加 2。只想显示数字而不计数时,改用
GET ${api}/,返回内容相同。 自己制作的主题若在页脚统一显示站点访问量,照默认主题的办法区分两类页面。site/ buffer/ {站点ID} - 只对访客看得到的文章计数。 未发布的文章、访客没有浏览权限的栏目里的文章,接口返回 0,不计数。
- 文章另有日、周、月、季、年浏览量,到期自动清零,用于“本周热门”一类的排序,写法见 模板标签与 API 的通用参数的“排序:orderBy”一节。只读取文章的各项计数而不加 1,用
GET ${api}/。article/ buffer/ {文章ID} - 模板里的
${article.是页面生成那一刻的数字。静态页和被缓存的页面要显示实时的浏览量,须像上面那样用脚本取。views}
五、常见问题
统计菜单下的报表一直没有数据。 页面里没有引入 visit.js。用浏览器打开前台页面,查看源代码里有没有“在主题里接入访问统计”一节的那一行;自己制作的主题要自行加上。 加上之后等一两分钟再看报表。
用自动化测试工具访问,报表没有变化。 带自动化标记的浏览器不上报,见“统计数据怎样产生”一节。用普通浏览器访问。
报表里的 IP、地域都一样。 程序前面有反向代理而没有设置 ujcms.,见 Nginx 反向代理的“让程序拿到访客的真实 IP”一节。
文章打开了,浏览量没有变。 先确认文章模板里调用了 article/view 接口(“文章、栏目和站点的浏览量”一节);有的话等一两分钟再刷新,计数是每分钟写入一次的。
站点总访问量比访问统计里的浏览量大。 两者是分开记的:站点访问量不去重,也不排除蜘蛛;自己制作的主题若在文章页、栏目页同时调用了站点接口,这些页面还会被计两次,见“文章、栏目和站点的浏览量”一节的规则。