首页 教程,项目

简介

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

暂时不会有太大的更新了,等阿里云盘正式发布之后再进行相关优化。更新计划:https://www.notion.so/Todo-3fdc2b0deec340e9aa9d86e6f603df72,有好的建议可以评论或在issue中告诉我。

测试了一下,在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...`的问题,请先尝试使用[开发版本][7]

首先第一步需要获取`refresh_token`,这也是部署过程中最麻烦的一步。我尝试过直接通过login_token去登陆获取,但是会得到这个错误:
> User not authorized to operate on the specified APIs you need access by oauth.
知道如何破解的大佬,欢迎发起pr?或者在issues中告诉我。所以,现在还是先获取`refresh_token`吧。
- 进入阿里云盘登录页,打开开发者工具,并开启Preserve log:
![打开控制台][8]
- 选择一种方式登录,我这里选择的是扫码其他的应该也差不多
- 找到`https://auth.aliyundrive.com/v2/oauth/token_login`这个请求并复制请求中的token
![获取login_token][9]
- 这是我们就需要一个模拟请求插件,这里我使用的是[Postwomen][10],用刚刚复制的数据再次请求这个接口
![token_login][11]
- 然后我们就会得到一个goto的链接(在控制台就是看不到,是真滴奇怪,如果可以看到就没这么麻烦了),链接中有个code参数,我们再次复制它,然后用这个code请求`https://websv.aliyundrive.com/token/get`这个接口,注意这个code只能使用一次,所以这里没有打码了?
![token_get][12]
- 大功告成,终于得到这个`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,然后自行修改配置文件中默认的值
  • 现在的情况应该是,目录下有两个文件alistconf.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_textfooter_url为要设置的内容,或者不填则不会显示。
  • 怎么复制文件直链?
    进入文件预览,可以预览的文件复制按钮在右上角,不可预览的复制按钮在正中间。
  • 修改网站icon?
    替换掉dist目录下的favicon.ico即可。
  • 为什么新上传的文件不显示/删除了的文件还在?
    为了提高响应速度,对文件的列表是有缓存的,默认开启。
  • 如何开关缓存?
    配置文件中的cache.enable设置为truefalse即可,打开会占用更多的内存,但会大幅优化使用体验,默认打开。经测试下载地址是会失效的,所以请自行设置缓存的时间。下个版本将给文件去掉缓存,只缓存文件夹。更新文件的时候可以手动刷新缓存。
  • 如何刷新缓存?
    程序会自动按照配置文件中的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 click this 。Thanks:

  • zsbai :请一杯奶茶?
  • 白鹭
  • 不知名
  • 永胜



文章评论

    anonymous 访客ChromeAndroid
    2021-03-13 5:20   回复

    可以加一个守护进程
    [Unit]
    Description=alist
    After=network.target

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

    [Install]
    WantedBy=multi-user.target

      Xhofe 站长ChromeWindows
      2021-03-13 20:42   回复

      可以可以

    Syc 访客ChromeWindows
    2021-03-5 15:39   回复

    给博主一口亲亲(/≧ω\)

      Xhofe 站长ChromeMac
      2021-03-5 18:30   回复

    qadan 访客ChromeWindows
    2021-03-1 11:26   回复

    修改标题还是不显示,需要重新运行命令吗?
    建议下个版本能添加seo设置,比如关键字描述这些,还有手机版不是太兼容,页面有点乱,程序很好用,UI也好看,加油

      Xhofe 站长ChromeMac
      2021-03-3 19:50   回复

      修改配置文件均是重启应用生效,
      因为是spa,所以不太好做seo。。。只设置首页的关键字描述的话,可以直接在index.html中手动添加。

    xu 访客ChromeWindows
    2021-02-25 11:05   回复

    如何更改主题?还有就是能不能加入图片略缩图展示

      Xhofe 站长ChromeMac
      2021-02-25 19:08   回复

      更改主题样式可以下载alist-web直接修改。现在使用的都是ant-design的样式。图片缩略图也重构后加入吧。。

    无酒 访客ChromeWindows
    2021-02-24 21:17   回复

    url可否设置按目录结构展示?

      Xhofe 站长ChromeMac
      2021-02-25 19:05   回复

      等正式发布之后重构可以。

    Wayne 访客ChromeMac
    2021-02-24 9:12   回复

    后续能否增加搜索功能?

      Xhofe 站长ChromeMac
      2021-02-24 12:21   回复

      现在有官方提供的搜索接口,但是还没有使用起来,因为会使根目录与加密都失效。计划阿里云盘正式发布之后使用sqlite3自建目录重构一下,到时候会写一个支持加密与指定目录的搜索。

目录