Bayangkan Anda mengelola 50 server Ubuntu di kantor yang sama. Setiap kali ada update paket, ke-50 server itu masing-masing menarik data dari repository publik di internet — mengunduh paket yang sama, berulang-ulang, dari sumber yang sama pula. Hasilnya? Bandwidth internet kantor tersedot habis, proses update jadi lambat, dan biaya koneksi membengkak tanpa alasan yang jelas.

Masalah ini sangat umum ditemui oleh admin sistem, terutama di lingkungan data center, kampus, ISP kecil, atau perusahaan dengan banyak server Linux (Ubuntu/Debian). Solusinya sebenarnya sederhana: bangun repository lokal (local mirror) menggunakan apt-mirror, lalu arahkan seluruh server internal untuk mengambil paket dari mirror tersebut, bukan langsung dari internet.

Artikel ini akan membahas tuntas cara kerja apt-mirror, cara instalasi, konfigurasi, hingga cara menyajikannya ke server lain di jaringan internal — lengkap dengan kesalahan umum dan best practice yang sering luput dari tutorial lain.

Apa Itu apt-mirror dan Kenapa Anda Membutuhkannya

apt-mirror adalah tool berbasis Perl yang berfungsi menduplikasi (mirroring) seluruh atau sebagian isi repository APT resmi (seperti archive.ubuntu.com atau deb.debian.org) ke dalam server lokal Anda. Setelah proses mirroring selesai, server-server lain di jaringan internal cukup mengambil paket dari server lokal ini melalui HTTP.

Manfaat Utama

• Efisiensi bandwidth — paket hanya diunduh sekali dari internet, lalu didistribusikan berkali-kali secara lokal.
• Update lebih cepat — koneksi LAN jauh lebih cepat dibanding koneksi internet ke luar.
• Konsistensi versi paket — semua server memakai sumber paket yang identik, mengurangi risiko perbedaan versi antar mesin.
• Mendukung lingkungan offline/air-gapped — mirror bisa dipindahkan ke jaringan tertutup yang tidak punya akses internet sama sekali.
• Mengurangi beban ke server mirror publik — praktik yang lebih sopan terhadap infrastruktur mirror resmi.

Analogi Sederhana

Bayangkan apt-mirror seperti “gudang distribusi” lokal untuk minimarket waralaba. Daripada setiap cabang minimarket mengambil barang langsung dari pabrik yang jauh, mereka cukup mengambil dari gudang distribusi terdekat. Pabrik hanya perlu mengirim barang sekali ke gudang, lalu gudang yang mendistribusikan ke semua cabang secara efisien.

Persiapan Sebelum Instalasi

Sebelum mulai, pastikan beberapa hal berikut:

• Server Linux berbasis Debian/Ubuntu (fisik atau VM) yang akan berfungsi sebagai mirror server.
• Kapasitas disk yang cukup besar. Mirror penuh Ubuntu (semua komponen, semua arsitektur) bisa mencapai 500 GB–1 TB atau lebih, tergantung berapa banyak rilis dan komponen yang di-mirror. Jika hanya butuh sebagian (misalnya main untuk arsitektur amd64 saja), kebutuhan disk jauh lebih kecil.
• Koneksi internet yang stabil untuk proses sinkronisasi awal.
• Akses root/sudo di server tersebut.

Tutorial Step-by-Step: Instalasi dan Konfigurasi apt-mirror

Langkah 1 — Instal Paket apt-mirror

sudo apt update
sudo apt install apt-mirror -y

Paket ini akan otomatis membuat direktori kerja dan file konfigurasi default di /etc/apt/mirror.list.

Langkah 2 — Edit File Konfigurasi

Buka file konfigurasi utama:

sudo nano /etc/apt/mirror.list

Contoh isi konfigurasi dasar:

set base_path    /var/spool/apt-mirror
set nthreads     20
set _tilde       0

deb http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse
deb http://archive.ubuntu.com/ubuntu jammy-updates main restricted universe multiverse
deb http://archive.ubuntu.com/ubuntu jammy-security main restricted universe multiverse

clean http://archive.ubuntu.com/ubuntu

Penjelasan tiap bagian:

• base_path — lokasi penyimpanan hasil mirror di disk. Pastikan partisi ini punya ruang cukup.
• nthreads — jumlah thread paralel saat mengunduh, semakin besar semakin cepat namun makin membebani bandwidth.
• Baris deb — menentukan repository mana saja yang ingin di-mirror. Sesuaikan dengan versi distro (jammy, noble, bookworm, dll) dan komponen yang dibutuhkan.
• clean — perintah agar apt-mirror membersihkan paket lama yang sudah tidak relevan.

