Docker-AList(云盘直链)

[AList](https://al.nn.ci) 是一个可以获取网盘直链的工具，在配合 Aria2、IDM、迅雷 等这些工具，下载速度可以拉满
仅 `管理员` 拥有完整的权限，后加用户只能给予基础的操作权限

**相关链接：**
- AList：https://al.nn.ci/
- Doc：https://alist.nn.ci/zh/
  - v2版：https://alist-doc.nn.ci/docs/intro/
  - 配置文件：https://alist.nn.ci/zh/config/configuration.html
  - 反向代理：https://alist.nn.ci/zh/guide/install/reverse-proxy.html
    - 反向代理_子地址：https://alist.nn.ci/zh/faq/howto.html#%E5%A6%82%E4%BD%95%E5%AF%B9%E5%AD%90%E7%9B%AE%E5%BD%95%E8%BF%9B%E8%A1%8C%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86
- Discussions：https://github.com/AlistGo/alist/discussions
- GitHub：https://github.com/AlistGo/alist
- Docker：https://hub.docker.com/r/xhofe/alist
  - 预装 Aria2：https://hub.docker.com/r/xhofe/alist-aria2

## Docker 版
```bash
# 稳定版
docker run -d --name=alist --restart=unless-stopped -v ${PWD}:/opt/alist/data -p 5244:5244 xhofe/alist:latest

# 测试版
docker run -d --name=alist --restart=unless-stopped -v ${PWD}:/opt/alist/data -p 5244:5244 xhofe/alist:main

docker logs alist  # 查看日志(-f 实时)
docker exec -it alist ./alist admin random  # 设置密码为随机码
docker exec -it alist ./alist admin set <新密码>  # 设置密码为指定密码
```
访问地址：`http://<IP>:5244`
默认帐号：`admin`，密码首次启动随机生成并输出到日志

## docker-compose 版
```bash
mkdir -p alist  # 创建所需文件夹
nano docker-compose.yml
docker-compose up -d  # 拉取并部署

docker-compose logs  # 查看日志(-f 实时)
docker-compose exec -it alist ./alist admin random  # 设置密码为随机码
docker-compose exec -it alist ./alist admin set <新密码>  # 设置密码为指定密码
```
`docker-compose.yml`
```yaml
services:
  alist:
    # image: 'xhofe/alist:latest'  # 稳定版
    # image: 'xhofe/alist:main'  # 测试版
    image: 'xhofe/alist:latest-ffmpeg'  # 稳定版+ffmpeg
    # image: 'xhofe/alist:main-ffmpeg'  # 测试版+ffmpeg
    container_name: alist  # 自定义容器名称
    restart: unless-stopped  # 非手动停止则自动重启
    environment:
      PUID: 0  # 用户ID
      PGID: 0  # 组ID
      UMASK: 022  # 文件权限
      # SITE_URL: https://alist.918178.xyz:8443  # 站点URL(也可配置文件)
    ports:
      - 5244:5244  # 对外端口
    volumes:
      - ./alist:/opt/alist/data  # 数据目录
    # networks:
    #   - nginxui_default  # 连接网络名称(也可仅把需要反向代理的额外加入nginx)

# # 加入nginx容器所在网络(否则无法使用nginx代理)
# networks:  # 该项和 services 同级(顶格)
#   nginxui_default:  # 连接网络名称
#     external: true  # 加入网络
#     name: nginxui_default  # 网络的名称
```

## 一键安装
仅支持Linux-x86_64/aarch64平台
```bash
# 默认安装到 /opt/alist
curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install  # 安装，会覆盖之前安装的数据
  # install/update/uninstall = 安装/更新/卸载
# 安装到指定位置
curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install /root  # 安装到指定位置
  # install/update/uninstall = 安装/更新/卸载

./alist admin random  # 随机生成一个密码
./alist admin set <新密码>  # 手动设置密码

# alist 控制
systemctl start alist  # start/stop/status/restart = 启动/关闭/状态/重启
```

## [config.json 配置文件](https://alist.nn.ci/zh/config/configuration.html)
配置文件默认在 `.../data/config.json`
```yaml
# 仅用与参考,不可直接覆盖,注释不可加进去
{
  "force": false, # 是否强制从配置文件读取配置，忽略环境变量
  "site_url": "", # ⭐网站 URL，用于某些功能的正常工作，如缩略图、预览等
  "cdn": "", # CDN 地址，用于加速资源加载，可设置为 npm 或 GitHub CDN 等
  "jwt_secret": "zsil30fXr85hkpWa", # 用于签署 JWT 令牌的密钥
  "token_expires_in": 48, # 用户登录过期时间，单位为小时
  "database": { # 数据库配置
    "type": "sqlite3", # 数据库类型，默认为 sqlite3，也可使用 mysql 或 postgres
    "host": "", # 数据库地址
    "port": 0, # 数据库端口号
    "user": "", # 数据库账号
    "password": "", # 数据库密码
    "name": "", # 数据库库名
    "db_file": "data/data.db", # 数据库文件路径，仅 sqlite3 使用
    "table_prefix": "x_", # 数据库表名前缀
    "ssl_mode": "", # SSL 连接模式，用于 MySQL 或 PostgreSQL
    "dsn": "" # 数据库连接字符串，用于某些数据库类型
  },
  "meilisearch": { # Meilisearch 配置
    "host": "http:#localhost:7700", # Meilisearch 服务地址
    "api_key": "", # Meilisearch API 密钥
    "index_prefix": "" # Meilisearch 索引前缀
  },
  "scheme": { # 协议配置(这里可以配置SSL)
    "address": "0.0.0.0", # 监听地址，默认为 0.0.0.0
    "http_port": 5244, # ⭐HTTP 端口，默认为 5244
    "https_port": -1, # ⭐HTTPS 端口，默认为 -1，设置非 -1 以启用 HTTPS
    "force_https": false, # 是否强制使用 HTTPS 协议
    "cert_file": "", # HTTPS 证书文件路径
    "key_file": "", # HTTPS 证书密钥文件路径
    "unix_file": "", # Unix 监听套接字文件路径
    "unix_file_perm": "" # Unix 监听套接字文件权限
  },
  "temp_dir": "data/temp", # 程序临时目录，默认为 data/temp
  "bleve_dir": "data/bleve", # Bleve 索引数据存放目录
  "dist_dir": "", # 前端文件目录，设置后优先使用该目录下的前端文件
  "log": { # 日志配置
    "enable": true, # 是否开启日志记录功能
    "name": "data/log/log.log", # 日志文件路径和名称
    "max_size": 50, # 单个日志文件的最大大小，单位为 MB
    "max_backups": 30, # 保留的日志备份数量
    "max_age": 28, # 日志文件保存的最大天数
    "compress": false # 是否启用日志文件压缩功能
  },
  "delayed_start": 0, # 程序延时启动时间，单位为秒
  "max_connections": 0, # 同时最多的连接数，默认为 0 即不限制
  "tls_insecure_skip_verify": true, # 是否不检查 SSL 证书
  "tasks": { # 后台任务线程数量配置
    "download": {
      "workers": 5, # 下载任务线程数量
      "max_retry": 1, # 下载任务最大重试次数
      "task_persistant": false # 下载任务是否持久化
    },
    "transfer": {
      "workers": 5, # 上传中转任务线程数量
      "max_retry": 2, # 上传中转任务最大重试次数
      "task_persistant": false # 上传中转任务是否持久化
    },
    "upload": {
      "workers": 5, # 上传任务线程数量
      "max_retry": 0, # 上传任务最大重试次数
      "task_persistant": false # 上传任务是否持久化
    },
    "copy": {
      "workers": 5, # 复制任务线程数量
      "max_retry": 2, # 复制任务最大重试次数
      "task_persistant": false # 复制任务是否持久化
    }
  },
  "cors": { # 跨源资源共享配置
    "allow_origins": [ # 允许的源
      "*"
    ],
    "allow_methods": [ # 允许的请求方法
      "*"
    ],
    "allow_headers": [ # 允许的请求头
      "*"
    ]
  },
  "s3": { # S3 功能配置
    "enable": false, # 是否启用 S3 功能
    "port": 5246, # S3 端口号
    "ssl": false # 是否启用 HTTPS 证书
  },
  "ftp": { # FTP 功能配置
    "enable": false, # ⭐是否启用 FTP 功能
    "listen": ":5221", # ⭐FTP 监听地址和端口
    "find_pasv_port_attempts": 50, # 查找被动模式端口的尝试次数
    "active_transfer_port_non_20": false, # 是否允许主动模式传输端口非 20
    "idle_timeout": 900, # 空闲超时时间，单位为秒
    "connection_timeout": 30, # 连接超时时间，单位为秒
    "disable_active_mode": false, # 是否禁用主动模式
    "default_transfer_binary": false, # 默认是否以二进制方式传输
    "enable_active_conn_ip_check": true, # 是否启用主动连接 IP 检查
    "enable_pasv_conn_ip_check": true # 是否启用被动连接 IP 检查
  },
  "sftp": { # SFTP 功能配置
    "enable": false, # ⭐是否启用 SFTP 功能
    "listen": ":5222" # ⭐SFTP 监听地址和端口
  }
}
```

## [Nginx 配置](https://alist.nn.ci/zh/guide/install/reverse-proxy.html)
```bash
location / {  # 匹配根路径方式
# location /alist/ {  # 匹配子路径方式(需要修改 site_url 配置)
  proxy_pass http://alist:5244;  # AList 服务地址和端口(使用容器名)
  # proxy_pass http://alist:5244/alist/;  # AList 服务子地址和端口(使用容器名)
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 设置 X-Forwarded-For 头，包含原始请求的客户端 IP 地址
  proxy_set_header X-Forwarded-Proto $scheme;  # 设置 X-Forwarded-Proto 头，指示原始请求使用的协议（http 或 https）
  proxy_set_header Host $http_host;  # 设置 Host 头，使用原始请求中的 Host 头
  # proxy_set_header Host $host:$server_port;  # HTTP/3 时使用，包含主机名和端口号
  proxy_set_header X-Real-IP $remote_addr;  # 设置 X-Real-IP 头，包含原始请求的客户端 IP 地址
  proxy_set_header Range $http_range;  # 设置 Range 头，用于支持请求部分资源
  proxy_set_header If-Range $http_if_range;  # 设置 If-Range 头，用于条件性请求部分资源
  proxy_redirect off;  # 关闭代理重定向
  client_max_body_size 20000m;  # 设置允许上传文件的最大大小为 20000 MB
}
```

## [使用说明](https://alist-doc.nn.ci/docs/intro)
修改网盘挂载内容，不要直接 F5刷新页面(有时候并不会更新)，而是使用右侧的 `刷新`

### [添加网盘](https://alist-doc.nn.ci/docs/driver/base)
注意：`添加后就是公开的了`，虽然可以隐藏，但是统一隐藏或是显示无法精确控制每个账户

### Robots.txt(爬虫的配置/规则)
注意，国内基本都不看这个文件的，，，

在 `管理 -> 设置 -> 站点` 中进行配置
```bash
# 允许所有爬虫
User-agent: *  # 所有搜索引擎
Allow: /  # 允许所有路径(允许爬虫)

# 禁止所有爬虫
User-agent: *  # 所有搜索引擎
Disallow: /  # 禁止所有路径(禁止爬虫)
  # Disallow: /NAS/  # 禁止爬取NAS目录
  # Disallow: /NAS1/  # 禁止爬取NAS1目录(支持多条)
```

### [元信息](https://alist.nn.ci/zh/guide/advanced/meta.html)
元信息可以添加如: 隐藏文件/文件夹，加密文件夹，允许指定文件夹写入(账户下的为全局写入权限)，Markdown(可以应用到子文件夹)
在 `管理 -> 元信息` 中进行添加配置

#### 密码
添加密码很简单，直接选择对应目录(仅对目录有效)，然后设置密码即可
- 未勾 应用到子文件夹：知晓子路径可通过URL直接输入子路径方式跳过密码
- 勾选 应用到子文件夹：即便URL输入子路径进入了也会被密码拦着

#### 隐藏文件/文件夹
注意，隐藏目录需要添加两个才能完全隐藏目录，并且无法索引(当然也可索引中排除)
- 隐藏该目录下所有文件(解决索引问题)
  1. 路径：选择想要隐藏的目录
  2. 隐藏：填写 `.*` 并勾上 `应用到子文件夹`
- 隐藏该目录(解决空文件夹还显示问题)
若是隐藏文件，仅需该方式即可，隐藏中填写文件名(若是子目录文件可勾选应用到子文件夹)
  1. 路径：选择想要隐藏目录所在的上级目录
  2. 隐藏：填写目录名称(每行一个)

在 `设置 -> 全局` [隐藏文件](https://alist.nn.ci/zh/config/global.html#%E9%9A%90%E8%97%8F%E6%96%87%E4%BB%B6) 处也可填写需要隐藏的文件(每行一个)
```bash
/\/top.md/i  # 顶部 Markdown
/\/markdown.md/i  # 底部 Markdown
```

### 美化页面
通过插入代码修改 CSS 等方式美化
`管理 -> 设置 -> 全局` 在 `自定义头部 或 自定义内容` 中插入美化代码即可
```html
<link rel="stylesheet" href="https://font.sec.miui.com/font/css?family=MiSans:400,600:MiSans"/>  
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/hack-font@3/build/web/hack.css"/>  
<style>
/* 白天模式🌞 */
.hope-ui-light {
  /* 背景图片 */
  background-image:url("https://cdn2.zzzmh.cn/wallpaper/origin/ea581833bb3743ce9dde81e4531e2fbd.png?response-content-disposition=attachment&auth_key=1738684800-54b21a23de8bcfdf055b85912708dbfff0ac22fe-0-d0e96ee780a3272a158d50046ab0477f") !important;
  background-repeat:no-repeat;  /* 设置背景图片不重复 */
  background-size:cover;  /* 设置背景图片覆盖整个页面 */
  background-attachment:fixed;  /* 设置背景图片固定 */
  background-position-x:center;  /* 设置背景图片水平居中 */
  color:#000000;  /* 设置文字颜色 */
}
/* 黑夜模式🌛 */
.hope-ui-dark {
  /* 背景图片 */
  background-image:url("https://static.simpledesktops.com/uploads/desktops/2019/03/04/zurich.png") !important;
  background-repeat:no-repeat;  /* 设置背景图片不重复 */
  background-size:cover;  /* 设置背景图片覆盖整个页面 */
  background-attachment:fixed;  /* 设置背景图片固定 */
  background-position-x:center;  /* 设置背景图片水平居中 */
  color:#ffffff;  /* 设置文字颜色 */
}
/* 主列表_白天模式🌞 */
.obj-box.hope-stack.hope-c-dhzjXW.hope-c-PJLV.hope-c-PJLV-igScBhH-css {
  background-color:rgba(255, 255, 255, 0.2) !important;  /* 设置背景颜色透明度 */
}
/* 主列表_黑夜模式🌛 */
.obj-box.hope-stack.hope-c-dhzjXW.hope-c-PJLV.hope-c-PJLV-iigjoxS-css {
  background-color:rgba(0, 0, 0, 0.2) !important;  /* 设置背景颜色透明度 */
}
/* readme.md_白天模式🌞 */
.hope-c-PJLV.hope-c-PJLV-ikSuVsl-css {
  background-color:rgba(255, 255, 255, 0.2) !important;
}
/* readme.md_黑夜模式🌛 */
.hope-c-PJLV.hope-c-PJLV-iiuDLME-css {
  background-color:rgb(0, 0, 0, 0.2) !important;
}
/* 顶部右上角切换按钮_白天模式🌞 */
.hope-ui-light .hope-c-ivMHWx-hZistB-cv.hope-icon-button {
  background-color:rgba(255, 255, 255, 0.5) !important;
}
/* 顶部右上角切换按钮_黑夜模式🌛 */
.hope-ui-dark .hope-c-ivMHWx-hZistB-cv.hope-icon-button {
  background-color:rgba(0, 0, 0, 0.5) !important;
}
/* 右下角侧边栏_白天模式🌞 */
.hope-ui-light .hope-c-PJLV-ijgzmFG-css {
  background-color:rgba(255, 255, 255, 0.2) !important;
}
/* 右下角侧边栏_黑夜模式🌛 */
.hope-ui-dark .hope-c-PJLV-ijgzmFG-css {
  background-color:rgba(0, 0, 0, 0.2) !important;
}
/* MarkDown_白天模式🌞 */
.hope-ui-light .markdown-body {
  color: #ffffff;
}
/* MarkDown_黑夜模式🌛 */
.hope-ui-dark .markdown-body {
  color: #ffffff;
}
/* 代码块_白天模式🌞 */
.hope-ui-light pre {
  background-color:rgba(255, 255, 255, 0.3)!important;
}
/* 代码块_黑夜模式🌛 */
.hope-ui-dark pre {
  background-color:rgba(0, 0, 0, 0.3)!important;
}
/* 返回顶部_白天模式🌞 */
.hope-c-PJLV-ijcfFfc-css {
  background:rgba(255, 255, 255, 0.5) !important;
}
/* 返回顶部_黑夜模式🌛 */
.hope-ui-dark .hope-c-PJLV-ijcfFfc-css {
  background-color:rgba(0, 0, 0, 0.5) !important;
}
/* 顶部背景_白天模式🌞 */
.hope-c-PJLV-ikaMhsQ-css {
  background:rgba(255, 255, 255, 0) !important;
}
/* 顶部背景_黑夜模式🌛 */
.hope-ui-dark .hope-c-PJLV-ikaMhsQ-css {
  background:rgba(0, 0, 0, 0) !important;
}
/* 吸附到页面顶部(下翻时顶部和导航条保留)_顶部_白天模式🌞 */
.hope-c-PJLV-icWrYmg-css {
  background:rgba(255, 255, 255, 0) !important;
}
/* 吸附到页面顶部(下翻时顶部和导航条保留)_顶部_黑夜模式🌛 */
.hope-ui-dark .hope-c-PJLV-icWrYmg-css {
  background:rgba(0, 0, 0, 0) !important;
}
/* 吸附到页面顶部(下翻时顶部和导航条保留)_导航条 */
.hope-c-PJLV-icKsjdm-css::after {
  background:rgba(255, 255, 255, 0) !important;
}
/* 吸附到页面顶部(下翻时顶部和导航条保留)_导航条_白天模式🌞(会被仅附着导航条覆盖) */
.hope-ui-light .hope-c-PJLV-icKsjdm-css {
  background-color:rgba(255, 255, 255, 0.2) !important;
  border-radius:var(--hope-radii-xl) !important;  /* 设置圆角 */
}
/* 吸附到页面顶部(下翻时顶部和导航条保留)_导航条_黑夜模式🌛(会被仅附着导航条覆盖) */
.hope-ui-dark .hope-c-PJLV-icKsjdm-css {
  background-color:rgba(255, 255, 255, 0.2) !important;
  border-radius:var(--hope-radii-xl) !important;  /* 设置圆角 */
}
/* 仅吸附导航栏_导航条 */
.hope-c-PJLV-ifdXShc-css::after {
  background:rgba(255, 255, 255, 0) !important;
}
/* 仅吸附导航栏_导航条_白天模式🌞 */
.hope-ui-light .hope-c-hrsMRY {
  background-color:rgba(255, 255, 255, 0.2) !important;
  border-radius:var(--hope-radii-xl) !important;  /* 设置圆角 */
}
/* 仅吸附导航栏_导航条_黑夜模式🌛 */
.hope-ui-dark .hope-c-hrsMRY {
  background-color:rgba(0, 0, 0, 0.2) !important;
  border-radius:var(--hope-radii-xl) !important;  /* 设置圆角 */
}
/* 搜索栏和右侧设置栏_白天模式🌞 */
.hope-ui-light .hope-c-hOYTCS {
  background-color:rgba(255, 255, 255, 0.3) !important;
  color:#000000;  /* 设置文字颜色 */
}
/* 搜索栏和右侧设置栏_黑夜模式🌛 */
.hope-ui-dark .hope-c-hOYTCS {
  background-color:rgba(0, 0, 0, 0.3) !important;
  color:#ffffff;  /* 设置文字颜色 */
}
/* markdown大纲透明 */
.hope-c-PJLV-ieGWMbI-css {
  background:rgba(255, 255, 255, 0) !important;
}
/* 全部换字体加粗 */
* {
  font-family:MiSans;   /* 设置字体 */
  font-weight:bold;    /* 设置加粗 */
}
</style>
```