Skip to content

Hexo-safego 2.0.1

Compare
Choose a tag to compare
@willow-god willow-god released this 15 Aug 04:20
· 6 commits to main since this release

hexo-safego 2.0.1

更新内容

  • 配置项:添加'exclude_pages',可以排除某些页面,用于和apply配合使用(@xyhcode )
  • 文档:完善文档中新配置项的内容(@willow-god )
  • 置空判断:优化部分配置项置空时的处理,防止由于空值出现错误(@willow-god )

(本次升级为兼容式升级,升级后不变动配置项也可以继续使用,不影响原始功能)

更新插件

npm update hexo-safego --save

主要特性

  • 外部链接跳转:将外部链接替换为自定义的跳转页面,可以自定义文件名称,增加安全性。
  • 灵活配置:支持多个容器,使用css选择器进行选择、支持白名单域名和生效页面路径的配置。
  • Base64 编码:可选将外链链接编码为Base64加密,在跳转时再使用js转为正常网站地址,增强安全性能。
  • 调试模式:调试模式输出详细信息,便于开发和调试。
  • 自定义页面:支持设置标题、副标题、头像、暗黑模式,如果有前端基础,还可以自己定义跳转页面进行美化。
  • 精简配置:去除很多没必要的配置项,简单配置即可直接使用,操作更加小白化。

:由于该插件是在构建时替换,但是评论区是前端js生成,所以无法在配置项中添加评论区相关的跳转!!!

示例配置项

# hexo-safego安全跳转插件
# see https://blog.qyliu.top/posts/1dfd1f41/
hexo_safego:
  enable: true  # 是否启用 hexo-safego 插件
  enable_base64_encode: true  # 是否启用 Base64 编码链接
  enable_target_blank: true  # 是否在跳转链接中添加 target="_blank"
  url_param_name: 'u'  # URL 参数名,用于生成跳转链接
  html_file_name: 'go.html'  # 跳转页面文件名
  ignore_attrs:  # 需要忽略的链接属性列表
    - 'data-fancybox'
  apply_containers:  # 容器 ID 列表,如果为空则匹配整个 body
    - '#article-container'
  domain_whitelist:  # 域名白名单列表,包含白名单中的域名的链接将被忽略
    - 'example.com'
  exclude_pages: # 排除路径列表,会排除这些页面,可以配合生效页面路径配合使用
    - '/safego_exclude_page/'
  apply_pages:  # 生效页面路径列表,只有在这些页面上才会对链接进行处理
    - '/posts/'
  avatar: https://fastly.jsdelivr.net/gh/willow-god/hexo-safego@latest/lib/avatar.png  # 头像图片链接
  title: "清羽飞扬"  # 标题
  subtitle: "安全中心"  # 副标题
  darkmode: false  # 是否启用夜间模式
  debug: false  # 是否启用调试模式,开启后会输出详细的调试信息

更加详细的教程请看详细使用说明