easysoft/alist repository overview

⁠QuickOn AList 应用镜像

⁠快速参考

• 通过 渠成软件百宝箱⁠ 一键安装 AList
• Dockerfile 源码⁠
• AList 源码⁠
• AList 官网⁠

⁠一、关于 AList

Alist⁠ 一个支持多种存储的文件列表程序，使用 Gin 和 Solidjs。

AList官网：https://alist.nn.ci/⁠

⁠1.1 特性

• 使用简单: AList 从一开始就设计为易于安装，并且可以在所有平台上使用
• 使用简单: AList 支持多个存储提供商，包括本地存储、阿里云盘、OneDrive、Google Drive 等，且易于拓展
• 支持 WebDAV: AList 支持所有 WebDAV 存储，这是一种用于访问文件的标准
• 黑暗模式: 自由切换明暗模式
• 受保护的路由: 为特定路径添加密码保护和身份验证
• 文件预览: 支持视频、音频、文档、PDF、图片预览等，甚至支持 ipa 安装
• 打包下载: 使用浏览器的 stream api 支持打包下载，无需使用服务器
• 更多新功能: 包括文本编辑器、README/HTML 渲染、文件永久链接、Cloudflare Workers 代理等

⁠二、支持的版本(Tag)

由于版本比较多,这里只列出最新的5个版本,更详细的版本列表请参考:可用版本列表⁠

• latest⁠
• 3.3.0-20221107⁠

⁠三、获取镜像

推荐从 Docker Hub Registry⁠ 拉取我们构建好的官方Docker镜像。

docker pull easysoft/alist:latest

如需使用指定的版本,可以拉取一个包含版本标签的镜像,在Docker Hub仓库中查看 可用版本列表⁠

docker pull easysoft/alist:[TAG]

⁠四、持久化数据

如果你删除容器，所有的数据都将被删除，下次运行镜像时会重新初始化数据。为了避免数据丢失，你应该为容器提供一个挂在卷，这样可以将数据进行持久化存储。

为了数据持久化，你应该挂载持久化目录：

• /apps/alist/data/ 持久化数据

如果挂载的目录为空，首次启动会自动初始化相关文件

$ docker run -it \
    -v $PWD/data:/apps/alist/data/ \
docker pull easysoft/alist:latest

或者修改 docker-compose.yml 文件，添加持久化目录配置

services:
  AList:
  ...
    volumes:
      - /path/to/persistence:/apps/alist/data/
  ...

⁠五、环境变量

⁠六、运行

⁠6.1 单机Docker-compose方式运行

# 启动服务
make run

# 查看服务状态
make ps

# 查看服务日志
docker-compose logs -f alist

说明:

• 启动成功后，打开浏览器输入 http://<你的IP>:5244 访问管理后台
• 默认用户名：admin，默认密码：qucheng123
• VERSION⁠ 文件中详细的定义了Makefile可以操作的版本
• docker-compose.yml⁠

⁠七、版本升级

容器镜像已为版本升级做了特殊处理，当检测数据（数据库/持久化文件）版本与镜像内运行的程序版本不一致时，会进行数据库结构的检查，并自动进行数据库升级操作。

因此，升级版本只需要更换镜像版本号即可：

...
  2fauth:
-    image: easysoft/alist:3.3.0-20220916
+    image: easysoft/alist:3.4.0-20221021
    container_name: alist
...

更新服务

# 是用新版本镜像更新服务
docker-compose up -d
# 查看服务状态和镜像版本
docker-compose ps