AList 存储库

AList 存储库

5,242
2,227

支持创建 AList 类型的附件存储策略

下载

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索AList 存储库并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

plugin-alist

AList 存储库插件,支持创建 AList 类型的存储库

使用方式

首先部署一个 AList 服务,进入后台管理,创建存储库

img

根据 AList 文档 填写相关信息

img

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

img

选择 AList 存储

img

根据提示填写以下信息

img

img

你填写的用户应该至少拥有以下权限,这里的基本路径就是挂载路径的上级路径

img img

注意事项

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

  2. 如果存储验证成功但是

    大文件
    

    上传失败,可能是反向代理的配置有问题,对于 nginx 将下方配置加入你的nginx配置中

    client_body_buffer_size 512k;
    proxy_read_timeout 86400s;
    client_max_body_size 0;
    

    img

  3. 修改用户状态后需要重新验证来刷新缓存,如:修改用户密码

开发环境

插件开发的详细文档请查阅:https://docs.halo.run/developer-guide/plugin/introduction

所需环境:

  1. Java 17
  2. Node 18
  3. pnpm 8
  4. Docker (可选)

克隆项目:

git clone git@github.com:halo-sigs/plugin-alist.git

# 或者当你 fork 之后

git clone git@github.com:{your_github_id}/plugin-alist.git
cd path/to/plugin-alist

运行方式 1(推荐)

此方式需要本地安装 Docker

# macOS / Linux
./gradlew haloServer

# Windows
./gradlew.bat haloServer

执行此命令后,会自动创建一个 Halo 的 Docker 容器并加载当前的插件,更多文档可查阅:https://docs.halo.run/developer-guide/plugin/basics/devtools

运行方式 2

此方式需要使用源码运行 Halo

编译插件:

# macOS / Linux
./gradlew build

# Windows
./gradlew.bat build

修改 Halo 配置文件:

halo:
    plugin:
        runtime-mode: development
        fixedPluginPath:
            - "/path/to/plugin-alist"

最后重启 Halo 项目即可。

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索AList 存储库并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

这是一个开源应用,我们推荐优先在开源仓库中提交 issue,以便开发者更好地接收和跟进问题。

去提交 issue