Tips: Jika hanya butuh arsitektur tertentu (misalnya server Anda semua amd64), tambahkan [arch=amd64] setelah kata deb untuk menghemat ruang disk secara signifikan:

deb [arch=amd64] http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse

Langkah 3 — Jalankan Proses Mirroring Pertama Kali

sudo apt-mirror

Proses ini bisa memakan waktu berjam-jam hingga berhari-hari tergantung kecepatan internet dan jumlah paket yang diunduh. Disarankan menjalankannya di dalam screen atau tmux agar proses tidak terhenti jika koneksi SSH terputus.

sudo apt install tmux -y
tmux new -s mirror
sudo apt-mirror

Langkah 4 — Sajikan Mirror melalui Web Server

Agar server lain bisa mengakses mirror ini, Anda perlu menyajikannya via HTTP menggunakan Nginx atau Apache.

Instal Nginx:

sudo apt install nginx -y

Buat konfigurasi virtual host baru:

sudo nano /etc/nginx/sites-available/apt-mirror

Isi konfigurasi:

server {
    listen 80;
    server_name mirror.internal.local;
    root /var/spool/apt-mirror/mirror;
    autoindex on;
}

Aktifkan konfigurasi:

sudo ln -s /etc/nginx/sites-available/apt-mirror /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Langkah 5 — Arahkan Client ke Mirror Lokal

Di setiap server client, edit /etc/apt/sources.list dan ganti alamat repository menjadi alamat mirror internal:

deb http://mirror.internal.local/archive.ubuntu.com/ubuntu jammy main restricted universe multiverse
deb http://mirror.internal.local/archive.ubuntu.com/ubuntu jammy-updates main restricted universe multiverse
deb http://mirror.internal.local/archive.ubuntu.com/ubuntu jammy-security main restricted universe multiverse

Lalu update:

sudo apt update

Jika berjalan lancar, client kini mengambil paket dari server lokal, bukan langsung dari internet.

Langkah 6 — Otomatisasi Sinkronisasi dengan Cron

Paket apt-mirror biasanya sudah membuat file cron otomatis di /etc/cron.d/apt-mirror. Periksa dan sesuaikan jadwalnya, misalnya setiap hari pukul 02.00 dini hari saat trafik jaringan sedang rendah:

0 2 * * *   root   /usr/bin/apt-mirror > /var/log/apt-mirror.log 2>&1

Studi Kasus Sederhana

Sebuah kampus dengan 80 unit server lab komputer berbasis Ubuntu mengalami keluhan koneksi internet lambat setiap awal semester karena seluruh lab melakukan apt update && apt upgrade secara bersamaan. Setelah admin membangun mirror lokal menggunakan apt-mirror di satu server pusat, seluruh 80 unit hanya mengambil paket dari server tersebut. Waktu update per lab yang sebelumnya memakan 2 jam berkurang menjadi kurang dari 10 menit, dan pemakaian bandwidth internet turun drastis.

Kesalahan yang Sering Terjadi

1. Disk penuh di tengah proses mirroring Penyebab: memperkirakan kebutuhan disk terlalu rendah. Dampak: proses mirror gagal dan repository menjadi tidak lengkap/rusak. Solusi: alokasikan disk dengan margin aman (minimal 2x perkiraan awal) dan pantau penggunaan disk dengan df -h secara berkala.

2. Lupa menjalankan perintah clean Penyebab: konfigurasi tanpa baris clean. Dampak: paket lama menumpuk terus tanpa dihapus, memboroskan disk. Solusi: selalu sertakan baris clean di mirror.list sesuai URL repository yang di-mirror.

3. Salah menentukan arsitektur atau komponen Penyebab: mengambil semua arsitektur (i386, arm64, dll) padahal server hanya memakai amd64. Dampak: ukuran mirror membengkak tidak perlu. Solusi: gunakan filter [arch=...] untuk membatasi arsitektur yang benar-benar dipakai.

4. Tidak memverifikasi integritas GPG key Penyebab: mengabaikan validasi signature repository. Dampak: risiko keamanan jika mirror disusupi atau proses transfer korup. Solusi: pastikan key GPG resmi tetap terpasang di client dan repository tidak diakses via HTTP tanpa validasi tambahan pada lingkungan yang sensitif.

