Alist tutorial | Use 1panel to install aira2 and airang in one click, offline download is no longer difficult

Alist series of articles

In this issue, I would like to share with you how to install the free 1panel panel on your VPS and use the container file I rewrote. In just a few simple steps, you can quickly install alist, aria2, and ariang. In this way, whether you use alist or not, you can use your VPS to achieve the function of offline downloading.

Here I would like to explain to those who are not familiar with aria2 that aria2 is a very powerful download tool. alist has built-in aria2 download function. As long as the corresponding configuration is made in the VPS, aria2 can be used to achieve the function of offline download. ariang is the graphical management interface of aria2. If you do not use alist, you can also manage download operations through ariang.

In the previous alist video series, I talked about how to install and configure alist, and how to configure aria2 to achieve offline download requirements. However, the whole process requires code operation, and it is not easy to solve problems.

After seeing 1panel, a graphical server management panel, I found that alist was available in its built-in app store. I could install it with one click, which made the installation process much smoother. Then, I rewrote the compose file through ChatGPT and wrote aria2 and ariang. This made one-click installation possible.

For aria2 and ariang, I used the container image of P3TERX.

Normally, you should install alist first, then aria2 and ariang. During this period, you need to open ports, configure keys and addresses, and basically operate through code commands, which is very unfriendly to those of us who don't understand code. So, after seeing 1panel, I found that most of the configuration work can be operated in a graphical way.

Of course, using 1panel is not perfect. The biggest problem is that 1panel is installed entirely in docker containers. The advantage is that it is isolated from the VPS system files. If the configuration is wrong, you can delete it at will without affecting the global configuration. However, the disadvantage of isolation is that the interoperability of various applications is not good. The built-in applications in the store are okay, and basically have initial configuration and prompts. If you want to install additional software, you must be familiar with some docker operations.

Take alist and aria2 as examples. If you don't configure file mapping and user permissions for different applications, you will find that the downloaded files either cannot find the download folder or you don't have permission to create and move them, which is very troublesome. I will talk about the various errors that are often encountered during the operation.

First of all, I want to give myself a buff: I don't understand code, and I can share this by watching other people's tutorials and chatting with ChatGPT. Therefore, the file codes are all wild, and if there are any non-standard places, you are welcome to correct them.

Step 1: Install 1pael (Ubuntu)

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

Quick commands:1pctl

Step 2: Install alist/aira2pro/ariang

Updated and integrated docker-compose.yml Files, including Alist, Aria2-Pro and 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 accesses the mount of Aria2 downloaded files - ./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 # This is the RPC/key of aria2, you need to change a string of text - 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 # is mapped to Alist's shared directory 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

Explanation and notes:

1. Network Configuration (networks):
   • All services share the same 1panel-network, which ensures communication between them, and you can also keep the existing host Network mode.
2. Alist Services (alist service):
   • Using the configuration provided previously, keep the network connected to 1panel-network, and set up data mount correctly.
   • Download Catalog /root/aria2-pro/aria2-downloads Mapped to Alist /opt/alist/data/temp/aria2 directory to ensure that Alist can read and manage the files downloaded by Aria2.
3. Aria2-Pro Service (aria2-pro service):
   • Use the latest configuration you provided, using host Network mode, can directly access IPv4 and IPv6.
   • Port Mapping: Since you are using host mode, so there is no need to manually map ports, these ports will be mapped directly to the host machine.
   • Mounting Volumes:
     • ${PWD}/aria2-config:/config: Configuration file for Aria2.
     • ${PWD}/aria2-downloads:/downloads: Used to save the downloaded content of Aria2.
     • /root/aria2-pro/aria2-downloads:/opt/alist/data/temp/aria2: An additional download path shared with Alist is added to ensure that Alist can manage these downloaded files.
4. AriaNg Service (ariang service):
   • Using the latest configuration you provided, use host Network mode, which allows easy access to the Aria2's RPC interface.
   • Use Commands -port 6880 --ipv6 Start the service so that AriaNg can provide the Web UI through port 6880.
   • use logging Limit the log size to prevent it from growing indefinitely.

Key takeaways:

• Shared download directory: Make sure Aria2 and Alist share the same download directory /root/aria2-pro/aria2-downloads, so that Alist can normally read and process the files downloaded by Aria2.
• Network Mode:use host Network mode allows Aria2 and AriaNg to easily access the host's network, which is especially convenient when IPv6 support is involved.
• Configuration consistency: Ensure that the network and data sharing configurations of Alist, Aria2-Pro, and AriaNg are consistent so that they can work together efficiently.

After the configuration is complete,alistInside the folder, you can start all services by running:

docker-compose down # close the file docker-compose up -d # start the file and run it in the background

Please test and make sure all services are running as expected, especially that Alist can read the files downloaded by Aria2 properly.

Step 3: Open ports

The ports of aria2-pro and ariang may not be set and need to be set manually.

aria2-pro

6800

6888

ariang

6880

set upalistUsername/Password

./alist admin set Write casually

Step 4: Others

ariang login address: http://ip:6880