隐私配置
配置内嵌模板以帮助满足各地区的隐私法规。
这一页解决什么问题
Hugo 的一部分内嵌模板会连接外部服务(YouTube、Vimeo、X、Instagram、Disqus、Google Analytics)。[privacy] 让你不改内容就能全局决定两件事:禁用某个服务,或改用隐私友好的嵌入方式(enableDNT、simple、privacyEnhanced)。
责任边界(上游写明):这些设置只是协助工具,合规的最终责任在站点作者;而且它们只影响 Hugo 的内嵌模板,未必作用于第三方主题或模块自己的模板。
什么时候需要这些设置
| 设置 | 什么时候需要 | 改错了会看到什么现象 |
|---|---|---|
*.disable = true |
所在地区不允许该服务,或不想让页面连接第三方 | 短代码还在页面里,但不再渲染嵌入内容:原来能看的视频或评论区变成空白 |
enableDNT / privacyEnhanced |
允许嵌入,但不想在用户交互前写入第三方 Cookie | 只开启它不会改变「能不能看」,但嵌入参数与普通模式不同,别把差异误判成故障 |
simple = true |
想彻底避免第三方 JavaScript,只显示静态卡片或缩略图 | simple 模式能力有限(通常只支持图片卡片、点击后跳转),内联播放体验会变化 |
respectDoNotTrack |
尊重浏览器 DNT 信号(默认已经是 true) |
改成 false 等于无视 DNT——隐私取向上更弱的默认值,改前先想清楚 |
责任划分
站点作者有责任确保站点符合所在地区的隐私法规,包括但不限于:
- GDPR(通用数据保护条例):适用于欧盟与欧洲经济区内的个人。
- CCPA(加州消费者隐私法案):适用于加利福尼亚州居民。
- CPRA(加州隐私权法案):在 CCPA 的基础上扩展,提供更强的消费者隐私保护。
- CDPA(弗吉尼亚州消费者数据保护法):适用于收集、处理或出售弗吉尼亚州居民个人数据的企业。
Hugo 的隐私设置可以协助你履行合规义务,但最终责任仍在站点作者。
内嵌模板
Hugo 提供内嵌模板来简化项目与内容的创建,其中一些模板会与外部服务交互。例如 youtube 短代码会连接 YouTube 的服务器,以便把视频嵌入页面。
这些模板中有一些带有增强隐私的设置,下面列出 Hugo 内嵌模板的默认隐私配置。
默认配置
这些设置只影响 Hugo 部分内嵌模板的行为,未必影响第三方模块或主题所提供的模板。
toml
[privacy]
[privacy.disqus]
disable = false
[privacy.googleAnalytics]
disable = false
respectDoNotTrack = true
[privacy.instagram]
disable = false
simple = false
[privacy.vimeo]
disable = false
enableDNT = false
simple = false
[privacy.x]
disable = false
enableDNT = false
simple = false
[privacy.youTube]
disable = false
privacyEnhanced = false设置项
| 键名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
privacy.disqus.disable |
bool |
false |
是否禁用 Disqus 内嵌模板。 |
privacy.googleAnalytics.disable |
bool |
false |
是否禁用 Google Analytics 内嵌模板。 |
privacy.googleAnalytics.respectDoNotTrack |
bool |
true |
是否尊重浏览器的「请勿跟踪」(Do Not Track)设置。 |
privacy.instagram.disable |
bool |
false |
是否禁用 Instagram 短代码。 |
privacy.instagram.simple |
bool |
false |
是否启用简单模式以生成图片卡片。设为 true 时 Hugo 生成不含 JavaScript 的静态卡片,该模式只支持图片卡片,图片直接从 Instagram 服务器获取。 |
privacy.vimeo.disable |
bool |
false |
是否禁用 Vimeo 短代码。 |
privacy.vimeo.enableDNT |
bool |
false |
是否阻止 Vimeo 播放器跟踪会话数据与分析数据。 |
privacy.vimeo.simple |
bool |
false |
是否启用简单模式。设为 true 时缩略图从 Vimeo 获取并叠加播放按钮,点击后在新标签页打开视频。 |
privacy.x.disable |
bool |
false |
是否禁用 X 短代码。 |
privacy.x.enableDNT |
bool |
false |
是否阻止 X 把帖子和嵌入页面的数据用于个性化推荐与广告。 |
privacy.x.simple |
bool |
false |
是否启用简单模式。设为 true 时 Hugo 构建不含 JavaScript 的帖子静态版本。 |
privacy.youTube.disable |
bool |
false |
是否禁用 YouTube 短代码。 |
privacy.youTube.privacyEnhanced |
bool |
false |
是否阻止 YouTube 在访问者播放嵌入视频之前存储其信息。 |
所有开关的默认值都是 false,也就是说内嵌模板默认可用、默认不启用增强隐私的变体。禁用某个模板后,Hugo 在渲染时不会再连接对应的外部服务。
示例
下面的配置保留 Google Analytics 与 Vimeo、YouTube,但要求它们使用隐私友好的变体,同时彻底禁用 Instagram 与 X:
toml
[privacy]
[privacy.googleAnalytics]
disable = false
respectDoNotTrack = true
[privacy.instagram]
disable = true
[privacy.vimeo]
disable = false
enableDNT = true
simple = true
[privacy.x]
disable = true
[privacy.youTube]
disable = false
privacyEnhanced = true延伸阅读
常见坑
| 症状 | 真因 | 怎么修 |
|---|---|---|
配了 disable,页面上仍有嵌入内容 |
主题或模块使用自己的短代码/模板,不读 [privacy](上游明确点出这一限制) |
到主题模板里改,或在内容层移除该短代码 |
| 视频还能播,但样式变了 | simple = true 切到了静态卡片模式 |
需要内联播放就关掉 simple,改用 enableDNT |
| 统计后台数据比预期少 | respectDoNotTrack 默认为 true,部分浏览器会发送 DNT 信号 |
这是默认行为;确需统计全部访问时,评估合规风险后再调整 |
| 报错看不懂 | 这些改动一般不会报错,症状多为「内容不显示」 | 见故障排查,并核对短代码中对应服务的说明 |
更多排查入口见故障排查。