Alist教程｜利用1panel一键安装aira2和airang，离线下载再不难

alist系列稿件

本期和大家分享下，通过在VPS安装免费的1panel面板，使用我改写的容器文件，只需要简单几步操作，就能快速安装alist、aria2和ariang。如此一来，无论你用不用alist，都可以使用VPS，实现离线下载的功能。

这里和不太熟悉aria2的朋友解释下，aria2是很强大的下载工具。alist内置了aria2的下载功能。只要在VPS进行相应的配置，就能利用aria2实现离线下载的功能。ariang是aria2的图形管理界面。如果你不使用alist，同样可以通过ariang来管理下载操作。

在之前alist的系列视频中，我曾讲过如何安装和配置alist，以及如何配置aria2，来实现离线下载的需求。但整个过程都需要代码操作，遇到问题也不容易解决。

在看到1panel这个服务器图形管理面板后，我发现它内置的应用商店中就有alist，点击就能安装，安装流程就丝滑了很多。然后，我通过ChatGPT改写了compose文件，写入了aria2和ariang。这样就实现了一键安装。

关于aria2和ariang，我用的是P3TERX的容器镜像。

正常来说，应该先安装alist，再安装aria2和ariang。期间，需要开放端口，配置密钥和地址，基本都需要通过代码命令来操作，对我们这些不懂代码的人非常不友好。所以，看到1panel后，就让我发现，可以将大部分配置工作以图形化的方式来操作。

当然，使用1panel也并非尽善尽美。最大的问题在于，1panel全部使用了docker容器的安装方式，好处是与VPS系统文件隔离，配置错了想删就删，不会影响全局配置；但隔离带来的弊端是，各个应用互通性并不好，商店内置的应用还好，基本有初始的配置和提示。想要额外安装软件，就要熟悉docker的一些操作。

以alist和aria2为例，如果你没有配置好文件映射以及不同应用的用户权限，就会发现，下载的文件要么找不到下载文件夹，要么就没有权限创建和移动，非常麻烦。我会在操作过程中，聊一聊经常遇到的各种错误。

先给自己叠个buff：我不懂代码，能有这个分享，全靠看别人的教程和与ChatGPT尬聊。所以，文件代码都是野路子，有不合规范的地方，欢迎指正。

第一步：安装1pael （ubuntu）

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

快捷命令：1pctl

第二步：安装alist/aira2pro/ariang

更新并整合后的 docker-compose.yml 文件，其中包含 Alist、Aria2-Pro 和 AriaNg：

version: '3.8'

networks:
  1panel-network:
    external: true

services:
  alist:
    container_name: ${CONTAINER_NAME}
    deploy:
      resources:
        limits:
          cpus: ${CPUS}
          memory: ${MEMORY_LIMIT}
    environment:
      - PUID=65534
      - PGID=65534
      - UMASK=022
    image: xhofe/alist:v3.39.1
    labels:
      createdBy: Apps
    networks:
      - 1panel-network
    ports:
      - ${HOST_IP}:${PANEL_APP_PORT_HTTP}:5244
      - ${HOST_IP}:${PANEL_APP_PORT_S3}:5426
    restart: always
    volumes:
      - /root/aria2-pro/aria2-downloads:/opt/alist/data/temp/aria2  # Alist访问Aria2下载文件的挂载
      - ./data/mnt:/mnt/data
      - ./data/data:/opt/alist/data

  aria2-pro:
    container_name: aria2-pro
    image: p3terx/aria2-pro
    environment:
      - PUID=65534
      - PGID=65534
      - UMASK_SET=022
      - RPC_SECRET=P3TERX #这是aria2的RPC/密钥，需要随便改一串文字
      - RPC_PORT=6800
      - LISTEN_PORT=6888
      - DISK_CACHE=64M
      - IPV6_MODE=false
      - UPDATE_TRACKERS=true
      - CUSTOM_TRACKER_URL=
      - TZ=Asia/Shanghai
    volumes:
      - ${PWD}/aria2-config:/config
      - ${PWD}/aria2-downloads:/downloads
      - /root/aria2-pro/aria2-downloads:/opt/alist/data/temp/aria2  # 映射到 Alist 的共享目录
    network_mode: host
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: 1m

  ariang:
    container_name: ariang
    image: p3terx/ariang
    command: --port 6880 --ipv6
    network_mode: host
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: 1m

解释和注意事项：

1. 网络配置 (networks)：
   • 所有服务共享同一个 1panel-network，这样可以保证它们之间的通信，您也可以根据需要保留现有的 host 网络模式。
2. Alist 服务 (alist service)：
   • 使用之前提供的配置，保持网络连接到 1panel-network，并正确设置数据挂载。
   • 下载目录 /root/aria2-pro/aria2-downloads 映射到 Alist 的 /opt/alist/data/temp/aria2 目录中，以确保 Alist 可以读取和管理 Aria2 下载的文件。
3. Aria2-Pro 服务 (aria2-pro service)：
   • 使用您提供的最新配置，采用 host 网络模式，可以直接访问 IPv4 和 IPv6。
   • 端口映射：由于您使用的是 host 模式，因此不需要手动映射端口，这些端口会直接映射到宿主机。
   • 挂载卷：
     • ${PWD}/aria2-config:/config：用于 Aria2 的配置文件。
     • ${PWD}/aria2-downloads:/downloads：用于保存 Aria2 的下载内容。
     • /root/aria2-pro/aria2-downloads:/opt/alist/data/temp/aria2：额外添加了与 Alist 共享的下载路径，以确保 Alist 可以管理这些下载的文件。
4. AriaNg 服务 (ariang service)：
   • 使用您提供的最新配置，使用 host 网络模式，这样可以方便地访问 Aria2 的 RPC 接口。
   • 使用命令 -port 6880 --ipv6 启动服务，使得 AriaNg 可以通过端口 6880 提供 Web UI。
   • 使用 logging 限制日志大小，避免日志无限增长。

关键总结：

• 共享下载目录：确保 Aria2 和 Alist 共享同一个下载目录 /root/aria2-pro/aria2-downloads，这样 Alist 能够正常读取和处理 Aria2 下载的文件。
• 网络模式：使用 host 网络模式，使 Aria2 和 AriaNg 可以轻松访问宿主机的网络，尤其在涉及 IPv6 支持时非常方便。
• 配置一致性：确保 Alist、Aria2-Pro 和 AriaNg 的网络和数据共享配置一致，以便它们可以高效协同工作。

配置完成后，在alist文件夹内，您可以运行以下命令启动所有服务：

docker-compose down #关闭文件
docker-compose up -d #启动文件，并在后台运行

请测试并确保所有服务按预期运行，尤其是 Alist 能够正常读取 Aria2 下载的文件。

第三步：开放端口

aria2-pro和ariang的端口可能不会被设置需要手动设置下

aria2-pro

6800

6888

ariang

6880

设置alist账号/密码

./alist admin set 随便写

第四步：其他

ariang登录地址：http://ip:6880