{"id":39120674,"url":"https://github.com/quicklyon/alist-docker","last_synced_at":"2026-01-17T20:33:21.244Z","repository":{"id":62817948,"uuid":"556644494","full_name":"quicklyon/alist-docker","owner":"quicklyon","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-08T11:14:40.000Z","size":548,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-08T12:22:00.854Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quicklyon.png","metadata":{"files":{"readme":"README.md","changelog":"changelog/20221107.md","contributing":null,"funding":null,"license":null,"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":"2022-10-24T08:35:13.000Z","updated_at":"2025-02-08T11:14:40.000Z","dependencies_parsed_at":"2025-02-08T12:31:27.707Z","dependency_job_id":null,"html_url":"https://github.com/quicklyon/alist-docker","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/quicklyon/alist-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Falist-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Falist-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Falist-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Falist-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quicklyon","download_url":"https://codeload.github.com/quicklyon/alist-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Falist-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28517683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-17T20:33:20.526Z","updated_at":"2026-01-17T20:33:21.230Z","avatar_url":"https://github.com/quicklyon.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- 该文档是模板生成，手动修改的内容会被覆盖，详情参见：https://github.com/quicklyon/template-toolkit --\u003e\n# QuickOn AList 应用镜像\n\n[![GitHub Workflow Status](https://github.com/quicklyon/alist-docker/actions/workflows/docker.yml/badge.svg)](https://github.com/quicklyon/alist-docker/actions/workflows/docker.yml)\n![Docker Pulls](https://img.shields.io/docker/pulls/easysoft/alist?style=flat-square)\n![Docker Image Size](https://img.shields.io/docker/image-size/easysoft/alist?style=flat-square)\n![GitHub tag](https://img.shields.io/github/v/tag/quicklyon/alist-docker?style=flat-square)\n\n\u003e 申明: 该软件镜像是由QuickOn打包。在发行中提及的各自商标由各自的公司或个人所有，使用它们并不意味着任何从属关系。\n\n## 快速参考\n\n- 通过 [渠成软件百宝箱](https://www.qucheng.com/app-install/alist-install-\u003cnumber\u003e.html) 一键安装 **AList**\n- [Dockerfile 源码](https://github.com/quicklyon/alist-docker)\n- [AList 源码](https://github.com/alist-org/alist)\n- [AList 官网](https://alist.nn.ci/)\n\n## 一、关于 AList\n\n\u003c!-- 这里写应用的【介绍信息】 --\u003e\n\n[Alist](https://alist.nn.ci/zh/) 一个支持多种存储的文件列表程序，使用 Gin 和 Solidjs。\n  \n![screenshots](https://raw.githubusercontent.com/quicklyon/alist-docker/master/.template/alist_screenshot.png)\n\nAList官网：[https://alist.nn.ci/](https://alist.nn.ci/)\n\n\u003c!-- 这里写应用的【附加信息】 --\u003e\n\n### 1.1 特性\n\n- 使用简单: AList 从一开始就设计为易于安装，并且可以在所有平台上使用\n- 使用简单: AList 支持多个存储提供商，包括本地存储、阿里云盘、OneDrive、Google Drive 等，且易于拓展\n- 支持 WebDAV: AList 支持所有 WebDAV 存储，这是一种用于访问文件的标准\n- 黑暗模式: 自由切换明暗模式\n- 受保护的路由: 为特定路径添加密码保护和身份验证\n- 文件预览: 支持视频、音频、文档、PDF、图片预览等，甚至支持 ipa 安装\n- 打包下载: 使用浏览器的 stream api 支持打包下载，无需使用服务器\n- 更多新功能: 包括文本编辑器、README/HTML 渲染、文件永久链接、Cloudflare Workers 代理等\n\n## 二、支持的版本(Tag)\n\n由于版本比较多,这里只列出最新的5个版本,更详细的版本列表请参考:[可用版本列表](https://hub.docker.com/r/easysoft/alist/tags/)\n\n\u003c!-- 这里是镜像的【Tag】信息，通过命令维护，详情参考：https://github.com/quicklyon/template-toolkit --\u003e\n- [latest](https://github.com/alist-org/alist/releases)\n- [3.3.0-20221107](https://github.com/alist-org/alist/releases/tag/v3.3.0)\n\n## 三、获取镜像\n\n推荐从 [Docker Hub Registry](https://hub.docker.com/r/easysoft/alist) 拉取我们构建好的官方Docker镜像。\n\n```bash\ndocker pull easysoft/alist:latest\n```\n\n如需使用指定的版本,可以拉取一个包含版本标签的镜像,在Docker Hub仓库中查看 [可用版本列表](https://hub.docker.com/r/easysoft/alist/tags/)\n\n```bash\ndocker pull easysoft/alist:[TAG]\n```\n\n## 四、持久化数据\n\n如果你删除容器，所有的数据都将被删除，下次运行镜像时会重新初始化数据。为了避免数据丢失，你应该为容器提供一个挂在卷，这样可以将数据进行持久化存储。\n\n为了数据持久化，你应该挂载持久化目录：\n\n- /apps/alist/data/ 持久化数据\n\n如果挂载的目录为空，首次启动会自动初始化相关文件\n\n```bash\n$ docker run -it \\\n    -v $PWD/data:/apps/alist/data/ \\\ndocker pull easysoft/alist:latest\n```\n\n或者修改 docker-compose.yml 文件，添加持久化目录配置\n\n```bash\nservices:\n  AList:\n  ...\n    volumes:\n      - /path/to/persistence:/apps/alist/data/\n  ...\n```\n\n## 五、环境变量\n\n\u003c!-- 这里写应用的【环境变量信息】 --\u003e\n\n\n| 变量名               | 默认值        | 说明           |\n| -------------------- | ------------- | -------------- |\n| ALIST_ADMIN_PASSWORD | qucheng123    | 默认管理员密码 |\n\n## 六、运行\n\n### 6.1 单机Docker-compose方式运行\n\n```bash\n# 启动服务\nmake run\n\n# 查看服务状态\nmake ps\n\n# 查看服务日志\ndocker-compose logs -f alist\n\n```\n\n\u003c!-- 这里写应用的【make命令的备注信息】位于文档最后端 --\u003e\n**说明:**\n\n- 启动成功后，打开浏览器输入 `http://\u003c你的IP\u003e:5244` 访问管理后台\n- 默认用户名：`admin`，默认密码：`qucheng123`\n- [VERSION](https://github.com/quicklyon/alist-docker/blob/master/VERSION) 文件中详细的定义了Makefile可以操作的版本\n- [docker-compose.yml](https://github.com/quicklyon/alist-docker/blob/master/docker-compose.yml)\n\n## 七、版本升级\n\n\u003c!-- 这里是镜像的【版本升级】信息，通过命令维护，详情参考：https://github.com/quicklyon/template-toolkit --\u003e\n容器镜像已为版本升级做了特殊处理，当检测数据（数据库/持久化文件）版本与镜像内运行的程序版本不一致时，会进行数据库结构的检查，并自动进行数据库升级操作。\n\n因此，升级版本只需要更换镜像版本号即可：\n\n\u003e 修改 docker-compose.yml 文件\n```diff\n...\n  2fauth:\n-    image: easysoft/alist:3.3.0-20220916\n+    image: easysoft/alist:3.4.0-20221021\n    container_name: alist\n...\n```\n\n更新服务\n\n```bash\n# 是用新版本镜像更新服务\ndocker-compose up -d\n# 查看服务状态和镜像版本\ndocker-compose ps\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquicklyon%2Falist-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquicklyon%2Falist-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquicklyon%2Falist-docker/lists"}