{"id":13400311,"url":"https://github.com/P3TERX/Aria2-Pro-Docker","last_synced_at":"2025-03-14T06:31:37.948Z","repository":{"id":38680384,"uuid":"234595784","full_name":"P3TERX/Aria2-Pro-Docker","owner":"P3TERX","description":"Aria2 Pro | A perfect Aria2 Docker image | 更好用的 Aria2 Docker 容器镜像","archived":false,"fork":false,"pushed_at":"2024-06-17T11:16:29.000Z","size":84,"stargazers_count":3246,"open_issues_count":57,"forks_count":387,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-10-29T14:53:10.556Z","etag":null,"topics":["aria2","aria2-docker","aria2c","bittorrent","bt","docker","docker-aria2","docker-compose","docker-image","dockerfile","download","downloader","magnet","magnet-link"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/p3terx/aria2-pro","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/P3TERX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-17T17:02:39.000Z","updated_at":"2024-10-29T02:03:36.000Z","dependencies_parsed_at":"2023-02-16T18:32:19.388Z","dependency_job_id":"85d13f9c-7379-47ad-b58f-f4188c92cc67","html_url":"https://github.com/P3TERX/Aria2-Pro-Docker","commit_stats":{"total_commits":75,"total_committers":5,"mean_commits":15.0,"dds":0.3866666666666667,"last_synced_commit":"4ec58da2901947f57e2e53f30077723627c8eaeb"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3TERX%2FAria2-Pro-Docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3TERX%2FAria2-Pro-Docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3TERX%2FAria2-Pro-Docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3TERX%2FAria2-Pro-Docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/P3TERX","download_url":"https://codeload.github.com/P3TERX/Aria2-Pro-Docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243330324,"owners_count":20274039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aria2","aria2-docker","aria2c","bittorrent","bt","docker","docker-aria2","docker-compose","docker-image","dockerfile","download","downloader","magnet","magnet-link"],"created_at":"2024-07-30T19:00:50.506Z","updated_at":"2025-03-14T06:31:37.655Z","avatar_url":"https://github.com/P3TERX.png","language":"Dockerfile","readme":"**English** | [中文](https://p3terx.com/archives/docker-aria2-pro.html)\n\n# Aria2 Pro Docker\n\n[![LICENSE](https://img.shields.io/github/license/P3TERX/Aria2-Pro-Docker?style=flat-square\u0026label=LICENSE)](https://github.com/P3TERX/Aria2-Pro-Docker/blob/master/LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/P3TERX/Aria2-Pro-Docker.svg?style=flat-square\u0026label=Stars\u0026logo=github)](https://github.com/P3TERX/Aria2-Pro-Docker/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/P3TERX/Aria2-Pro-Docker.svg?style=flat-square\u0026label=Forks\u0026logo=github)](https://github.com/P3TERX/Aria2-Pro-Docker/fork)\n[![Docker Stars](https://img.shields.io/docker/stars/p3terx/aria2-pro.svg?style=flat-square\u0026label=Stars\u0026logo=docker)](https://hub.docker.com/r/p3terx/aria2-pro)\n[![Docker Pulls](https://img.shields.io/docker/pulls/p3terx/aria2-pro.svg?style=flat-square\u0026label=Pulls\u0026logo=docker\u0026color=orange)](https://hub.docker.com/r/p3terx/aria2-pro)\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/P3TERX/Aria2-Pro-Docker/docker-build-test.yml?label=Actions\u0026logo=github\u0026style=flat-square)\n\nA perfect Aria2 Docker image. Out of the box, just add download tasks and don't need to think about anything else.\n\n## Features\n\n* Supported platforms: `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`\n* Full Function: `Async DNS`, `BitTorrent`, `Firefox3 Cookie`, `GZip`, `HTTPS`, `Message Digest`, `Metalink`, `XML-RPC`, `SFTP`\n* `max-connection-per-server` unlimited.\n* retry on slow speed (`lowest-speed-limit`) and connection close\n* High BT download rate and speed\n* Get BitTorrent tracker automatically\n* Download error automatically delete files\n* Download cancel automatically delete files\n* Automatically clear `.aria2` suffix files\n* Automatically clear `.torrent` suffix files\n* No lost task progress, no repeated downloads\n* And more powerful features\n\n## Usage\n\n### Docker CLI\n\n- No matter what architecture platform is used, just use the following command to start the container ( Just need to replace the `\u003cTOKEN\u003e` field ):\n```\ndocker run -d \\\n    --name aria2-pro \\\n    --restart unless-stopped \\\n    --log-opt max-size=1m \\\n    -e PUID=$UID \\\n    -e PGID=$GID \\\n    -e UMASK_SET=022 \\\n    -e RPC_SECRET=\u003cTOKEN\u003e \\\n    -e RPC_PORT=6800 \\\n    -p 6800:6800 \\\n    -e LISTEN_PORT=6888 \\\n    -p 6888:6888 \\\n    -p 6888:6888/udp \\\n    -v $PWD/aria2-config:/config \\\n    -v $PWD/aria2-downloads:/downloads \\\n    p3terx/aria2-pro\n```\n\n- Then you need a WebUI for control, such as [AriaNg](https://github.com/mayswind/AriaNg). [This link](http://ariang.mayswind.net/latest) is provided by the developer and can be used directly. Or use Docker to deploy it yourself:\n```\ndocker run -d \\\n    --name ariang \\\n    --log-opt max-size=1m \\\n    --restart unless-stopped \\\n    -p 6880:6880 \\\n    p3terx/ariang\n```\n\n\u003e **TIPS:** It is important for the firewall to open ports.\n\n### Docker Compose\n\n- Download [Compose file](https://github.com/P3TERX/Aria2-Pro-Docker/blob/master/docker-compose.yml)\n```\nwget git.io/aria2-pro.yml\n```\n\n- Edit Compose file\n```\nvim aria2-pro.yml\n```\n\n- Compose up\n```\ndocker-compose -f aria2-pro.yml up -d\n```\n\n### Other\n\n- [Docker templates for UNRAID](https://github.com/P3TERX/unraid-docker-templates)\n- [Docker Tutorial for Synology DSM (Chinese)](https://p3terx.com/archives/synology-nas-docker-advanced-tutorial-deploy-aria2-pro.html)\n\n## Parameters\n\n| Parameter                        | Function                                                                                                                                                                  |\n| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `-e PUID=$UID`\u003cbr\u003e`-e PGID=$GID` | Bind UID and GID to the container, which means you can use a non-root user to manage downloaded files.                                                                    |\n| `-e UMASK_SET=022`               | For umask setting of Aria2, optional , default if left unset is `022`                                                                                                     |\n| `-e RPC_SECRET=\u003cTOKEN\u003e`          | Set RPC secret authorization token. Default: `P3TERX`                                                                                                                     |\n| `-e RPC_PORT=6800`               | Set RPC listen port.                                                                                                                                                      |\n| `-p 6800:6800`                   | bind RPC listen port.                                                                                                                                                     |\n| `-e LISTEN_PORT=6888`            | Set TCP/UDP port number for BitTorrent/DHT listen.                                                                                                                        |\n| `-p 6888:6888`                   | Bind BT listen port (TCP).                                                                                                                                                |\n| `-p 6888:6888/udp`               | Bind DHT lisen port (UDP).                                                                                                                                                |\n| `-v \u003cPATH\u003e:/config`              | Contains all relevant configuration files.                                                                                                                                |\n| `-v \u003cPATH\u003e:/downloads`           | Location of downloads on disk.                                                                                                                                            |\n| `-e DISK_CACHE=\u003cSIZE\u003e`           | Set up disk cache. SIZE can include `K` or `M` (1K = 1024, 1M = 1024K), e.g `64M`.                                                                                        |\n| `-e IPV6_MODE=\u003cBOOLEAN\u003e`         | Whether to enable IPv6 support for Aria2. Optional: `true` or `false`. Set the options `disable-ipv6=false` and `enable-dht6=true` in the configuration file(aria2.conf). |\n| `-e UPDATE_TRACKERS=\u003cBOOLEAN\u003e`   | Whether to update BT Trackers List automatically. Optional: `true` or `flase`, default if left unset is `true`                                                            |\n| `-e CUSTOM_TRACKER_URL=\u003cURL\u003e`    | Custom BT Trackers List URL. If not set, it will be get from https://trackerslist.com/all_aria2.txt.                                                                      |\n| `-e TZ=Asia/Shanghai`            | Specify a timezone to use e.g. `Asia/Shanghai`                                                                                                                            |\n\n## Advanced\n\nI am working hard on my English, so this part may be explained in detail later. If you can read Chinese, read the details in [my blog](https://p3terx.com/archives/docker-aria2-pro.html).\n\n## Credits\n\n* [aria2](https://github.com/aria2/aria2)\n* [P3TERX/aria2.conf](https://github.com/P3TERX/aria2.conf)\n* [P3TERX/Aria2-Pro-Core](https://github.com/P3TERX/Aria2-Pro-Core)\n* [just-containers/s6-overlay](https://github.com/just-containers/s6-overlay)\n* [XIU2/TrackersListCollection](https://github.com/XIU2/TrackersListCollection)\n\n## License\n\n[MIT](https://github.com/P3TERX/Aria2-Pro-Docker/blob/master/LICENSE) © P3TERX\n","funding_links":[],"categories":["Dockerfile","docker"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FP3TERX%2FAria2-Pro-Docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FP3TERX%2FAria2-Pro-Docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FP3TERX%2FAria2-Pro-Docker/lists"}