加密

pengzhanbo

803字约3分钟

2024-03-04

加密

在本主题中，支持 全站加密 和 部分加密 等多种灵活的加密方式。

提示

由于 vuepress 是静态站点，其自身限制的原因，加密仅仅只是看起来看不到内容，并且在编译时，不再将内容预渲染到 html 中，但实际上还是能够从站点源文件中获取到内容。因此，不建议将加密功能认为是安全可靠的。

请尽量避免将 加密功能 应用于需要 严格保密 的内容中。

已解锁的文章，仅在当前会话中可见。

启用加密功能

在主题配置中，添加 encrypt 选项。

import { defineUserConfig } from 'vuepress'
import { themePlume } from 'vuepress-theme-plume'

export default defineUserConfig({
  theme: themePlume({
    encrypt: {
      // more options...
    }
  })
})

全站加密

有些情况下，你可能需要对全站进行加密。因此，你可以通过 encrypt.global 选项配置全站加密。然后，通过配置 encrypt.admin 选项，设置一个或多个密码。

export default defineUserConfig({
  theme: themePlume({
    encrypt: {
      global: true,
      admin: ['123456'],
    }
  })
})

部分加密

大多数情况下，你可能只需需要加密某一篇文章、某一个目录等。因此，你可以通过 encrypt.rules 选项配置部分加密。

export default defineUserConfig({
  theme: themePlume({
    encrypt: {
      rules: {
        // 可以是 md 文件的相对路径，对该文件加密
        '前端/基础.md': '123456',
        // 可以是 文件夹的路径，对该目录下所有文章加密
        '/notes/vuepress-theme-plume/': '123456',
        // 可以是 访问地址的请求路径，对该访问路径下所有文章加密
        '/vuepress-theme-plume/': '123456',
        // 可以是 具体的某个页面的请求路径，对该页面加密
        '/article/f8dnci3/': '123456',
        // 如果是 `^` 开头，则匹配该正则表达式的页面也会加密
        '^/(a|b)/': '123456',
      }
    }
  })
})

encrypt.rules 的键将作为匹配规则，值将作为该规则对应的密码，可以设置一个或多个密码。

说明

密码必须是普通的字符串。
如果是加密的是整个目录，解锁时也是解锁整个目录，而不是解锁该目录下的某个文章。
encrypt.admin 也可用于解锁 部分加密 的页面。
使用 encrypt.admin 解锁后，被认为是管理员访问，其它未解锁页面也默认解锁。

示例

点击访问加密文章，密码：123456

相关配置

以下配置支持在多语言配置中使用。

encryptGlobalText

类型： string
默认值： 'Only password can access this site'
说明：
全站加密时，提示信息。支持 HTML。如果你期望为访客提供获取密码的联系方式，你可能会需要这个配置。

encryptPageText

类型： string
默认值： 'Only password can access this page'
说明：
部分加密时，提示信息。支持 HTML。如果你期望为访客提供获取密码的联系方式，你可能会需要这个配置。

encryptButtonText

类型： string
默认值： 'Confirm'
说明：确认按钮的文本

encryptPlaceholder

类型： string
默认值： 'Enter password'
说明：密码输入框的占位符

示例

import { defineUserConfig } from 'vuepress'
import { themePlume } from 'vuepress-theme-plume'

export default defineUserConfig({
  theme: themePlume({
    locales: {
      '/': {
        encryptButtonText: 'Confirm',
        encryptPlaceholder: 'Enter password',
        encryptGlobalText: 'Only password can access this site',
        encryptPageText: 'Only password can access this page',
      }
    }
  })
})