简介
AList是一款阿里云盘的目录文件列表程序,后端基于golang
最好的http
框架gin
,前端使用vue
和ant design
。没有专门学过前端,大佬轻喷😘
本程序仅供学习研究使用!!!发现任何bug请提issue,部署上遇到问题欢迎添加我的qq
i@nn.ci
。
项目地址:
原贴:https://www.nn.ci/archives/alist.html
更新
2020.12.31
- 自定义脚本
- 移动端文件列表优化
- 二维码分享(只在宽度小于600px的设备上显示)
- 去除对文件请求的缓存
- 更新提醒(可在配置文件中关闭)
2020.12.29
- 引入缓存,大幅优化了响应速度
2020.12.28
- 自定义页面底部链接
- 301跳转文件直链
- 体验优化
- 隐藏.password密码文件
- json绑定出错问题
预览
如何部署
首先第一步,Star本项目AList(bushi
获取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 #网站名称,如果填写,则会替换掉默认的
- site_url: https://alist.nn.ci #网站地址,前后端分离时必须正确填写
- backend_url: https://alist.nn.ci #后端地址,用于文件直链复制,必填!!
- logo: #网站logo,如果填写,则会替换掉默认的
- footer_text: "Xhofe's Blog" #网页底部文字
- footer_url: https://www.nn.ci #网页底部文字链接
- music_img: https://img.oez.cc/2020/12/19/0f8b57866bdb5.gif #预览音乐文件时的图片
- check_update: true #前端是否显示更新
- script: #自定义js脚本,可以是脚本的链接,也可以直接是脚本内容,如document.querySelector('body').style="background-image:url('https://api.mtyqx.cn/api/random.php');background-attachment:fixed"
- server:
- port: "5244" #程序监听端口
- search: false
- static: dist
- cache:
- enable: true #是否开启缓存
- expiration: 60 #缓存失效时间(单位:分钟)
- cleanup_interval: 120 #清理失效缓存间隔
- refresh_password: password #手动清理缓存密码
- ali_drive:
- api_url: https://api.aliyundrive.com/v2
- root_folder: root #根目录
- refresh_token: #必填!!!
- max_files_count: 3000 #一次性最大文件数量
- 填入最开始获取到的
refresh_token
,然后自行修改配置文件中默认的值 - 现在的情况应该是,目录下有两个文件
alist
、conf.yml
和一个文件夹dist
,在该文件夹下面执行下面的命令(Linux)
- chmod +x alist
- nohup ./alist > log.log 2>&1 &
ok,程序已经跑起来了。你可以cat log.log
看看有没有报错。或者访问http://ip:5244进行查看。
自定义静态资源服务器
与前后端不分离操作步骤差不多,不同的地方在于:
- 下载AList-web的源码,修改
.env.production
中的VUE_APP_API_URL
为具体部署的后端地址(带后面的/api/
),然后yarn && yarn build
自行部署 conf.yml
中的info.site_url
填写前端部署的域名,一定要正确填写,否则会报跨域的错误。
反向代理
程序默认监听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-要设置的密码
的文件或者文件夹就可以了。 - 如何设置根目录?
修改配置文件中的ali_drive.root_folder
为想要设置的文件夹的file_id
即可。 - 如何自定义网页底部链接?
修改配置文件中的footer_text
和footer_url
为要设置的内容,或者不填则不会显示。 - 怎么复制文件直链?
进入文件预览,可以预览的文件复制按钮在右上角,不可预览的复制按钮在正中间(backend_url
必须设置正确)。 - 修改网站icon?
替换掉dist
目录下的favicon.ico
即可。 - 为什么新上传的文件不显示/删除了的文件还在?
为了提高响应速度,对文件的列表是有缓存的,默认开启。 - 如何开关缓存?
配置文件中的cache.enable
设置为true
或false
即可,打开会占用更多的内存,但会大幅优化使用体验,默认打开。经测试下载地址是会失效的,所以请自行设置缓存的时间。下个版本将给文件去掉缓存,只缓存文件夹。更新文件的时候可以手动刷新缓存。 - 如何刷新缓存?
程序会自动按照配置文件中的cache.cleanup_interval
自动清理过期缓存,如需手动刷新,手动访问后端地址/cache/配置文件中设置的刷新密码
,如https://alist.nn.ci/cache/alist
。 - 如何更新?
前端:下载新的打包好的文件,删掉原来的dist文件夹,解压新的dist放入原来的位置即可。后端:pkill alist
停掉老的进程,删除旧的alist
,下载新的alist,查看配置文件,补上新的配置项,再次运行即可。 - 要安装
Windows
版本?
自行编译,或者在Github Actions可以找到每次提交的build。