https://github.com/halo-sigs/plugin-alist
集成 AList，支持创建 AList 类型的附件存储策略
https://github.com/halo-sigs/plugin-alist
alist halo halo-plugin
Last synced: 20 days ago
JSON representation
集成 AList，支持创建 AList 类型的附件存储策略
- Host: GitHub
- URL: https://github.com/halo-sigs/plugin-alist
- Owner: halo-sigs
- License: gpl-3.0
- Created: 2024-04-08T03:24:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-09T13:36:49.000Z (5 months ago)
- Last Synced: 2025-03-26T09:12:12.298Z (about 1 month ago)
- Topics: alist, halo, halo-plugin
- Language: Java
- Homepage: https://www.halo.run/store/apps/app-wEGMV
- Size: 1.03 MB
- Stars: 10
- Watchers: 1
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# plugin-alist
AList 存储库插件，支持创建 AList 类型的存储库
## 使用方式
首先[部署一个 AList 服务](https://alist.nn.ci/zh/guide/install/docker.html),进入后台管理，创建存储库
根据 [AList 文档](https://alist.nn.ci/zh/guide/) 填写相关信息
安装并启用此插件后，在 Halo 后台新建存储策略
选择 AList 存储
根据提示填写以下信息
你填写的用户应该至少拥有以下权限，这里的基本路径就是挂载路径的上级路径
## 注意事项
1. 插件需要依赖 AList 服务，请确保 AList 服务已经启动并配置正确
2. 如果存储验证成功但是`大文件`上传失败，可能是反向代理的配置有问题，对于 nginx 将下方配置加入你的nginx配置中
```
client_body_buffer_size 512k;
proxy_read_timeout 86400s;
client_max_body_size 0;
```
3. 修改用户状态后需要重新验证来刷新缓存，如：修改用户密码
## 开发环境
插件开发的详细文档请查阅：
所需环境：
1. Java 17
2. Node 18
3. pnpm 8
4. Docker (可选)
克隆项目：
```bash
git clone [email protected]:halo-sigs/plugin-alist.git
# 或者当你 fork 之后
git clone [email protected]:{your_github_id}/plugin-alist.git
```
```bash
cd path/to/plugin-alist
```
### 运行方式 1（推荐）
> 此方式需要本地安装 Docker
```bash
# macOS / Linux
./gradlew haloServer
# Windows
./gradlew.bat haloServer
```
执行此命令后，会自动创建一个 Halo 的 Docker
容器并加载当前的插件，更多文档可查阅：
### 运行方式 2
> 此方式需要使用源码运行 Halo
编译插件：
```bash
# macOS / Linux
./gradlew build
# Windows
./gradlew.bat build
```
修改 Halo 配置文件：
```yaml
halo:
plugin:
runtime-mode: development
fixedPluginPath:
- "/path/to/plugin-alist"
```
最后重启 Halo 项目即可。