少女祈祷中...
凉思录-Ryodoku's Blog
技术分享

Halo的AList附件库插件增加一键文件同步功能

起因是我在使用自己的OpenList当Blog的对象存储时发现,OpenList的插件居然无法正确返回URL导致无法使用,然后AList使用AList插件也无法正常使用,最后发现OpenList配AList插件反而是可以正常使用的,但是OpenList插件有的一键同步文件功能AList插件却没有,于是我便基于官方Github上的开源代码进行修改

功能特性

递归扫描 AList 挂载路径下已有的文件,自动登记为 Halo 附件

已同步过的文件自动跳过,可随时重复执行,不会产生重复附件

支持按单个存储策略同步,或一键同步全部 AList 存储策略

同步只新增 Halo 附件记录,**不会删除** AList 或 Halo 上的任何文件

同步完成后展示扫描数 / 新增数 / 跳过数 / 失败数及失败明细

安装

进入 Halo 后台「插件 → 安装」,上传 JAR 文件并启用

要求 Halo 版本 >= 2.20.0

使用方式

  • 安装并启用此插件后,在 Halo 后台新建存储策略:

3.webp
  • 选择 AList 存储:

4.webp
  • 根据提示填写站点地址、挂载路径、账号密码等信息:

5.webp
6.webp
  • 填写的用户应至少拥有下图所示权限,「基本路径」即挂载路径的上级路径:

9.webp
7.webp

一键同步 AList 上已有的文件

如果你的 AList 里在使用本插件之前就已经有文件,Halo 默认并不知道它们的存在。启用插件后:

  1. 进入 Halo 后台「内容 → AList 文件同步」;

  2. 页面会列出所有 AList 存储策略,点击单个策略上的「同步」,或点击右上角「一键同步全部」;

  3. 等待扫描完成,卡片上会显示扫描到多少文件、新增多少附件、跳过多少已存在文件;

  4. 同步进来的附件与手动上传的附件完全一致,在「附件」中选择对应存储策略即可查看、在文章中插入。

同步是幂等的:插件通过附件上的 alist.storage.halo.run/file-path 注解记录每个文件在 AList 上的真实路径,再次同步时已存在的记录会自动跳过

注意事项

  1. 插件依赖 AList/OpenList 服务,请确保 AList/OpenList 服务已经启动并配置正确

  2. 同步大量文件耗时取决于 AList 目录规模,请耐心等待;单个目录或文件失败不会中断整个同步任务,失败明细会在结果中列出

  3. 修改用户状态(如修改密码)后需要重新验证以刷新缓存

  4. 本插件仅做单次修改自用后续不随官方更新而更新

  5. 插件修改由Agent工具创作

本项目衍生自 Halo 官方插件 [halo-sigs/plugin-alist](https://github.com/halo-sigs/plugin-alist)

获取插件及源码

插件链接 提取码:1145

源码链接 提取码:1145

·

·

·

编辑:独凉生

校对:独凉生

评论