Halo - Lsky Pro

集成 Lsky Pro 兰空图床作为 Halo 的存储后端。

局限性：

• 仅支持 Lsky Pro v2，不支持旧版本。
• 由于 Lsky Pro 限制，仅支持上传图片类附件。（不影响上传任意文件到其他存储策略）
• 由于 Lsky Pro 限制，若启用图床端格式转换（图片压缩）将导致 Halo 中显示的附件大小不正确。

📖 使用说明

本插件无需设置，安装后请到 Halo 后台「附件 - 存储策略」处添加策略。

API Token

Lsky Pro v2 后台没有生成 Token 功能，必须通过请求 API 接口获得。具体接口定义在 Lsky Pro 后台可以看到。

cURL 方式

若计算机已安装 curl 则可以通过命令行获取：

curl --location --request POST 'https://example.com/api/v1/tokens' \
--form 'email="your-email"' \
--form 'password="your-password"'

在线 HTTP 请求工具

例如 Getman:

相册 ID

Note

开源版兰空图床不支持此参数，设置后无效。

此处可以指定上传图片的归属相册，留空则不指定（即不属于任何相册）。

如果 Lsky Pro 后台不显示相册 ID。打开浏览的开发者工具 (F12)，切换到网络 (Network) 标签页，然后再点击 「我的图片 - 相册 - 选中一个相册」，此时可以看到多了一个请求，名称形如 images?page=1&album_id=1，从这就可以得到相册 ID 啦。

当然也可以通过 API 获取，如果你有 curl 的话那么执行：

curl https://yourdomain.com/api/v1/albums -H 'Authorization: Bearer {your-api-token}'

实例 ID

Halo 的设计非常灵活，允许安装一个插件后基于不同参数（例如不同 Lsky Pro 服务器）创建多个存储策略，故本插件需要一种方式判断某个图片（附件）与哪一个 Lsky Pro 实例关联，从而正确删除图片。「实例 ID」就是做这个用的，具体来说：

• 每个附件都会在上传时记录当前的实例 ID，并且永远不会改变。
• 即使重新安装插件，或更改图床地址，或执行其他任何操作，只要实例 ID 与附件记录的匹配就会自动关联。

实例 ID 可以是任意字符串。更改实例 ID 将导致之前上传的附件失去关联。

Tip

推荐一开始就手动设置实例 ID。

默认生成的 ID 与 Lsky Pro 地址关联（忽略协议）。这意味着地址更换将导致之前上传的附件失去关联，从 Halo 删除时无法同步删除 Lsky Pro 中的文件。

建议/反馈

这里是免费开源的第三方插件，无论是否为 Halo 商业用户都不会获得独特的售后服务，请前往仓库的 issues 进行反馈。

求助请描述清楚问题，尽量附上你的配置，错误日志，故障截图等。建议请写明背景和用例。

一句话的反馈将被无条件关闭。