简介

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绑定出错问题

预览

alist预览

如何部署

首先第一步，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 ：请一杯奶茶🥤
文章目录
文章目录