在静态网站安装 Stats4U,保护私密访问凭据
已完成技术审核:
本文内容
静态网站无需自行运行 PHP 或维护访客数据库,也能加载 Stats4U 计数器。浏览器从 Stats4U 加载嵌入资源,并由该服务进行计数。安装能否成功,仍取决于已发布的 HTML、托管服务策略,以及访客浏览器是否允许所需请求。
- 区分公开代码和私密访问凭据
- 在模板中发布嵌入代码
- 检查请求及报告限制
准备公开嵌入代码
- 新建计数器时,选择样式并复制生成的代码。使用现有计数器时,保留其编号。编辑网站之前,妥善保存私密管理链接。计数器可以无需账户使用,但所有者访问权限仍需保护。
- 共用 HTML 模板中计数器应出现的位置,只放入公开嵌入代码。静态网站生成器必须将该模板带入已发布页面。部署后应检查生成的 HTML;修改源组件并不能证明线上页面已包含代码。
- 所有者令牌、管理链接和 API 密钥不应放入公开 HTML 或代码仓库。正常嵌入只需要计数器编号和公开样式选项。提交之前应检查复制文本的完整内容,不要将私密书签当作安装说明公开。
使用托管服务支持的嵌入方式
允许外部脚本时,使用生成的 JavaScript 嵌入代码和托管的 s4u.js 地址,让更新能够传递到嵌入资源。下载的副本会停留在复制时的版本,除非单独更新;网站改动不会自动更新该文件。
仅接受图片、Markdown 或 BBCode 时,使用对应的生成代码。这种方式可以计数图片请求,而页面详情取决于 HTTP Referer 或明确提供的地址。可选的自动事件需要 JavaScript;仅靠图片无法观察表单是否确认成功。
安全检查已发布的结果
在浏览器网络面板中检查经过授权的自有测试页面。核对计数器编号、重复嵌入代码及被拦截的资源。Content Security Policy、编辑器过滤或浏览器扩展都可能阻止脚本或图片加载。不应仅为显示一个徽章而关闭大范围的安全保护。
普通页面访问可能被计数。不要手动打开或反复刷新计数图片地址来排查安装。不可见样式可能正常加载,却不显示徽章;应检查请求及相应报告,而不是为了显示内容再增加一份嵌入代码。
了解计数器无法观察的内容
计数器报告的是到达 Stats4U 的请求及支持的测量数据。它无法看到静态托管服务处理的每个请求、服务器错误、下载失败或带宽使用。这些信息需要依靠托管服务日志或其监控功能,前提是服务提供这些功能。静态托管并不意味着这些信息一定不可用。
静态网站仍需要维护内容、保护发布账户,并提供合适的隐私说明。计数器不会免除这些责任。只有理解设置方法后,才应启用可选的推广活动或事件测量;安装基础代码并不会自动填满所有高级报告。
选择并发布合适的嵌入代码
安装指南说明可用的代码格式及嵌入后的检查方法。
打开安装指南