{"id":22678690,"url":"https://github.com/halo-sigs/plugin-alist","last_synced_at":"2025-08-26T14:29:43.881Z","repository":{"id":247758512,"uuid":"783512558","full_name":"halo-sigs/plugin-alist","owner":"halo-sigs","description":"集成 AList，支持创建 AList 类型的附件存储策略","archived":false,"fork":false,"pushed_at":"2024-12-09T13:36:49.000Z","size":1085,"stargazers_count":10,"open_issues_count":10,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T09:12:12.298Z","etag":null,"topics":["alist","halo","halo-plugin"],"latest_commit_sha":null,"homepage":"https://www.halo.run/store/apps/app-wEGMV","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/halo-sigs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-08T03:24:24.000Z","updated_at":"2025-03-20T17:51:44.000Z","dependencies_parsed_at":"2024-07-16T16:06:36.542Z","dependency_job_id":"965f9c8f-1ae7-4bdf-b31b-6e52d3d8cb3c","html_url":"https://github.com/halo-sigs/plugin-alist","commit_stats":null,"previous_names":["halo-sigs/plugin-alist"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-sigs%2Fplugin-alist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-sigs%2Fplugin-alist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-sigs%2Fplugin-alist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-sigs%2Fplugin-alist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/halo-sigs","download_url":"https://codeload.github.com/halo-sigs/plugin-alist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248582569,"owners_count":21128405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alist","halo","halo-plugin"],"created_at":"2024-12-09T18:17:03.788Z","updated_at":"2025-04-12T14:41:12.704Z","avatar_url":"https://github.com/halo-sigs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plugin-alist\n\nAList 存储库插件，支持创建 AList 类型的存储库\n\n## 使用方式\n\n首先[部署一个 AList 服务](https://alist.nn.ci/zh/guide/install/docker.html),进入后台管理，创建存储库\n\n![](docs/img/1.png)\n\n根据 [AList 文档](https://alist.nn.ci/zh/guide/) 填写相关信息\n\n![](docs/img/2.png)\n\n安装并启用此插件后，在 Halo 后台新建存储策略\n\n![](docs/img/3.png)\n\n选择 AList 存储\n\n![](docs/img/4.png)\n\n根据提示填写以下信息\n\n![](docs/img/5.png)\n\n![](docs/img/6.png)\n\n你填写的用户应该至少拥有以下权限，这里的基本路径就是挂载路径的上级路径\n\n![](docs/img/9.png)\n![](docs/img/7.png)\n\n## 注意事项\n1. 插件需要依赖 AList 服务，请确保 AList 服务已经启动并配置正确\n2. 如果存储验证成功但是`大文件`上传失败，可能是反向代理的配置有问题，对于 nginx 将下方配置加入你的nginx配置中\n    ```\n    client_body_buffer_size 512k;\n    proxy_read_timeout 86400s;\n    client_max_body_size 0;\n    ```\n   ![](docs/img/8.png)\n3. 修改用户状态后需要重新验证来刷新缓存，如：修改用户密码\n## 开发环境\n\n插件开发的详细文档请查阅：\u003chttps://docs.halo.run/developer-guide/plugin/introduction\u003e\n\n所需环境：\n\n1. Java 17\n2. Node 18\n3. pnpm 8\n4. Docker (可选)\n\n克隆项目：\n\n```bash\ngit clone git@github.com:halo-sigs/plugin-alist.git\n\n# 或者当你 fork 之后\n\ngit clone git@github.com:{your_github_id}/plugin-alist.git\n```\n\n```bash\ncd path/to/plugin-alist\n```\n\n### 运行方式 1（推荐）\n\n\u003e 此方式需要本地安装 Docker\n\n```bash\n# macOS / Linux\n./gradlew haloServer\n\n# Windows\n./gradlew.bat haloServer\n```\n\n执行此命令后，会自动创建一个 Halo 的 Docker\n容器并加载当前的插件，更多文档可查阅：\u003chttps://docs.halo.run/developer-guide/plugin/basics/devtools\u003e\n\n### 运行方式 2\n\n\u003e 此方式需要使用源码运行 Halo\n\n编译插件：\n\n```bash\n# macOS / Linux\n./gradlew build\n\n# Windows\n./gradlew.bat build\n```\n\n修改 Halo 配置文件：\n\n```yaml\nhalo:\n    plugin:\n        runtime-mode: development\n        fixedPluginPath:\n            - \"/path/to/plugin-alist\"\n```\n\n最后重启 Halo 项目即可。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalo-sigs%2Fplugin-alist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhalo-sigs%2Fplugin-alist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalo-sigs%2Fplugin-alist/lists"}