首页 教程,项目

简介

AList是一款阿里云盘的目录文件列表程序,后端基于golang最好的http框架gin,前端使用vueant design。没有专门学过前端,大佬轻喷😘

点击链接加入群聊【Alist使用交流】:https://jq.qq.com/?_wv=1027&k=OVPJcv2b
或搜索群号:920516758
更新计划:https://www.notion.so/Todo-3fdc2b0deec340e9aa9d86e6f603df72,有好的建议可以评论或在issue中告诉我。

本程序仅供学习研究使用!!!发现任何bug请提issue,部署上遇到问题欢迎加群交流。
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!第一次启动需要网页底部rebuild!!!
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!第一次启动需要网页底部rebuild!!!
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!第一次启动需要网页底部rebuild!!!

项目地址:

更新

2021.3.31

  • 优化路径栏
  • 修复了因为Referer导致不能下载的问题(122cygf
  • 增加了视频转码选项
  • 图片缩略图预览
  • 修复了json文件无法预览的bug

2021.3.17

本次更新需要修改配置文件,更新之后/首次运行都需要手动rebuild一下。

  • 支持多盘
  • 直链url密码哈希
  • 修复不需要密码的文件复制直链也会携带密码的bug
  • 数据库支持mysql
  • 修复从文件返回目录Readme不更新的bug
  • 重建目录时遮罩,优化体验
  • 支持flv视频(部分浏览器可能不支持,详见https://github.com/Bilibili/flv.js/

2021.3.13

  • 后端引入sqlite3,列表部分不再依赖api,提高响应速度
  • 支持搜索功能
  • 前端使用vue3+ts重构
  • url支持按照目录结果展示
  • 音乐播放支持列表
  • 支持隐藏文件夹
  • 更好的密码支持
  • 更早的更新:https://www.nn.ci/archives/alist-v0.html

预览

alist预览

如何部署

首先第一步,Star本项目AList(bushi

获取refresh_token

web端token已失效,请参考这个issue通过手机端抓包/查找日志(/data/media/0/Android/data/com.alicloud.databox/files/logs/trace/)来获取refresh_token。
为什么不直接使用access_token,因为有效期只有两小时。经Syc大佬的提醒,获取refresh_token其实没这么麻烦,我们只需要登陆阿里云盘之后,打开开发者工具,切换到Application选项卡,点开Local storage,会有一个token项,点开就可以看到refresh_token了,此处感谢一下Syc大佬。

请输入图片描述

部署

使用gin作为静态资源服务器

  • 前往AList Release下载对应系统的程序,解压得到一个示例配置文件和一个系统名称文件夹里面包含运行文件alist
  • 前往AList-web下载打包好的前端,解压得到一个dist目录放到alist同级目录下
  • 在同级目录下新建一个配置文件conf.yml,复制以下内容到该文件中,或直接使用示例配置文件进行修改
info:
  title: AList #标题
  logo: "" #网站logo 如果填写,则会替换掉默认的
  footer_text: Xhofe's Blog #网页底部文字
  footer_url: https://www.nn.ci #网页底部文字链接
  music_img: https://img.xhofe.top/2020/12/19/0f8b57866bdb5.gif #预览音乐文件时的图片
  check_update: true #前端是否显示更新
  script: #自定义脚本,可以是脚本的链接,也可以直接是脚本内容
  autoplay: true #视频是否自动播放
  preview:
    text: [txt,htm,html,xml,java,properties,sql,js,md,json,conf,ini,vue,php,py,bat,gitignore,yml,go,sh,c,cpp,h,hpp] #要预览的文本文件的后缀,可以自行添加
server:
  address: "0.0.0.0"
  port: "5244"
  search: true
  static: dist
  site_url: '*'
  password: password #用于重建目录
ali_drive:
  api_url: https://api.aliyundrive.com/v2
  max_files_count: 3000
  drives:
  - refresh_token: xxx #refresh_token
    root_folder: root #根目录的file_id
    name: drive0 #盘名,多个盘不可重复,这里只是示例,不是一定要叫这个名字,可随意修改
    password: pass #该盘密码,空('')则不设密码,修改需要重建生效
    hide: false #是否在主页隐藏该盘,不可全部隐藏,至少暴露一个
  - refresh_token: xxx #只有一个盘的话,该段完全可以删除,反之有更多可以继续添加
    root_folder: root
    name: drive1
    password: pass
    hide: false
database:
  type: sqlite3
  dBFile: alist.db
  • 填入最开始获取到的refresh_token,然后自行修改配置文件中默认的值
  • 现在的情况应该是,目录下有两个文件alistconf.yml和一个文件夹dist:
$ tree
.
├── alist
├── conf.yml
└── dist
    ├── favicon.ico
    ├── index.html
    └── static
        ├── css
        │   ├── about.f0b54b1c.css
        │   ├── app.4f0c3e9a.css
        │   └── chunk-vendors.8f913079.css
        ├── img
        │   └── alist.bcb68ba0.png
        └── js
            ├── about.8108f65b.js
            ├── app.34cb39e5.js
            └── chunk-vendors.131f0f41.js

5 directories, 12 files

在该文件夹下面执行下面的命令(Linux)

chmod +x alist
nohup ./alist > log.log 2>&1 &

ok,程序已经跑起来了。你可以cat log.log看看有没有报错。或者访问http://ip:5244进行查看。

守护进程(可选)

vim /usr/lib/systemd/system/alist.service添加以下内容,其中path_alist为alist所在的路径

[Unit]
Description=alist
After=network.target

[Service]
Type=simple
WorkingDirectory=path_alist
ExecStart=path_alist/alist -conf conf.yml
Restart=on-failure

[Install]
WantedBy=multi-user.target

然后systemctl daemon-reload重载配置,现在你就可以使用这些命令来管理程序了:

  • 启动: systemctl start alist
  • 关闭: systemctl stop alist
  • 自启: systemctl enable alist
  • 状态: systemctl status alist

使用mysql(可选)

需要使用utf8mb4编码,修改database部分配置:

database:
  type: mysql
  user: 用户名
  password: 密码
  host: 127.0.0.1
  port: 3306
  name: 数据库名

自定义静态资源服务器

与使用gin作为静态资源服务器操作步骤差不多,不同的地方在于:

  • 下载AList-web的源码,修改.env.production中的VUE_APP_API_URL为具体部署的后端地址,然后yarn && yarn build自行部署
  • conf.yml中的server.site_url填写前端部署的域名或者默认为'*',需要正确填写,否则会报错。
  • 建议直接使用gin作为静态资源服务器,使用nginx的话因为路由使用了history模式(没有#号好看一点),所以还需要设置一下nginx:
location / {
  try_files $uri $uri/ /index.html;
}

参考:https://router.vuejs.org/zh/guide/essentials/history-mode.html

反向代理

程序默认监听5244端口,要实现https访问,需要使用nginx反向代理,在配置文件中加入

    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_redirect off;
        proxy_pass http://127.0.0.1:5244;
    }

常见问题解答

  • 如何给文件夹设置密码?
    在要加密的目录名称后面加上.password-密码,列表中会自动消除后面的密码部分。
  • 如何隐藏文件夹
    在要隐藏的文件夹名称后面加上.hide即可。
  • 如何重建目录树
    点击网页底部的rebuild按钮,输入配置文件中设置的server.password确定即可。
  • 如何设置根目录?
    修改配置文件中的ali_drive.root_folder 为想要设置的文件夹的file_id即可。文件夹的file_id是什么?根目录就是root,其他目录为点进文件夹之后的url中folder/后面那一串
  • 如何自定义网页底部链接?
    修改配置文件中的footer_textfooter_url为要设置的内容,或者不填则不会显示。
  • 怎么复制文件直链?
    点进文件,右上角有复制直链的按钮。
  • 修改网站icon?
    替换掉dist目录下的favicon.ico即可。
  • 为什么新上传的文件不显示/删除了的文件还在?
    列表展示的是本地数据库里的数据,更新文件之后需要重建。
  • 如何更新?
    前端:下载新的打包好的文件,删掉原来的dist文件夹,解压新的dist放入原来的位置即可。后端:pkill alist 停掉老的进程,删除旧的alist,下载新的alist,查看配置文件,补上新的配置项,再次运行即可。
  • 运行显示检查更新之后直接报错?
    可能是无法访问到GitHub的api,可以在命令行后面加上-skip-update跳过检查更新。

Buy me a coffee

If you are using this project and happy with it or just want to encourage me to continue creating stuff,buy me a coffee by click this 。Thanks:

  • zsbai :请一杯奶茶🥤
  • 白鹭
  • 不知名
  • 永胜
  • MFYDev
  • HakimYu
  • Moc̶k̶i̶n̶gbird



文章评论

    Hemikeo 访客ChromeWindows
    5天 前   回复

    /home/runner/work/alist/alist/server/models/file.go:36 record not found
    [0.000ms] [rows:0] SELECT * FROM files WHERE dir = "" AND name = "whx" ORDER BY files.dir LIMIT 1

    解析json[]出错:unexpected end of JSON input
    大佬这个是怎么回事呀

    BY彡阿长 访客ChromeWindows
    6天 前   回复

      Xhofe 站长ChromeLinux
      5天 前   回复

    larry 访客ChromeMac
    6天 前   回复

    非常棒的项目。大佬,请问如何预览html文件啊,像浏览器器打开html一样,目前默认是预览源代码文本

      Xhofe 站长ChromeMac
      6天 前   回复

      直接打开html的话需要中转的,嵌入到网页中应该可以。

        larry 访客ChromeMac
        6天 前   回复

        那该如何嵌入呢,大佬能提供点思路么

          Xhofe 站长ChromeLinux
          5天 前   回复

          使用js嵌入。

    yyy 访客BrowserSystem
    8天 前   回复

    博主什么时候出Windows arm 64版的啊

      Xhofe 站长ChromeMac
      7天 前   回复

      可以自己编译啊 话说win arm64不是可以运行x86_64的嘛

        yyy 访客BrowserSystem
        6天 前   回复

        运行不了,试过了

          Xhofe 站长ChromeLinux
          5天 前   回复

          那 自行编译一下?
          go的编译还是很方便的

            yyy 访客BrowserSystem
            4天 前   回复

            问题是不会啊

    drea 访客ChromeWindows
    8天 前   回复

    大佬 加群几次了,通过下

      Xhofe 站长ChromeMac
      7天 前   回复

      都同意了呀

    chanqi 访客ChromeWindows
    9天 前   回复

    音乐播放列表不能连续播放!!

      chanqi 访客ChromeWindows
      9天 前   回复

      是加密过后的网盘。音乐播放列表不能连续播放!

        Xhofe 站长ChromeLinux
        9天 前   回复

        感谢反馈 确实有这个bug。

    tari 访客ChromeWindows
    9天 前   回复

    疑似发现bug。最新的Release版本(v1.0.2)下,视频的复制链接会下载不了,但如果设置了目录或挂载盘的密码后,也就是链接后带 "?pw=" 这样的视频链接才能下载成功。目前该问题出现在 .mp4视频文件上,其他非视频文件不受影响,如: .php .css等

      Xhofe 站长ChromeLinux
      9天 前   回复
        tari 访客ChromeWindows
        8天 前   回复

        演示站的也没问题,,,看到有人搭的网站视频下载也有这个问题

    爱克狮 访客ChromeAndroid
    9天 前   回复

    针不戳,win搭建成功了,很实用方便
    问一下作者,这种应该是存在封号或者账号被阿里做限制的可能性的吧

      Xhofe 站长ChromeLinux
      9天 前   回复

      有可能的,有一个日ip过好几万的兄弟就被封号了。。

      爱克狮 访客ChromeAndroid
      9天 前   回复

      请作者喝杯茶

目录