One-Click Installation of Aria2 + YAAW for Offline Downloads on Linux
Aria2 is a lightweight, multi-protocol, and multi-source command-line download tool. It supports HTTP/HTTPS, FTP, SFTP, BitTorrent, and Metalink. Aria2 can be operated via its built-in JSON-RPC and XML-RPC interfaces.
YAAW is a web interface for managing Aria2. Combining the two makes offline downloading easy. In the article CentOS Install Aria2 + YAAW for Offline Downloads, the manual configuration method was shared. To simplify the process, a one-click script has been written for easy deployment.
Features and Highlights
- Supports multiple different Linux systems
- One-click installation of Aria2 + Caddy + YAAW
- Uses FileFileManager as the file manager
- Offline downloading + online video playback
Installation
Copy the commands below directly, one per line, and follow the prompts to complete the operation.
# For CentOS users
yum -y install wget unzip
# For Debian or Ubuntu users
apt-get install -y wget unzip
# The following commands are universal, copy directly
wget https://github.com/helloxz/aria2/archive/master.zip
unzip master.zip && cd aria2-master && chmod u+x *.sh && ./install_aria2.sh
Select the option based on your system. Do not choose the wrong system, or it will not work properly. For example, my system is CentOS 7, so I chose option 1.
Follow the prompts to enter further information. Note: The Aria2 authorization token is recommended to be a combination of letters and numbers, preferably without special symbols, especially symbols like @, to avoid unnecessary issues.
After installation is complete, you will see the following information. It is recommended to save this information in a place that others cannot easily discover, as you will need it later.
Getting Started
After installation, access http://IP:6080 in your browser. Enter the username and password you just set to access YAAW.
Click the "Setting" button in the top right corner. In the "JSON-RPC Path" field, enter the RPC address displayed after installation: http://token:abc123@IP:6800/jsonrpc, then save.
Adding Download Tasks
If the configuration is correct, click the "Add" button to try adding a download task.
Managing Files
Enter http://IP:6080/admin to access FileFileManager and view all files. Downloaded files are saved in the download directory. Do not modify other files arbitrarily to avoid errors.
Retrieving Files Locally
It is recommended to use multi-threaded download tools like IDM or EagleGet. When copying the download address, remember to fill in the username and password, otherwise, you will not be able to download.
Related Commands
# Start
/data/aria2/aria2.sh start
# Stop
/data/aria2/aria2.sh stop
# Restart
/data/aria2/aria2.sh restart
# Uninstall
cd aria2-master && ./uninstall.sh
# Caddy server configuration file
/data/aria2/caddy.conf
# Aria2 configuration file
/data/aria2/aria2.conf
# Offline download directory
/data/aria2/download
Frequently Asked Questions
YAAW shows an error: "Internal server error"?
Reason 1: The RPC address is incorrect. After installation, the RPC address is displayed. Please ensure it is entered correctly.
Reason 2: Enter netstat -apn|grep 'aria2c' to check the process. If there is no information, the Aria2 service is not started. Enter the command nohup aria2c --conf-path=/data/aria2/aria2.conf > /data/aria2/aria2.log 2>&1 & to restart the service. If it still doesn't work, check the error log /data/aria2/aria2.log.
Reason 3: Port 6800 is not allowed through the firewall. Please allow the port or close the server firewall.
The site is inaccessible after restarting the server?
The script does not set up automatic startup. After restarting the server, enter /data/aria2/aria2.sh start to run the service.
I am a Debian/Ubuntu user. Installation was successful, but I cannot access it?
Debian/Ubuntu does not automatically allow ports. Please allow ports 6080 and 6800, or directly close the firewall. If your service provider supports security groups, you also need to check them.
Problem Feedback
You can leave a message below or open a Github Issue. For easier troubleshooting, please provide the following information:
- Operating system used
- Error message or screenshot
- Log content from
/data/aria2/aria2.log
Friendly Reminder
Most foreign VPS providers prohibit copyright-infringing content and BitTorrent. Use offline downloading reasonably. If the server is closed due to violation of the provider's Terms of Service (TOS), no responsibility is assumed.
- Do not download copyrighted content (such as videos, music, etc.)
- Do not run bandwidth to full capacity for a long time
- Do not download BitTorrent content
Summary
If you have bought a bunch of VPSs that are gathering dust, try this script to set up offline downloading. It is recommended to install on foreign VPSs; for domestic small bandwidth, the significance is limited. The script is in the initial testing stage. If there are problems, please leave a message for feedback. Later versions will support more systems. (PS: Original article, please indicate source when reprinting)
Documentation: LACY User Manual Script Source: Linux One-Click Install Aria2 + YAAW Other Original Scripts: