alliot/alist repository overview

⁠OpenAList

中文⁠ | English

⁠Introduction

OpenAList is a community-driven fork of Alist⁠ (based on v3.45.0), aiming to provide a more secure, customizable, and user-friendly file listing and management solution.

• Document site: http://alist.iots.vip/⁠

⁠Features

• 🗂️ Supports multiple mainstream cloud drives and local storage
• 🔒 Safer token acquisition (removed insecure original APIs)
• 🛠️ UI and driver enhancements
• 🚀 Continuous integration Docker image, ready to use
• 🧩 Easy for secondary development and customization
• 📝 Compatible with most original Alist features

⁠Quick Start

⁠Using Docker

docker run -d \
  --name=alist \
  -p 5244:5244 \
  -v /path/to/data:/opt/alist/data \
  alliot/alist:latest

⁠Local Deployment

1. Clone the repository:

   git clone https://github.com/AlliotTech/openalist.git
   cd openalist
   

   Copy
2. Build and run:

   ./build.sh
   ./alist server
   

   Copy

⁠Configuration

• Config file path: data/config.json
• Strongly recommend using offline/local tools to obtain cloud drive tokens for security
• For OneDrive: use alist-onedrive-api⁠ or mount WebDAV via rclone

⁠FAQ

• Q: How to securely obtain cloud drive tokens? A: Use local or offline tools, never use untrusted online services.

• Q: The image/program fails to start? A: Check for port conflicts, data directory permissions, etc.

• Q: How to report bugs or suggestions? A: Please submit via GitHub Issues⁠.

⁠Contributing

We welcome contributions! Please read CONTRIBUTING.md⁠ and submit a Pull Request.

⁠Images & Related Repositories

• openalist⁠
• openalist-web⁠
• openalist-docs⁠

⁠Acknowledgments

• Original Alist Project⁠
• All open-source contributors

⁠More

• AlistGo/alist/issues/8649⁠
• AlistGo/alist/issues/8651⁠