AList User Guide and Customization

website·Indexed 30 days ago

https://anwen-anyi.github.io/

Comprehensive instructions for installing and configuring AList on Windows, Linux, Docker, and Android via Termux. Includes guides on adding cloud storage, using the AList API, implementing SSO single sign-on with Casdoor, and advanced frontend customization (beautifying headers and content). Also provides detailed compilation tutorials for Windows and Linux, including GitHub Actions workflows and online debugging for frontend development.

Tokens
24.7K
Snippets
111
Records
178
Agent score
74%

What's inside AList

  1. Overview of AList Download Proxy URL

    The 'Download Proxy URL' field in AList storage mount configurations allows you to route downloads through a proxy instead of using the local server for transmission. If this field is left empty, AList defaults to local transmission. There are two primary ways to implement this proxy: using Cloudflare Workers or a standalone binary proxy.
  2. Overview of SSO integration via Casdoor

    AList supports Single Sign-On (SSO) integration through Casdoor. Casdoor acts as an identity aggregator, allowing AList to connect to dozens of third-party providers including GitHub, Google, Microsoft, GitLab, Discord, and various regional services like QQ, DingTalk, and WeChat.
  3. Implement short links for AList using YOURLS

    AList does not have a built-in short link feature. To avoid sharing long, URL-encoded links (especially those with Chinese characters or security signatures), you can deploy YOURLS as a standalone short link service to map long AList URLs to short, manageable aliases.
  4. Install AList on Android using Termux

    To run AList on Android, you must use the Termux terminal emulator. It is recommended to use the F-Droid or GitHub versions of Termux. For most modern phones (last 4-5 years), the arm64-v8a architecture is recommended.
    # 1. Replace the package source to Tsinghua mirror for faster downloads
    sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list
    apt update && apt upgrade
    
    # 2. Install AList using the one-click script
    pkg install alist -y
  5. Manually install AList on Linux

    Follow these steps to manually install AList on a Linux server. This method is recommended for users who need to modify the uploaded program.

    1. Download the appropriate architecture binary from the GitHub releases page.
    2. Troubleshooting GLIBC errors: If you encounter errors such as lib64/libc.so.6: version 'GLIBC_2.28' not found or accept: function not implemented, download the musl version of the package instead (e.g., use alist-linux-musl-amd64.tar.gz instead of alist-linux-amd64.tar.gz).
    3. Upload the archive to the server and extract it.
    4. Navigate into the extracted folder using the cd command.
    5. Grant execution permissions to the binary.
    6. Run the binary to start AList.
    # Extract the downloaded file to get the executable
    tar -zxvf alist-xxxx.tar.gz
    
    # Grant execution permissions
    chmod +x alist
    
    # Start AList
    ./alist
  6. Use Plausible Analytics as a privacy-focused Google Analytics alternative

    Plausible is an easy-to-use, privacy-preserving alternative to Google Analytics for website statistics.
    # Source code available at: https://github.com/plausible/analytics
  7. Monitor application uptime with Uptime Kuma

    Uptime Kuma is a tool used for monitoring the status and availability of applications.
    # Source code available at: https://github.com/louislam/uptime-kuma
  8. Deploy Immich for self-hosted photo and video management

    Immich provides a self-hosted solution for managing photos and videos.
    # Source code available at: https://github.com/immich-app/immich
  9. Understand QQ architecture versions (Legacy vs NT)

    QQ versions are categorized by their underlying architecture. Legacy versions use a non-NT architecture, while newer versions use the NT architecture based on Electron. Note that App Store versions transitioned to the Electron architecture starting from version v8.9.63.
  10. Implement Identity and Access Management with Casdoor

    Casdoor is an Identity and Access Management (IAM) and Single Sign-On (SSO) platform.
    # Source code available at: https://github.com/casdoor/casdoor
  11. Use AList for multi-cloud drive mounting

    AList is a network disk list program that allows users to mount and manage multiple cloud storage services in one interface.
    # Source code available at: https://github.com/AlistGo/alist