AList is a file list program that supports multiple storage, powered by Gin (back end) and Solidjs (front end). It is similar as some other programs I used before in this blog. You can find related posts regarding them, such as OnePoint, GoIndex, OneManager, FODI (Fast OneDrive Index), etc :
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (1)](https://p.51sec.org/file/netsec/2022/12/cloud%20drive%20corner%20500x500.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (1)")
- Use Cloudflare Workers with Rclone to Deploy A Cloud Drive Index & List App - OnePoint
- Using Cloudflare Workers to Deploy Free Google Drive Directory Indexer in 5 Minutes (GoIndex)
- Fast OneDrive Index(FODI)- A Serverless OneDrive Index Setup
- OneManager - Deploy a free OneDrive List App using Heroku and Cloudflare
- OlaIndex
Unfortunately, most of those programs are not actively maintained although they are still working fine as long as you configured them correctly. AList is still actively developing at their Github site. I am really hoping the author found a good way to continue this Open Source project for a longer time.
So far, based on my experience and testing for all of those Cloud Drive File Listing program, AList is best, OnePoint is second. Others are still having some critical function / feature missing.
Some typical usages for AList:
- Central Management For All Your Cloud Storages (Support multiple popular storage sites)
- Centrlized Media Sharing Site (Media preview feature)
- Replace Your NAS using RaiDrive to Mount it as local drive (WebDav feature)
- Provide direct links for your images or videos. (Listing files and folders)
Related Sites for this AList project:
- Github :https://github.com/alist-org/alist
- Document:https://alist.nn.ci/
- Demo:https://al.nn.ci
Related Posts:
Introduction
This file list program, Alist, supports multiple storage, and supports web browsing and webdav, powered by gin and Solidjs
Features:
- Easy to deploy and out-of-the-box
- File preview (PDF, markdown, code, plain text, ...)
- Image preview in gallery mode
- Video and audio preview, support lyrics and subtitles (More formats supported, such as MKV, MP4, etc)
- Office documents preview (docx, pptx, xlsx, ...)
README.mdpreview rendering- File permalink copy and direct file download
- Dark mode
- I18n
- Protected routes (password protection and authentication)
- WebDav (seehttps://alist.nn.ci/guide/webdav.htmlfor details)
- Docker Deploy
- Cloudflare workers proxy
- File/Folder package download
- Web upload(Can allow visitors to upload), delete, mkdir, rename, move and copy
- Offline download
- Copy files between two storage
There might be more cloud storage supported already, please visit Github page to get latest list.
Self Hosted Docker Installation Pre-requirements
Free resources you might need to complete this docker project:
- Server:Oracle Free VPS, Azure Free VPS, Google Cloud Free VPS, and others
- Create a Free Tier Windows/Linux Azure VPS VM
- [Free VPS] GCP (Google Cloud Platform) Tips and Tricks (Free 16G RAM, 4 vCPU VPS)
- System: Cloud Vendor Ubuntu, Debian, orDD an original version
- SWAP size increase:wget https://raw.githubusercontent.com/51sec/swap/main/swap.sh&& bash swap.sh
- Enable Password ssh login
- Enable BBR
- systemctl restart docker
- Domain: (Optional)EU.ORG to get a free one, freeCloudflare accounttomanage your domain
- Confirm port has not been used (you might need to install lsof using command :apt install lsof):
- lsof -i:8088
Pre-installed services:
- Docker,
- apt update
- apt install docker.io
- apt install docker-compose
- apt upgrade docker.io
- mkdir /root/data/docker_data/<docker_name>
- Docker-Compose(Using Ubuntu OS for the commands)
- Docker-compose down
- Optional command : use following command to backup your Docker data. You might need to change your folder name based on your docker configuraiton
- cp -r /root/data/docker_data/<docker_name> /root/data/docker_data_backup/<docker_name>
- docker-compose pull
- docker-compose up -d
- docker image prune
- Portainer (Optional)
- docker volume create portainer_data
- docker run -d -p 9000:9000 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
- Install some applications:apt install wget curl sudo vim git(Optional)
- aapanel with Nginx(Optional)
- Nginx Proxy Manager(Optional)
- Install screen (Optional)
- Install screen(Depends on the Linux Distribution if it came pre installed or not) :yum install screen
- Initiate a Screen :screenorscreen -S <screen name> <command to execute>
- Detach from the screen : "CTRL+A,D" not "CTRL+A+D"
- List all the screen currently working :screen -ls
- Reattach to a screen :screen-r<session number>orscreen -r <screen name>
- Kill specific screen:screen -X -S <screen name> quit
- Kill all screens :pkill screen
Docker Run to Deploy
Usage
stable version
docker run -d --restart=always -v /etc/alist:/opt/alist/data -p 5244:5244 --name="alist" xhofe/alist:latestbeta version (not recommended)
docker run -d --restart=always -v /etc/alist:/opt/alist/data -p 5244:5244 --name="alist" xhofe/alist:mainInitial password refer to logs.
Use the following command after running the above command:
docker logs alist# ordocker exec -it alist ./alist passwordNoets:
Docker Hub site:
- https://hub.docker.com/r/xhofe/alist
Docker Run AList fromhttps://labs.play-with-docker.com/
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (2)](https://p.51sec.org/file/netsec/2022/12/chrome_CK9Jk3KliI.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (2)")
Login to Alist with the admin username and the found password from logs:
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (3)](https://p.51sec.org/file/netsec/2022/12/chrome_6Wa67BPTJ6.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (3)")
AList Manage backend:
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (4)](https://p.51sec.org/file/netsec/2022/12/chrome_KDkClJuUa3.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (4)")
You can change your AList App's logo, favicon, home icon and home container style:
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (5)](https://p.51sec.org/file/netsec/2022/12/chrome_5AGF4QNJNm.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (5)")
Supported Preview File Type:
- Audio types: mp3,flac,ogg,m4a,wav,opus
- Video types:mp4,mkv,avi,mov,rmvb,webm,flv
- Image types:jpg,tiff,jpeg,png,gif,bmp,svg,ico,swf,webp
- Documents:doc,docx,xls,xlsx,ppt,pptx,pdf
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (6)](https://p.51sec.org/file/netsec/2022/12/chrome_DVbXOQEXnt.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (6)")
Portainer Deployment
All are straighforward settings. For image, you can use stable one:xhofe/alist:latest or Dev one:xhofe/alist:main
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (7)](https://p.51sec.org/file/netsec/2022/12/chrome_pnboVtF1Bp.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (7)")
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (8)](https://p.51sec.org/file/netsec/2022/12/chrome_KQCFiqT8wK.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (8)")
The initial password can directly get it by clicking Container list page's log icon:
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (9)](https://p.51sec.org/file/netsec/2022/12/chrome_1GJEvBWZO0.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (9)")
Deploy it in Replit.com
Warning: Replit has blacklist alist program and it will not allow to install in replit environment anymore. Here is a workaround to use it.
Even with this workaround, your saved storage data might still face a lost risk.
1. login into https://replit.com/
2. create a new Repl, using template bash
3. Change the content in main.sh file to following
Basically, change alist name to something different such as a , in my this example:
./a server![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (10)](https://i.imgur.com/C6RySHJ.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (10)")
4. From shell console, type following commands:
wget https://gd.51sec.org/0:/Program/a.tar.gztar -zxvf a.gz./a server5. from the console output, find the password
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (11)](https://i.imgur.com/sI1rHiA.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (11)")
6. Open the website using the url . Login using the admin and password you found from previous step
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (12)](https://i.imgur.com/mCVAkYK.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (12)")
7. Use your own domain and https certs
8. Use uptimerobot to moniter it for keeping it not sleeping
PaaS To Deploy Alist
The initial password refer to logs.
Notes:
There are some issues for Heroku deployment. Here is one FAQ post mentions some issues: https://elements.heroku.com/buttons/cqchenqin/alist-heroku
Free Database for PaaS Deployment
You may need to use another remote MySQL database as instance restarts will lose data. Recommended Free MySQL Databases:
Add Storages
Local
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (13)](https://p.51sec.org/file/netsec/2022/12/chrome_loheLzVVxJ.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (13)")
More please check my another post for advanced usage of AList:
Windows Deployment
Downloand Windows Package from Release page:
- https://github.com/alist-org/alist/releases
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (14)](https://p.51sec.org/file/netsec/2022/12/chrome_sit5xPbeqg.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (14)")
Run from command line to start AList:
C:\Users\admin>cd \alist-windows-amd64C:\alist-windows-amd64>dir Volume in drive C has no label. Volume Serial Number is BC7D-56BE Directory of C:\alist-windows-amd6412/27/2022 10:59 PM <DIR> .12/27/2022 10:59 PM <DIR> ..11/22/2022 09:01 AM 11,446,272 alist.exe 1 File(s) 11,446,272 bytes 2 Dir(s) 155,723,272,192 bytes freeC:\alist-windows-amd64>alistA file list program that supports multiple storage,built with love by Xhofe and friends in Go/Solid.js.Complete documentation is available at https://alist.nn.ci/Usage: alist [command]Available Commands: admin Show admin user's info cancel2fa Delete 2FA of admin user completion Generate the autocompletion script for the specified shell help Help about any command lang Generate language json file restart Restart alist server by daemon/pid file server Start the server at the specified address start Silent start alist server with `--force-bin-dir` stop Stop alist server by daemon/pid file version Show current version of AListFlags: --data string config file (default "data") --debug start with debug mode --dev start with dev mode --force-bin-dir Force to use the directory where the binary file is located as data directory -h, --help help for alist --no-prefix disable env prefixUse "alist [command] --help" for more information about a command.C:\alist-windows-amd64>alist serverINFO[2022-12-27 22:59:34] reading config file: data\config.jsonINFO[2022-12-27 22:59:34] config file not exists, creating default config fileINFO[2022-12-27 22:59:34] load config from env with prefix: ALIST_INFO[2022-12-27 22:59:34] init logrus...INFO[2022-12-27 22:59:34] Successfully created the admin user and the initial password is: i3OvsBbuINFO[2022-12-27 22:59:39] Aria2 not ready.INFO[2022-12-27 22:59:39] start server @ 0.0.0.0:5244You will be prompted to allow firewall to access alist.exe file.
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (15)](https://p.51sec.org/file/netsec/2022/12/cmd_r7u2CHdFsu.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (15)")
Unfortunately , directlly use your browse to access 0.0.0.0:5244 wont work.
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (16)](https://p.51sec.org/file/netsec/2022/12/chrome_wcZpvwl3MU.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (16)")
But using http://127.0.0.1:5244/ works
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (17)](https://p.51sec.org/file/netsec/2022/12/chrome_qNWFpxZGgH.png "[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (17)")
To make "alist.exe server" command run when system reboots, you can add following startup code into start up folder (shell:startup).
Startup Code:
Set ws = CreateObject("Wscript.Shell")ws.run "alist.exe server",vbhideNote:https://www.bilibili.com/video/BV1ut4y1u7SM/
Videos
Using Docker Run to Deploy:
Using Portainer to Deploy & Deploy into Windows
Online AList Sites
Some collected AList sites as demo:
- https://store.vvhan.com/
- My Demo:https://alist.51sec.org Just in case you are interesting on how it looks like after logged in, here is a sharing folder 's read access only account:user: testuser1 pass: TestUser1!
- list.51sec.org - Deployed into Replit
Issues
So far, following issu has been found and looking for a solution:
- PDF preview issue
![[5 Mins Docker] A Free File List App for Multiple Cloud Storages - Alist (Replit) (2024)](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/h8AAvMB+NzmkbcAAAAASUVORK5CYII=)