picgo-plugin-strip-metadata
v0.1.1
Published
Strip image metadata before uploading with PicGo using ExifTool.
Maintainers
Readme
picgo-plugin-strip-metadata
一个 PicGo 上传前处理插件,用于在上传图片前调用 ExifTool 移除图片元数据。
它不会压缩图片,不会缩放图片,也不会转换图片格式。插件会把图片临时写入本地文件,执行 exiftool -all= 移除元数据,然后再把处理后的图片交给 PicGo 正常上传。
为什么需要
照片里可能包含相机型号、拍摄时间、GPS 位置、编辑软件、缩略图等元数据。公开上传图片时,这些信息可能带来隐私风险。
相比通过重新编码图片来间接移除 EXIF 的插件,本插件使用 ExifTool 直接清理元数据,尽量避免改变图片质量。
已经压缩图片了,还需要这个插件吗
不一定需要。很多图片压缩或格式转换插件会重新编码图片,EXIF 元数据通常会在这个过程中顺带消失。
本插件适合把“移除元数据”作为一个独立的隐私步骤使用:不压缩、不缩放、不转换格式,也尽量不改变图片质量。这样上传流程更明确:压缩插件负责减小体积,本插件负责清理元数据。
如果你现有的压缩流程已经会移除元数据,并且你接受它对图片编码、体积或质量的改变,那可以不使用本插件。
依赖要求
使用前需要先安装 ExifTool,并确保命令行里可以直接运行 exiftool。
Arch Linux:
sudo pacman -S perl-image-exiftoolDebian / Ubuntu:
sudo apt install libimage-exiftool-perlmacOS:
brew install exiftoolWindows:
安装 ExifTool,并把它加入 PATH;或者在插件配置里填写 ExifTool 可执行文件的完整路径。
安装方式
在 PicGo 图形界面中打开“插件设置”,搜索:
strip-metadata也可以通过 PicGo Core 安装:
picgo add strip-metadata配置项
| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| exiftoolPath | exiftool | ExifTool 可执行文件路径 |
| extensions | .jpg,.jpeg,.png,.webp,.tif,.tiff,.heic,.heif | 需要处理的图片扩展名 |
| failOnError | false | 清理失败时是否中断上传 |
| enableLogging | false | 是否输出详细 PicGo 日志 |
默认情况下,如果 ExifTool 执行失败,插件会记录错误并继续上传原图。这样可以避免因为用户环境缺少 ExifTool 导致 PicGo 上传流程直接中断。
如果你的隐私要求很严格,建议把 failOnError 设置为 true。这样只要元数据清理失败,上传就会停止。
验证方法
上传前检查图片元数据:
exiftool image.jpg上传后下载图片,再次检查:
exiftool downloaded.jpg正常情况下,EXIF、GPS、相机型号、拍摄时间等字段应该已经被移除。
开发
npm run check
npm run pack:dry许可证
MIT
