阿里云盘列表AList部署教程
简介
AList是一款阿里云盘的目录文件列表程序,后端基于golang
最好的http
框架gin
,前端使用vue
和ant design
。没有专门学过前端,大佬轻喷😘
测试了一下,在html文件头中加入<meta name="referrer" content="never">
,目前可以避开防盗链检测,后续未知。来自https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy , 若要使用程序作为图床,需要在img标签中加入referrerPolicy="no-referrer"
。由于阿里云盘加入了防盗链机制,目前所有不走服务器的预览均已失效,正在寻求解决办法,参考:https://developer.aliyun.com/article/59499 可能的方案:禁止浏览器的referer头,参考https://browsernative.com/http-referer-control-chrome/
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>AccessDenied</Code>
<Message>You are denied by bucket referer policy.</Message>
<RequestId>5FFE96B83760853537D449EB</RequestId>
<HostId>bj29.cn-beijing.data.alicloudccp.com</HostId>
<BucketName>ccp-bj29-bj-1592982087</BucketName>
</Error>
本程序仅供学习研究使用!!!发现任何bug请提issue,部署上遇到问题欢迎添加我的qqi@nn.ci
。
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!
更新的时候后端和前端文件都需要替换!!!!以及补上配置文件新的配置项!!!!
项目地址:
更新
2021.1.22
- 使用阿里云提供的文档预览服务
- 解决阿里云盘防盗链问题
- 修复观看视频时返回播放器不销毁的bug
- 优化了一些代码
2021.1.12
- 修复安卓微信端左侧被裁切的问题
- 更新dplayer至最新版本
- 优化跨域/信任域名,隐藏了一些配置信息
- 修改meta信息中的语言为中文(不会弹出翻译)
- 优化版本号比较
2021.1.6
- 前端了去除了map文件,减小了打包后的文件体积,仅有原来的1/3
- 增加了文档文件的预览,使用了kkFileView,部署在比较辣鸡的机器上,有能力可以自行搭建
- 增加了几乎所有文本文件的预览,可自行修改需要预览的后缀
- 可自定义视频自动播放
- 修改了移动端(宽度小于600px)时的视频高度
- 更换了二维码接口,原来的有时候特别慢
2020.12.31
- 自定义脚本
- 移动端文件列表优化
- 二维码分享(只在宽度小于600px的设备上显示)
- 去除对文件请求的缓存
- 更新提醒(可在配置文件中关闭)
2020.12.29
- 引入缓存,大幅优化了响应速度
2020.12.28
- 自定义页面底部链接
- 301跳转文件直链
- 体验优化
- 隐藏.password密码文件
- json绑定出错问题
预览
- https://alist.nn.ci (稳定版本,即Github Release的最新版本)
- https://alist.now.sh (开发版本,随着GitHub提交更新)
如何部署
首先第一步,Star本项目AList(bushi
获取refresh_token
为什么不直接使用access_token
,因为有效期只有两小时。
经Syc大佬的提醒,获取refresh_token
其实没这么麻烦,我们只需要登陆阿里云盘之后,打开开发者工具,切换到Application
选项卡,点开Local storage
,会有一个token
项,点开就可以看到refresh_token
了,此处感谢一下Syc大佬。
# 过时内容
> 刚想起来忘记去掉自己博客的链接了😂,下个版本去掉,或者自定义
> 如果启动时遇到`json:cannot unmarshal number into Go...`的问题,请先尝试使用[开发版本][9]
首先第一步需要获取`refresh_token`,这也是部署过程中最麻烦的一步。我尝试过直接通过login_token去登陆获取,但是会得到这个错误:
> User not authorized to operate on the specified APIs you need access by oauth.
知道如何破解的大佬,欢迎发起pr😀或者在issues中告诉我。所以,现在还是先获取`refresh_token`吧。
- 进入阿里云盘登录页,打开开发者工具,并开启Preserve log:
![打开控制台][10]
- 选择一种方式登录,我这里选择的是扫码其他的应该也差不多
- 找到`https://auth.aliyundrive.com/v2/oauth/token_login`这个请求并复制请求中的token
![获取login_token][11]
- 这是我们就需要一个模拟请求插件,这里我使用的是[Postwomen][12],用刚刚复制的数据再次请求这个接口
![token_login][13]
- 然后我们就会得到一个goto的链接(在控制台就是看不到,是真滴奇怪,如果可以看到就没这么麻烦了),链接中有个code参数,我们再次复制它,然后用这个code请求`https://websv.aliyundrive.com/token/get`这个接口,注意这个code只能使用一次,所以这里没有打码了😁
![token_get][14]
- 大功告成,终于得到这个`refresh_token`了,保存好它,然后就可以开始接下来的步骤了。
部署
使用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: #自定义js脚本,可以是脚本的链接,也可以直接是脚本内容,如document.querySelector('body').style="background-image:url('https://api.mtyqx.cn/api/random.php');background-attachment:fixed"
autoplay: true #视频是否自动播放
preview:
url: https://view.alist.nn.ci/onlinePreview?url= #extensions中包含的后缀名预览的地址,默认使用了kkFileView,可以自行搭建
pre_process: [base64,encodeURIComponent] #对地址的处理,支持base64,encodeURIComponent,encodeURI
extensions: [] #使用上面的url预览的文件后缀
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] #要预览的文本文件的后缀,可以自行添加
max_size: 5242880
server:
port: "5244" #程序监听端口
search: false
static: dist
site_url: '*' #建议直接填*,若有信任域名要求,可填写其他具体域名,逗号分割
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进行查看。
自定义静态资源服务器
与使用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-要设置的密码
的文件或者文件夹就可以了。 - 如何设置根目录?
修改配置文件中的ali_drive.root_folder
为想要设置的文件夹的file_id
即可。 - 如何自定义网页底部链接?
修改配置文件中的footer_text
和footer_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。
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 appreciation button below 。Thanks:
- zsbai :请一杯奶茶🥤
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。
autoplay: true
url: https://view.alist.nn.ci/onlinePreview?url= #extensions中包含的后缀名预览的地址,默认使用了kkFileView,可以自行搭建 pre_process: [base64,encodeURIComponent] #对地址的处理,支持base64,encodeURIComponent,encodeURI extensions: [] #使用上面的url预览的文件后缀 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] #要预览的文本文件的后缀,可以自行添加 max_size: 5242880preview:
老板,想问下,我这里无法预览pdf、work,我改了这里就报错了,麻烦帮忙看下哪里改错了。
预览pdf是不需要修改配置文件中preview部分的啊 只要是最新的版本就可以。work文件应该是没有做预览支持的,没有接触过这种文件。
移动端下载文件失败,不知道是不是个例,电脑端倒是没问题
ios端safari测试没有问题的啊,其他的不太清楚~
safari是没问题,部分浏览器如:小米自带浏览器,ios Alook等对阿里云盘直链下载失败,用Teambition直链的时候倒没有出现这个问题,有点迷...不过这是云盘本身的事了,使用时偶然发现的问题
大佬能编译个win能用的么
抱歉 好像只有owner可以下载Artifacts,已经在最新版本release中加入了Windows版本:https://github.com/Xhofe/alist/releases/download/v0.1.6/alist_0.1.6_windows_amd64.zip
文档中有写哦::(哈哈) Github Actions中每次commit有编译windows版本,最新的是https://github.com/Xhofe/alist/actions/runs/503003954,下面有alist_windows_amd64就是Windows版本的。
请教大佬,宝塔面板上弄得,打开网站后不显示文件列表 提示:The origin is not in the site_url list, please configure it correctly
配置文件server.site_url填 '*' 就可以了。
因为眼睛不好,所以需要使用键盘来操作网页。