# AListLiteAndroid

**Repository Path**: leohaovip/AListLiteAndroid

## Basic Information

- **Project Name**: AListLiteAndroid
- **Description**: AList 即装即用 · 一款专为 Android 打造的 AList 安卓服务端 | 支持 Android 5.0
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 0
- **Created**: 2024-12-23
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

<p align="center"><a href="https://github.com/LeoHaoVIP/AListLiteAndroid" target="_blank" rel="noopener noreferrer"><img width="100" src="./README/ic_launcher.png" alt="yoga logo"></a></p>
    <h3 align="center">AListLite | 在 Android 上一键启动 OpenList 服务</h3>
<h5 align="center">AListLite 支持服务一键启动、状态栏磁贴、后台常驻、开机自启和高级配置等功能，界面简洁，上手简单。</h5>
<p align="center">
    <a href="https://github.com/LeoHaoVIP/AListLiteAndroid/releases" style="color: white" target="_blank"
       rel="noopener noreferrer">
        <img alt="release" src="https://img.shields.io/github/v/release/LeoHaoVIP/AListLiteAndroid"/>
    </a>
    <img alt="platform" src="https://img.shields.io/badge/platform-android-f079f4.svg"/>
    <img alt="language" src="https://img.shields.io/badge/language-java|go-green.svg"/>
</p>
<p align="center">
    <a href="https://alist.nn.ci/zh/guide/drivers/common.html" style="color: white" target="_blank"
       rel="noopener noreferrer">
        <img src="https://img.shields.io/badge/挂载教程-338888.svg"/>
    </a>
    <a href="https://github.com/LeoHaoVIP/AListLiteAndroid/issues" style="color: white" target="_blank"
       rel="noopener noreferrer">
        <img src="https://img.shields.io/badge/问题反馈-00ccff.svg"/>
    </a>
    <a href="mailto:zhaowenhao2867@outlook.com" style="color: white" target="_blank"
       rel="noopener noreferrer">
        <img src="https://img.shields.io/badge/联系开发者-339966.svg"/>
    </a>
</p>


# AListLite

[AListLite](https://github.com/LeoHaoVIP/AListLiteAndroid) 是一款支持运行 [AList](https://alistgo.com/zh/) 服务（现已迁移到 [OpenList](https://oplist.org/zh/)）的 Android 应用，相对于教程 [BV1ex4y157xJ](https://www.bilibili.com/video/BV1ex4y157xJ) 中的描述，用户无需借助安装 Termux 即可实现在 Android 设备（手机/电视）上使用 AList 服务。

[AListLite](https://github.com/LeoHaoVIP/AListLiteAndroid) 支持服务一键启动、状态栏磁贴、后台常驻、开机自启和高级配置等功能，界面简洁，上手简单。

<p align="center"><img width="120" src="./README/rewardcode.png" alt="yoga logo"></p>
<h5 align="center">Buy Me a Coffee!</h5>

## Compatibility

[AListLite](https://github.com/LeoHaoVIP/AListLiteAndroid) 集成了 Golang 实现的 [OpenList](https://github.com/OpenListTeam/OpenList)，适配 `x86_64`、`x86`、`arm64-v8a`、`armeabi-v7a` CPU 架构，可运行在主流 Android 版本上（最低支持 Android 5.0 版本 | SDK API 21），同时适配移动设备和 TV 设备。

<center class="half">
<img src="./README/demo-devices.png" alt="多设备演示" style="zoom:30%"/>
</center>



## User Manual

### 安装

| 发布平台 | 发布地址                                                     | 备注         |
| -------- | ------------------------------------------------------------ | ------------ |
| GitHub   | https://github.com/LeoHaoVIP/AListLiteAndroid/releases/latest |              |
| Gitte    | https://gitee.com/leohaovip/AListLiteAndroid/releases/latest |              |
| 天翼云盘 | https://cloud.189.cn/t/VfYNZrqYrMzq                          | 访问码：jc08 |

### 启动服务

> ① 服务启动完成后，建议在 PC 端访问服务地址进行后续的 AList 配置
>
> ② 设备本地请访问 http://localhost:5244

点击右上角开关，开启或停止 AList 服务，服务启动成功后将显示 AList 前端页面。

<center class="half">
<img src="./README/main-page.png" alt="APP 主页面" style="zoom:30%"/>
</center>

### 授予权限

> **开机自启说明**
>
> 若要实现 AList 服务开机自启，授予相关权限后，还需要在系统设置中手动开启 APP 的自启动开关。

首次打开 APP 后，软件将申请必要的存储、通知与后台运行权限，权限授予情况可点击软件右上角 `+` 号，进入 `权限配置` 页面查看。

<center class="half">
<img src="./README/permission.png" alt="权限配置页面" style="zoom:30%"/>
</center>

### 修改管理员密码

点击软件右上角 `+` 号，选择 `密码设置` 可修改管理员密码，默认登录信息为 `admin` / `123456`。

<center class="half">
<img src="./README/password-page.png" alt="设定管理员密码" style="zoom:30%"/>
</center>

### 状态栏磁贴

Android N（7.0）及以上版本可在控制栏设置 AListLite 快速启停磁贴，实现无需打开软件，即可快速开启或关闭 AList 服务。

<center class="half">
<img src="./README/tile-service.png" alt="AList 服务磁贴" style="zoom:30%"/>
</center>

### 远程访问

点击软件右上角 `+` 号，选择 `远程访问` 可调出远程访问二维码，便于 TV 端用户在移动设备上完成配置操作。

<center class="half">
<img src="./README/remote-access.png" alt="远程访问二维码" style="zoom:20%"/>
</center>

# Update

对于已安装 APP 的用户，软件每次开启时将自动检查更新。用户也可点击软件右上角 `+` 号，选择下方 `检查更新` 手动获取新版本发布情况。

<center class="half">
<img src="./README/update-page.png" alt="版本信息页面" style="zoom:30%"/>
</center>


# Advanced

为最大程度匹配 AList 本身的能力，AListLite 允许用户手动修改 AList 配置文件。用户可点击软件右上角 `+` 号，选择 `高级配置` 进入配置文件修改页面，实现自定义端口、HTTPS 设置、数据库配置等个性化需求。

> 注意：错误的配置可能导致服务无法启动，请谨慎操作！

<center class="half">
<img src="./README/config-manage.png" alt="高级配置管理页面" style="zoom:30%"/>
</center>

# Support

Email: <zhaowenhao2867@outlook.com>

Bilibili: [AListLite | 一款支持运行 AList 服务的 Android 应用](https://www.bilibili.com/video/BV1PA4m1G7Ui)