5. Proses sinkronisasi terputus saat SSH terputus Penyebab: menjalankan apt-mirror langsung di sesi SSH biasa. Dampak: proses berhenti di tengah jalan. Solusi: selalu gunakan tmux atau screen, atau jalankan via cron/systemd service.

Tips dan Rekomendasi

• Jadwalkan sinkronisasi mirror pada jam-jam dengan trafik rendah (dini hari).
• Gunakan rsync tambahan atau tool seperti aptly atau reprepro jika butuh kontrol versi paket yang lebih presisi (misalnya membekukan snapshot repository tertentu).
• Untuk kebutuhan yang lebih ringan (tanpa menyimpan seluruh mirror), pertimbangkan apt-cacher-ng sebagai proxy caching — ia hanya menyimpan paket yang benar-benar pernah diminta, bukan seluruh repository.
• Monitor kapasitas disk secara rutin dengan du -sh /var/spool/apt-mirror.
• Batasi jumlah rilis/distribusi yang di-mirror sesuai kebutuhan riil organisasi, jangan mirror semua rilis “untuk jaga-jaga”.
• Amankan akses mirror internal dengan firewall agar hanya bisa diakses dari jaringan internal, bukan dari internet publik.

Kesimpulan

Membangun repository lokal dengan apt-mirror adalah solusi praktis dan terbukti efektif untuk organisasi yang mengelola banyak server Linux. Dengan investasi awal berupa disk yang cukup dan konfigurasi yang tepat, Anda bisa menghemat bandwidth internet secara signifikan, mempercepat proses update paket, dan menjaga konsistensi versi software di seluruh infrastruktur.

Poin penting yang perlu diingat:

• Rencanakan kapasitas disk dengan matang sebelum memulai.
• Gunakan filter arsitektur dan komponen agar mirror tidak membengkak tanpa perlu.
• Otomatisasi sinkronisasi dengan cron di jam trafik rendah.
• Amankan akses mirror hanya untuk jaringan internal.
• Pertimbangkan alternatif seperti apt-cacher-ng jika kebutuhan Anda lebih ringan.

---

Frequently Asked Questions (FAQ)

Pertanyaan: Apa perbedaan apt-mirror dengan apt-cacher-ng? Jawaban: apt-mirror mengunduh dan menyimpan seluruh isi repository yang ditentukan, sedangkan apt-cacher-ng hanya menyimpan (cache) paket yang benar-benar pernah diminta oleh client. apt-cacher-ng lebih hemat disk, sementara apt-mirror lebih cocok untuk kebutuhan mirror lengkap atau lingkungan offline.

Pertanyaan: Berapa kapasitas disk yang idealnya disiapkan untuk apt-mirror? Jawaban: Tergantung jumlah rilis dan komponen yang di-mirror. Mirror penuh bisa mencapai ratusan GB hingga lebih dari 1 TB. Sebaiknya siapkan disk dengan margin aman dan gunakan filter arsitektur untuk menghemat ruang.

Pertanyaan: Apakah apt-mirror bisa digunakan untuk lingkungan tanpa akses internet sama sekali (air-gapped)? Jawaban: Bisa. Caranya, lakukan mirroring di server yang punya akses internet, lalu pindahkan hasil mirror ke media penyimpanan eksternal dan salin ke server di jaringan tertutup.

Pertanyaan: Apakah proses sinkronisasi apt-mirror bisa dijadwalkan otomatis? Jawaban: Bisa, menggunakan cron job yang biasanya sudah otomatis dibuat oleh paket apt-mirror di /etc/cron.d/apt-mirror. Sesuaikan jadwalnya sesuai kebutuhan.

Pertanyaan: Apakah client perlu konfigurasi khusus selain mengganti sources.list? Jawaban: Umumnya tidak, cukup ganti alamat repository di sources.list menjadi alamat mirror internal, lalu jalankan apt update. Pastikan juga GPG key repository tetap terpasang di client.

---

Sudah pernah membangun repository lokal di infrastruktur Anda sendiri? Bagikan pengalaman, kendala, atau tips tambahan Anda di kolom komentar di bawah!

Jangan lupa bagikan artikel ini ke rekan sesama sysadmin atau tim DevOps yang mungkin sedang menghadapi masalah bandwidth serupa. Jelajahi juga artikel-artikel terkait lainnya seputar Linux, Networking, dan Infrastruktur IT di blog ini, dan ikuti terus untuk mendapatkan konten terbaru seputar dunia server dan sistem administrasi.