armbian/documentation
0
0
Fork 0
mirror of https://github.com/armbian/documentation.git synced 2026-01-06 10:13:36 -08:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
documentation/docs/Mirrors.md
igorpecovnik 553ba1dbb3 Automatic documentation update
2025-12-31 12:10:42 +01:00

102 lines
13 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
comments: true
---
# How the Armbian Mirror System Works
## Introduction
The [Armbian mirror system](https://github.com/armbian/armbian-router) is designed to efficiently distribute files, ensuring users get the best available server based on geographic proximity and server availability. This document outlines the mirroring system's operational flow, technical specifications for mirrors, and how to contribute a new server.
![armbian-mirror-explication](images/armbian-mirror-explication.png)
## Operational Flow
1. **User Request**
- A user initiates a file download (system image, package, etc.) from Armbian using a standard URL (e.g., `https://dl.armbian.com`).
2. **Redirector Server Processing**
- The redirector server processes the request and determines the best available mirror based on:
- User's geographic location
- Mirror server status and load
- Availability of the requested files
3. **Mirror Assignment**
- The redirector server provides a direct URL to the most suitable mirror.
- The user is automatically redirected to the designated server.
4. **Download from Assigned Mirror**
- The user downloads the file directly from the assigned mirror, optimizing speed and reducing load on the main infrastructure.
## Benefits of the Mirroring System
- **Load balancing**: Requests are distributed across multiple servers to prevent congestion.
- **Faster downloads**: Users are served by the closest available mirror.
- **Redundancy and reliability**: If a mirror is unavailable, the redirector automatically assigns an alternative.
## How to Contribute a Mirror
If you would like to contribute to the Armbian project by providing a mirror, follow these steps:
### 1. Choose the target and set up an HTTP/HTTPS hostname
- The mirror must be accessible via HTTP, and HTTPS is preferred.
### 2. Set up synchronization via `rsync`
- Sync files from one of the official repositories using the following commands:
| Content | Command | Required Space |
|---------|---------|---------------:|
| Current images | `rsync -av rsync://rsync.armbian.com/dl` | 556G |
| Packages | `rsync -av rsync://rsync.armbian.com/apt` | 84G |
| Archived images | `rsync -av rsync://rsync.armbian.com/archive` | 1.9T |
| Very old images | `rsync -av rsync://rsync.armbian.com/oldarchive` | 5.4T |
- Set up a cron job to sync every **2-4 hours**.
### 3. Inform us about your mirror
- Once your server is configured, contact us via the [contact form](https://www.armbian.com/contact/) to integrate it into the official redirector system.
Contributing a mirror helps improve Armbian’s file distribution, ensuring faster and more reliable downloads for the global community.
## Current Mirrors
| Site | Time Zone | Flag | Speed | Packages | Images | Archive | Rsync |
|:-----|:----------|------|-------:|:--------:|:------:|:-------:|:-----:|
| [Atomo Networks](https://armbian.atomonetworks.com) | Europe/Rome | [![null](https://flagsapi.com/IT/shiny/32.png)](https://www.openstreetmap.org/search?lat=38.157745&lon=13.195175) | 2500 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| [Auroradev Chicago](https://armbian.chi.auroradev.org) | America/Chicago | [![East coast](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=41.881832&lon=-87.623177) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Auroradev Las Vegas](https://armbian.lv.auroradev.org) | America/Los_Angeles | [![West coast](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=36.18811&lon=-115.176468) | 10000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| [Nardol](https://armbian.nardol.ovh) | Europe/Paris | [![France](https://flagsapi.com/FR/shiny/32.png)](https://www.openstreetmap.org/search?lat=48.8582&lon=2.3387) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Systemonachip](https://armbian.systemonachip.net) | Europe/Vienna | [![Austria](https://flagsapi.com/AT/shiny/32.png)](https://www.openstreetmap.org/search?lat=48.3003&lon=16.3441) | 1000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
| [Distrohub](https://distrohub.kyiv.ua) | Europe/Kiev | [![Ukraine](https://flagsapi.com/UA/shiny/32.png)](https://www.openstreetmap.org/search?lat=50.458&lon=30.5303) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | :white_check_mark: |
| [SBC mirror Spain](https://es.sbcmirror.org) | Europe/Madrid | [![Spain](https://flagsapi.com/ES/shiny/32.png)](https://www.openstreetmap.org/search?lat=40.4163&lon=-3.6934) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Hetzner Germany](https://fi.mirror.armbian.de) | Europe/Berlin | [![Germany](https://flagsapi.com/FI/shiny/32.png)](https://www.openstreetmap.org/search?lat=51.2993&lon=9.491) | 1000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| [Imola](https://imola.armbian.com) | Europe/Ljubljana | [![Slovenia](https://flagsapi.com/SI/shiny/32.png)](https://www.openstreetmap.org/search?lat=46.081638&lon=14.526054) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Kspace Estonia](https://k-space.ee.armbian.com) | Europe/Tallinn | [![Estonia](https://flagsapi.com/EE/shiny/32.png)](https://www.openstreetmap.org/search?lat=59.397987&lon=24.661898) | 10000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
| [AARNet](https://mirror.aarnet.edu.au) | Australia/Sydney | [![Australia](https://flagsapi.com/AU/shiny/32.png)](https://www.openstreetmap.org/search?lat=null&lon=null) | 100000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Albony](https://mirror.albony.in) | Asia/Kolkata | [![Dynamic](https://flagsapi.com/IN/shiny/32.png)](https://www.openstreetmap.org/search?lat=null&lon=null) | 1000 Mbps | :white_check_mark: | | | |
| [Macarne LLC](https://mirror.ams.macarne.com/armbian) | Europe/Amsterdam | [![Netherlands](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=52.3785&lon=4.9) | 50000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
| [Hostiko](https://mirror.hostiko.network) | Europe/Kiev | [![Ukraine](https://flagsapi.com/UA/shiny/32.png)](https://www.openstreetmap.org/search?lat=50.4547&lon=30.5238) | 20000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [ISCAS](https://mirror.iscas.ac.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=39.9075&lon=116.3971) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [OSS Planet](https://mirror.ossplanet.net) | Asia/Taipei | [![Taiwan](https://flagsapi.com/TW/shiny/32.png)](https://www.openstreetmap.org/search?lat=24.0&lon=121.0) | 1000 Mbps | :white_check_mark: | | | |
| [Digital Streaming Co.](https://mirror.twds.com.tw) | Asia/Taipei | [![Taiwan](https://flagsapi.com/TW/shiny/32.png)](https://www.openstreetmap.org/search?lat=25.0382&lon=121.5636) | 50000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [VineHost.NET](https://mirror.vinehost.net/armbian) | Europe/London | [![United Kingdom](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=54.1448&lon=-0.1555) | 1000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Yandex](https://mirror.yandex.ru/mirrors/armbian) | Europe/Moscow | [![Russia](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=55.7483&lon=37.6171) | 10000 Mbps | | :white_check_mark: | :white_check_mark: | |
| [marcusn.net](https://mirror2.marcusn.net/armbian) | Europe/London | [![United Kingdom](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=51.5085&lon=-0.1257) | 1000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| [Alibaba Mirrors](https://mirrors.aliyun.com) | Asia/Shanghai | [![China](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=34.7732&lon=113.722) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [BFSU](https://mirrors.bfsu.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=39.911&lon=116.395) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [c0urier.net](https://mirrors.c0urier.net) | Europe/Copenhagen | [![Denmark](https://flagsapi.com/DK/shiny/32.png)](https://www.openstreetmap.org/search?lat=56.0656&lon=12.2851) | 1000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
| [CSTCloud](https://mirrors.cstcloud.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=39.9075&lon=116.3971) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [dotsrc.org](https://mirrors.dotsrc.org) | Europe/Copenhagen | [![Denmark](https://flagsapi.com/DK/shiny/32.png)](https://www.openstreetmap.org/search?lat=55.6802&lon=12.5892) | 20000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Jevin Canders LLC](https://mirrors.jevincanders.net) | America/New_York | [![East coast](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=42.8868&lon=-78.8787) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Lahansons](https://mirrors.lahansons.com) | America/Los_Angeles | [![North America](https://flagsapi.com/US/shiny/32.png)](https://www.openstreetmap.org/search?lat=37.7757&lon=-122.3952) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Nanjing University](https://mirrors.nju.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=34.7732&lon=113.722) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Shandong University](https://mirrors.sdu.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=32.0617&lon=118.778) | 10000 Mbps | :white_check_mark: | | | |
| [Shanghai Tech University](https://mirrors.shanghaitech.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=34.7732&lon=113.722) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [SUSTech](https://mirrors.sustech.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=22.2767&lon=113.5788) | 10000 Mbps | :white_check_mark: | | | |
| [Tsinghua University](https://mirrors.tuna.tsinghua.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=34.7732&lon=113.722) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [USTC](https://mirrors.ustc.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=34.7732&lon=113.722) | 10000 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Zhejiang University](https://mirrors.zju.edu.cn) | Asia/Shanghai | [![China](https://flagsapi.com/CN/shiny/32.png)](https://www.openstreetmap.org/search?lat=39.9075&lon=116.3971) | 500 Mbps | :white_check_mark: | | | |
| [Netcup Germany](https://netcup-01.armbian.com) | Europe/Berlin | [![Germany](https://flagsapi.com/DE/shiny/32.png)](https://www.openstreetmap.org/search?lat=49.4478&lon=11.0683) | 2500 Mbps | :white_check_mark: | :white_check_mark: | | |
| [Netcup Germany](https://netcup-02.armbian.com) | Europe/Berlin | [![Germany](https://flagsapi.com/DE/shiny/32.png)](https://www.openstreetmap.org/search?lat=49.4478&lon=11.0683) | 2500 Mbps | :white_check_mark: | | | |
| [Netcup Germany](https://netcup-03.armbian.com) | Europe/Berlin | [![Germany](https://flagsapi.com/DE/shiny/32.png)](https://www.openstreetmap.org/search?lat=49.4478&lon=11.0683) | 2500 Mbps | :white_check_mark: | :white_check_mark: | | |
| [JetHome](https://stpete-mirror.armbian.com) | Europe/Moscow | [![Russia](https://flagsapi.com/RU/shiny/32.png)](https://www.openstreetmap.org/search?lat=59.9417&lon=30.3096) | 2000 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
| [Xogium](https://xogium.performanceservers.nl) | Europe/Paris | [![France](https://flagsapi.com/NL/shiny/32.png)](https://www.openstreetmap.org/search?lat=48.5144&lon=-2.768) | 500 Mbps | :white_check_mark: | :white_check_mark: | :white_check_mark: | |
Reference in New Issue View Git Blame Copy Permalink