Aria2 + AriaNg + Filebrowser

English | 简体中文

If you like this project, please consider sponsoring me / 如果喜欢本项目，请考虑打赏，谢谢！

• Features
• Recommended versions
• How to run
  • Quick run
  • Full features run
  • Run with docker-compose
  • Supported Environment Variables
  • Supported Volumes
• Auto HTTPS enabling
• Download Automation 🤖
  • Download file through iPhone/Mac Shortcuts app.
  • Download file through cURL
• Build the image by yourself
• Docker Hub
• Running it on Kubernetes (My favorite)
• Running it with Docker compose
• FAQ

One Docker image for file downloading, managing, sharing, as well as video playing and evening cloud storage synchronization.

Furthermore, it's pretty small and ARM CPU compatible which means you can also run it on Raspberry Pi🍓.

Last but not least, Auto HTTPS can't be more easy!

AriaNG

File Browser

Features

• Aria2 (SSL support)
• AriaNg
• Rclone
• File Browser: Files mangement and videos playing
• Auto HTTPS （Let's Encrypt）
• Bind non root user into container, so non root user can also manage downloaded files.
• Basic Auth
• Support ARM CPUs as well, all supported CPU platforms can be found here
• Cloud Storage platforms synchronization
• Auto uploading files to 3rd party Cloud storage providers via Rclone after files been downloaded.

Recommended versions

• wahyd4/aria2-ui:latest

Docker will pick the the proper ARCH for you. e.g. arm64v8 or x86_64

How to run

Quick run

  docker run -d --name aria2-ui -p 8000:80 wahyd4/aria2-ui

• Aria2: http://yourip:8000
• FileManger: http://yourip:8000/files
• Rclone: http://yourip:8000/rclone
• Please use admin/admin as username and password to login Filebrowser for the first time. And use user/password to login Rclone if you don't update ARIA2_USER and ARIA2_PWD

Full features run

  docker run -d --name ariang \
  -p 80:80 \
  -p 443:443 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e ENABLE_AUTH=true \
  -e RPC_SECRET=Hello \
  -e DOMAIN=https://example.com \
  -e ARIA2_SSL=false \
  -e ARIA2_USER=user \
  -e ARIA2_PWD=password \
  -e ARIA2_EXTERNAL_PORT=443 \
  -e CADDY_LOG_LEVEL=ERROR \
  -v /yourdata:/data \
  -v /app/.cache:/app/.cache \
  -v /app/a.db:/app/filebrowser.db \
  -v /to_yoursslkeys/:/app/conf/key \
  -v <conf files folder>:/app/conf \
  wahyd4/aria2-ui

Run with docker-compose

If you would like to get rid of those annoying command line commands, then just put the following sample content into docker-compose.yaml

version: "3.5"
services:
  aria2-ui:
    restart: unless-stopped
    image: wahyd4/aria2-ui:latest
    environment:
      - ENABLE_AUTH=true
      - ARIA2_USER=hello
      - ARIA2_PWD=world
      - DOMAIN=http://toozhao.com
    ports:
      - "80:80"
    volumes:
      - ./data:/data

Then simply run docker-compose up -d, that's it!

Supported Environment Variables

Supported Volumes

Auto HTTPS enabling

Make sure you have added proper A record point to the host you running to your domain DNS record list, then just add e option to bind the https domain when you run the image

docker run -d --name aria2-ui -p 80:80 -p 443:443 -e DOMAIN=https://toozhao.com wahyd4/aria2-ui

Download Automation 🤖

Download file through iPhone/Mac Shortcuts app.

First Download Shortcut, then follow the promots to setup aria2-ui URL and RPC_SECRET. Then you are all ready to go, just to run the shortcut and provide the file URL which you want to download or the magnet/torrent file URL.

Download file through cURL

curl http://<ip>:<port>/jsonrpc -d "{\"jsonrcp\":\"2.0\",\"id\":\"someID\",\"method\":\"aria2.addUri\",\"params\":[\"token:someToken\",[\"http://some_file_url\"],{\"dir\":\"/data/downloads\"}]}"

Build the image by yourself

 docker buildx build --platform linux/arm/v7,linux/arm64,linux/amd64 -t aria2-ui .

Docker Hub

https://hub.docker.com/r/wahyd4/aria2-ui/

Running it on Kubernetes (My favorite)

First of all, I have to say running this docker image on Kubernetes is more challenging and requires more knowledges than running it in raw Docker, but which is more powerful. I couldn't tell you how to run it in Kubernetes step by step, but once you have a running Kubernetes cluster(You can install Kubernetes via minikube, Docker desktop app, kubeadm and many other tools.), then you can modify the k8s-manifest.yaml to satisfy all your requirements. Such as:

• NFS PV provider(Use your NAS as storage)
• Ingress access, Oauth login, more access controls via Nginx etc.
• VPN tunnel (Secure your traffic)
• Sidecars and so on.

Running it with Docker compose

Please refer https://github.com/wahyd4/aria2-ariang-x-docker-compose

FAQ

1. When you running the docker image with non 80 port or you have HTTPS enabled, you will meet the error says Aria2 Status Disconnected, then you will need to set ARIA2_EXTERNAL_PORT and recreate your container.
2. If there is no speed at all when you downloading a BitTorrent file, please try to use a popular torrent file first to help the application to cache DHT file. Then the speed should get fast and fast, as well as downloading other links.
3. If you see any errors related to setcap which probably means the Linux you are running doesn't support running this application with non-root user. So please specify the PUID and PGID to 0 explicitly to use root user to run it.
4. How can I get Rclone authenticated? Due to Rclone is running in this docker image only as a component rather than an application, you can only interact with it via /rclone endpoint, and no other ports. So the web browser authentication mechanism doesn't work here. Please configure Rclone through command line within the container. You can follow the official doc Configuring rclone on a remote / headless machine or this issue
5. Why the app stopped working when I have - v /<some-folder>:/app/conf mounted. It happens when you mount the entire /app/conf folder but you don't have any files under that folder on your host. To fix this issue, please simply copy all files under conf folder to your local folder that you mount to /app/conf and then rerun the container.