📖 文档
徽计 API 完整使用指南
🚀 快速开始
// HTML 嵌入代码
<img src="https://count.ruseo.cn/hit?page=my-blog" alt="visitors">
// Markdown 格式
// 显示PV+UV
<img src="https://count.ruseo.cn/hit?page=my-blog&show=pv+uv" alt="统计">
不传
page 参数时，系统自动根据 Referer 生成页面标识（域名+路径），无需手动配置。⚠️ 请使用唯一的页面标识（如域名+路径），避免与其他网站冲突。
📊 统计代码
<img src="https://count.ruseo.cn/hit?page=your-page" alt="统计">
今日访问量 <img src="https://count.ruseo.cn/hit?page=your-page&label=今日访问&color=blue" alt="今日访问"> 次
总访问量 <img src="https://count.ruseo.cn/hit?page=your-page&label=总访问&color=green" alt="总访问"> 次
🔌 API 接口
GET /hit
核心接口：计数 + 返回 SVG 徽标图片
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | string | 否 | 页面唯一标识，默认从 Referer 自动生成 |
theme | string | 否 | 主题风格，默认 flat。详见主题列表 |
label | string | 否 | 左侧标签文字，默认 visitors |
color | string | 否 | 右侧颜色，默认 brightgreen。支持命名色和 #hex |
labelColor | string | 否 | 左侧颜色，默认 grey |
logo | string | 否 | 左侧图标名称。详见图标列表 |
logoColor | string | 否 | 图标颜色，默认 white |
format | string | 否 | 数字格式：comma/short/raw/chinese，默认 comma |
show | string | 否 | 显示维度：pv/uv/pv+uv，默认 pv |
readonly | bool | 否 | 设为 1 只返回 SVG 不计数，适合预览/文档 |
示例：
https://count.ruseo.cn/hit?page=blog&theme=dark&label=访客&color=blue&logo=eye&format=comma&show=pv
GET /count
只读接口：返回 JSON 格式计数数据，不增加计数
// 请求
GET /count?page=my-blog
// 响应
{
"page": "my-blog",
"pv": 12345,
"uv": 678
}
GET /hit?count_only=1
只计数，不返回 SVG（返回空 200 响应）
GET /runtime
运行时长徽章：显示服务启动以来的运行时间
// 请求示例
GET /runtime?label=运行时长&color=blue&theme=flat
// 参数说明
label - 左侧标签文字，默认 "运行时长"
color - 右侧颜色，默认 blue
theme - 主题风格，默认 flat
logo - 图标名称
GET /online
在线人数徽章：实时显示当前网站的在线访客数
// 请求示例
GET /online?label=%E5%9C%A8%E7%BA%BF%E4%BA%BA%E6%95%B0&color=green
// 参数说明
label - 左侧标签文字，默认 "在线人数"
color - 右侧颜色，默认 green
theme - 主题风格，默认 flat
logo - 图标名称
GET /today
今日访问徽章：显示今日PV/UV访问统计
// 请求示例
GET /today?label=%E4%BB%8A%E6%97%A5%E8%AE%BF%E9%97%AE&color=purple&show=pv
// 参数说明
label - 左侧标签文字，默认 "今日访问"
color - 右侧颜色，默认 purple
theme - 主题风格，默认 flat
logo - 图标名称
show - 显示维度：pv/uv，默认 pv
GET /geo
IP归属地徽章：自动识别访问者IP并显示归属地信息
// 请求示例
GET /geo?label=%E5%BD%92%E5%B1%9E%E5%9C%B0&color=orange
// 参数说明
label - 左侧标签文字，默认 "归属地"
color - 右侧颜色，默认 orange
theme - 主题风格，默认 flat
logo - 图标名称
ip - 指定IP地址查询（可选，默认自动获取访问者IP）
🎨 主题列表
| 主题名 | 风格 | 示例 |
|---|---|---|
flat / default | 扁平风格，shields.io 经典样式 | |
dark | 暗色背景，适合暗色主题网站 | |
flat-square | 无圆角扁平风格 | |
for-the-badge | 大号加粗，醒目展示 | |
plastic | 立体风格，经典 badges.furcan style | |
social | 社交风格，左侧带图标区域 | |
pixel | 像素复古游戏风格 | |
neon | 霓虹灯发光效果 | |
chinese | 国风主题，印章风格 | |
terminal | 终端风格，$ 提示符 + 等宽字体 | |
brutal | 粗野主义，粗黑边框 + 偏移阴影 | |
gradient | 渐变流动色彩 | |
outline | 描边线框风格 | |
candy | 糖果风格，大圆角 + 柔和渐变 | |
matrix | 黑客帝国风格，绿色矩阵 + 扫描线 | |
cyberpunk | 赛博朋克风格，霓虹紫青配色 | |
dracula | Dracula深色风格，粉青配色 | |
gruvbox | 复古棕色风格，暖色调配色 | |
nord | 蓝色调风格，清新配色 | |
monokai | 经典代码编辑器配色 | |
solarized | 经典配色方案 | |
material | Material Design风格 | |
retro | 怀旧复古风格 | |
space | 太空星空风格 | |
vintage | 复古纸张风格 | |
minimal | 极简主义风格 | |
retrowave | 复古波浪风格 | |
ocean | 海洋蓝色调风格 | |
forest | 森林绿色调风格 | |
sunset | 日落暖色调风格 |
🎨 命名色表
| 名称 | 色值 |
|---|---|
brightgreen / success | #4c1 |
green | #97CA00 |
limegreen | #4ade80 |
emerald | #10b981 |
yellowgreen | #a4a61d |
yellow | #dfb317 |
amber / warning | #f59e0b |
orange / important | #fe7d37 |
orangered | #ea580c |
red / critical | #e05d44 |
crimson / danger | #dc2626 |
pink | #fe4f9f |
rose | #f43f5e |
fuchsia | #d946ef |
purple / violet | #8b5cf6 |
indigo | #6366f1 |
blue / informational / info | #007ec6 |
skyblue | #0ea5e9 |
teal | #14b8a6 |
cyan | #06b6d4 |
slate | #64748b |
lightgrey / lightgray | #9f9f9f |
grey / gray | #555 |
black | #0f172a |
white | #ffffff |
也支持 16 进制色值：color=#ff6600
🔍 图标列表
| 名称 | 说明 |
|---|---|
eye | 眼睛 👁️ |
heart / love | 爱心 ❤️ |
fire | 火焰 🔥 |
star | 星星 ⭐ |
github | GitHub 标志 |
thumbup / like | 点赞 👍 |
lightning / zap | 闪电 ⚡ |
rocket | 火箭 🚀 |
trophy | 奖杯 🏆 |
award | 奖章 |
crown | 皇冠 👑 |
diamond | 钻石 💎 |
chat | 聊天 💬 |
comment | 评论 |
bookmark | 书签 🔖 |
flag | 旗帜 🚩 |
tag | 标签 🏷️ |
chart | 图表 📈 |
trending | 趋势 📊 |
clock | 时钟 🕐 |
timer | 计时器 ⏱️ |
globe | 地球 🌐 |
target | 目标 🎯 |
compass | 指南针 🧭 |
download | 下载 ⬇️ |
cloud | 云 ☁️ |
music | 音乐 🎵 |
video | 视频 🎬 |
camera | 相机 📷 |
image | 图片 🖼️ |
code | 代码 💻 |
terminal | 终端 ⌨️ |
bug | 虫子 🐛 |
puzzle | 拼图 🧩 |
visitor | 访客 👥 |
arrowup | 上箭头 ⬆️ |
arrowdown | 下箭头 ⬇️ |
arrowleft | 左箭头 ⬅️ |
arrowright | 右箭头 ➡️ |
check | 对勾 ✓ |
checkcircle | 圆形对勾 ✔️ |
x | 叉号 ✗ |
xcircle | 圆形叉号 ✖️ |
alert | 警告 ⚠️ |
info | 信息 ℹ️ |
settings | 设置 ⚙️ |
home | 首页 🏠 |
mail | 邮件 📧 |
user | 用户 👤 |
users | 用户组 👥 |
calendar | 日历 📅 |
link | 链接 🔗 |
unlink | 取消链接 |
copy | 复制 📋 |
search | 搜索 🔍 |
bell | 铃铛 🔔 |
shield | 盾牌 🛡️ |
lock | 锁 🔒 |
unlock | 解锁 🔓 |
key | 钥匙 🔑 |
database | 数据库 🗄️ |
server | 服务器 🖥️ |
folder | 文件夹 📁 |
file | 文件 📄 |
trash | 垃圾桶 🗑️ |
pen / edit | 笔 / 编辑 ✏️ |
plus | 加号 ➕ |
minus | 减号 ➖ |
refresh | 刷新 🔄 |
rotateccw | 旋转 🔄 |
share | 分享 📤 |
activity | 活动 📊 |
bar | 柱状图 📊 |
📊 数字格式
| 格式 | 参数 | 示例输出 |
|---|---|---|
| 千分位逗号 | format=comma | 1,234,567 |
| 英文缩写 | format=short | 1.2M |
| 原始数字 | format=raw | 1234567 |
| 中文单位 | format=chinese | 123万 |
📈 显示维度
| 维度 | 参数 | 说明 |
|---|---|---|
| PV 浏览量 | show=pv | 页面总访问次数（默认） |
| UV 独立访客 | show=uv | 基于 IP+UA 去重的访客数 |
| 同时显示 | show=pv+uv | 一行展示 PV 和 UV |
🛡️ 防刷机制
- IP 限频 — 同一 IP 对同一页面 60 秒内只计 1 次 PV
- UA 过滤 — 自动识别并忽略搜索引擎爬虫（Googlebot、Bingbot 等）
- UV 去重 — 基于 IP + User-Agent 组合去重