Overview

Full name
docker.io/wahyd4/aria2-ui
Registry
docker.io
Namespace
wahyd4
Repository
aria2-ui
Cached tags
268
Last synced
07/06/2026, 06:28 PM

Introduction

Aria2 Web 控制台镜像,统一管理 BT/HTTP/FTP 下载任务,实时查看速度与队列,适合 NAS 或 homelab 集中调度 aria2c 后端。

Details

wahyd4/aria2-ui 提供 React 前端连接 aria2 RPC,展示任务列表、文件选择与 RSS 订阅。镜像内可 bundled aria2 或连接外部 daemon,通过 RPC_SECRET 鉴权。与 AriaNg 静态页相比部署一体化更简单。生产应启用 RPC 密钥、限制 Web 端口访问,下载目录挂载大容量卷;公网暴露需反向代理鉴权,避免 RPC 被滥用发起任意 URL 下载。

快速启动

docker run -d --name aria2-ui \
  -p 8080:8080 \
  docker.io/wahyd4/aria2-ui:latest

推荐实践

docker run -d --name aria2-ui \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 6800:6800 \
  -v /data/downloads:/downloads \
  -e RPC_SECRET=your-rpc-token \
  -e ARIA2_PORT=6800 \
  docker.io/wahyd4/aria2-ui:1.0.0

核心参数说明

  • -p 8080:8080 — Web 管理界面
  • -p 6800:6800 — aria2 JSON-RPC 端口
  • -v /data/downloads:/downloads — 已完成文件存储
  • -e RPC_SECRET — RPC 调用令牌
  • -e ARIA2_PORT — 后端 RPC 监听端口
  • --restart unless-stopped — 下载调度持续在线

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: aria2-ui
spec:
  replicas: 1
  selector:
    matchLabels:
      app: aria2-ui
  template:
    metadata:
      labels:
        app: aria2-ui
    spec:
      containers:
        - name: aria2-ui
          image: docker.io/wahyd4/aria2-ui:1.0.0
          ports:
            - containerPort: 8080
            - containerPort: 6800
          env:
            - name: RPC_SECRET
              valueFrom:
                secretKeyRef:
                  name: aria2-secrets
                  key: rpc-secret
          volumeMounts:
            - name: downloads
              mountPath: /downloads
      volumes:
        - name: downloads
          persistentVolumeClaim:
            claimName: aria2-downloads
---
apiVersion: v1
kind: Service
metadata:
  name: aria2-ui
spec:
  selector:
    app: aria2-ui
  ports:
    - name: web
      port: 8080
      targetPort: 8080
    - name: rpc
      port: 6800
      targetPort: 6800

下载目录 PVC 按容量规划;单副本避免 aria2 状态冲突,Ingress 仅暴露 8080 并加 Basic Auth。

Latest tags (20)

View all 268 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/wahyd4/aria2-ui
:latest
linux/amd64linux/arm/v7linux/arm64
2025/11/28 08:25115.9 MBsha256:25dd86fd29f6
docker.io/wahyd4/aria2-ui
:6.4.0
linux/amd64linux/arm/v7linux/arm64
2025/11/28 08:25115.9 MBsha256:25dd86fd29f6
docker.io/wahyd4/aria2-ui
:edge
linux/amd64linux/arm/v7linux/arm64
2025/11/28 08:24115.9 MBsha256:237a1ddace37
docker.io/wahyd4/aria2-ui
:6.3.0
linux/amd64linux/arm/v7linux/arm64
2025/10/29 18:32115.9 MBsha256:5d842ec33eba
docker.io/wahyd4/aria2-ui
:6.2.2
linux/amd64linux/arm/v7linux/arm64
2025/03/07 14:39111.3 MBsha256:b3c946ea8f65
docker.io/wahyd4/aria2-ui
:6.2.1
linux/amd64linux/arm/v7linux/arm64
2025/03/07 12:57111.3 MBsha256:6b13b8f730a5
docker.io/wahyd4/aria2-ui
:6.2.0
linux/amd64linux/arm/v7linux/arm64
2025/03/07 10:57111.2 MBsha256:138fc60cf18a
docker.io/wahyd4/aria2-ui
:6.1.4
linux/amd64linux/arm/v7linux/arm64/v8
2025/03/06 20:35111.2 MBsha256:1a6918b73fcb
docker.io/wahyd4/aria2-ui
:6.1.3
linux/amd64linux/arm/v7linux/arm64/v8
2025/03/06 20:17111.2 MBsha256:200a7be744d5
docker.io/wahyd4/aria2-ui
:6.1.2
linux/amd64linux/arm/v7linux/arm64/v8
2025/03/06 20:07111.2 MBsha256:b5b395e07e54
docker.io/wahyd4/aria2-ui
:6.1.1
linux/amd64linux/arm/v7linux/arm64/v8
2025/03/06 19:51111.2 MBsha256:f5d890c6e629
docker.io/wahyd4/aria2-ui
:6.0.1
linux/amd64linux/arm/v7linux/arm64
2023/09/18 07:04108.1 MBsha256:0e3fae64eae9
docker.io/wahyd4/aria2-ui
:6.0.0
linux/arm/v7linux/arm64linux/amd64
2023/05/23 12:5397.6 MBsha256:66d75df85273
docker.io/wahyd4/aria2-ui
:5.4.0
linux/amd64linux/arm/v7linux/arm64
2023/04/20 13:070.0 MBsha256:8b4302984f87
docker.io/wahyd4/aria2-ui
:5.3.0
linux/arm64linux/amd64linux/arm/v7
2023/04/13 07:2766.0 MBsha256:2778a2f1d934
docker.io/wahyd4/aria2-ui
:5.2.1
linux/amd64linux/arm/v7linux/arm64
2023/04/12 13:340.0 MBsha256:846c41cfee92
docker.io/wahyd4/aria2-ui
:5.1.0
linux/amd64linux/arm/v7linux/arm64
2022/12/30 15:4568.4 MBsha256:370ea9222433
docker.io/wahyd4/aria2-ui
:5.0.3
linux/amd64linux/arm/v7linux/arm64
2022/12/26 15:4768.4 MBsha256:90dd7c3fadc8
docker.io/wahyd4/aria2-ui
:5.0.2
linux/amd64linux/arm/v7linux/arm64
2022/12/26 15:1468.4 MBsha256:1b02812ad3fe
docker.io/wahyd4/aria2-ui
:5.0.1
linux/amd64linux/arm/v7linux/arm64
2022/06/24 20:5561.2 MBsha256:d7a993d1e68c