skdlb
SKUDONET
Ini adalah repositori SKUDONET Open Source Load Balancer dan Open Source WAF Community Edition ( Zen Load Balancer CE generasi berikutnya) dan ini akan memandu Anda untuk menginstal instance pengembangan dan pengujian load balancer.
Di repositori ini Anda akan menemukan kode sumber yang biasanya ditempatkan di folder /usr/local/skudonet/ dengan struktur sebagai berikut:
app/ : Aplikasi, binari, dan pustaka yang dibutuhkan SKUDONET Load Balancer.
bin/ : Direktori binari aplikasi tambahan.
backups/ : Folder default tempat cadangan konfigurasi akan ditempatkan.
config/ : Folder default tempat layanan penyeimbangan beban, pemeriksaan kesehatan, IPDS WAF, dan file konfigurasi jaringan akan ditempatkan.
dll/ : Beberapa file sistem untuk mengkonfigurasi layanan SKUDONET Load Balancer.
lib/ : Folder tempat perpustakaan fungsi Skudonet berada.
share/ : Folder untuk template dan data lainnya.
www/ : File sumber API backend dari SKUDONET Load Balancer.
other : Lisensi dan informasi readme ini. Dan /usr/share/perl5/Skudonet dengan seluruh inti backend Skudonet.
Saat ini, hanya tersedia paket untuk Debian Bookworm, instalasi tidak didukung dari sistem operasi ini.
Ada dua opsi untuk menerapkan penyeimbang beban SKUDONET: Yang pertama adalah menerapkan SKUDONET CE ISO, dan yang lainnya adalah menerapkan image Debian Bookworm dan menginstal Skudonet dengan dependensinya.
SKUDONET CE ISO adalah template Debian Bookworm yang sudah terinstal Skudonet. Itu dapat diperoleh dari tautan berikut, dengan mengklik tombol "Unduh ISO image".
https://www.skudonet.com/products/community/
Jika Anda lebih suka menginstal skudonet sendiri, Anda harus mendapatkan ISO Debian yang dapat diinstal dari debian.org. Proses instalasi ini hanya diuji dengan versi 64 bit.
Harap pertimbangkan persyaratan berikut sebelum memasang penyeimbang beban:
Anda memerlukan setidaknya 1,5 GB penyimpanan.
Instal sistem Debian Bookworm (64 bit) yang baru dan mendasar dengan openssh dan paket alat sistem dasar yang direkomendasikan selama instalasi distribusi.
Konfigurasikan penyeimbang beban dengan alamat IP statis. SKUDONET Load Balancer belum mendukung DHCP.
Konfigurasikan repositori apt agar dapat menginstal beberapa dependensi.
Repositori git ini hanya berisi kode sumber, paket yang dapat diinstal berdasarkan kode ini diperbarui di repo Skudonet APT kami, Anda dapat menggunakannya untuk mengkonfigurasi sistem Debian Bookworm Anda sebagai berikut:
root@skudonetlb#> echo "deb http://repo.skudonet.com/ce/v7 bookworm main" >> /etc/apt/sources.list.d/skudonet.list root@skudonetlb#> wget -O - http://repo.skudonet.com/ce/skudonet.com.gpg.key | apt-key add -
Sekarang, perbarui database APT lokal
root@skudonetlb#> apt-get update
Dan terakhir, instal Skudonet CE
root@skudonetlb#> apt-get install skudonet
Buka direktori untuk mengunduh OWASP CoreRuleSet
root@skudonetlb#> cd /opt
Unduh OWASP CoreRuleSet terbaru
root@skudonetlb#> wget https://github.com/coreruleset/coreruleset/archive/refs/heads/main.zip
Dekompresi file OWASP CoreRuleSet
root@skudonetlb#> unzip main.zip
Salin semua Ruleset dan data ke direktori konfigurasi SKUDONET IPDS WAF Rulesets
root@skudonetlb#> cp coreruleset-main/rules/* /usr/local/skudonet/config/ipds/waf/sets/
Salin file contoh setup ke direktori konfigurasi SKUDONET IPDS WAF Rulesets Wajib untuk setup tx.crs_setup_version
root@skudonetlb#> grep -v "^SecDefaultAction" coreruleset-main/crs-setup.conf.example > /usr/local/skudonet/config/ipds/waf/sets/REQUEST-90-CONFIGURATION.conf
Sekarang Load Balancer Sumber Terbuka SKUDONET memiliki semua Aturan OWASP dan dapat diterapkan ke HTTP/S Farms.
Silakan gunakan repo Skudonet APT untuk memeriksa apakah pembaruan tersedia.
Kesalahan Perl masuk ke file /var/log/cherokee-error.log. Log akses GUI Web masuk ke file /var/log/cherokee-access.log. Semua log perangkat lunak (log pertanian, log WAF, log SKUDONET) masuk ke file /var/log/syslog. File konfigurasi disimpan di direktori /usr/local/skudonet/config. Aturan SKUDONET WAF disimpan di direktori /usr/local/skudonet/config/ipds/waf/sets.
Anda dapat berkontribusi terhadap evolusi Load Balancer SKUDONET dalam berbagai cara:
Membuat konten : Dokumentasi di wiki proyek GitHub, terjemahan dokumen, mendokumentasikan kode sumber, dll.
Bantuan untuk pengguna lain melalui milis.
Melaporkan dan Menyelesaikan Bug dari Masalah proyek GitHub.
Pengembangan fitur baru.
Silakan gunakan Masalah proyek GitHub untuk melaporkan masalah atau bug apa pun pada perangkat lunak. Cobalah untuk menjelaskan masalahnya dan cara untuk mereproduksinya. Akan berguna untuk melampirkan konfigurasi layanan dan jaringan serta log sistem dan layanan.
Untuk melakukan perubahan apa pun, seperti fitur baru, perbaikan bug, atau peningkatan, cukup lakukan git clone dari repositori, git add ketika semua perubahan telah dibuat dan git commit ketika Anda siap mengirim perubahan.
Selama pengiriman, harap pastikan bahwa setiap perubahan dikaitkan dengan perubahan yang logis agar setiap perubahan mudah diidentifikasi.
Dalam deskripsi komit silakan gunakan format berikut:
[CATEGORY] CHANGE_SHORT_DESCRIPTION OPTIONAL_LONGER_DESCRIPTION SIGNED_OFFS MODIFIED_FILES
Di mana:
CATEGORY dapat berupa: Perbaikan bug untuk mengatasi bug atau masalah, Peningkatan untuk penyempurnaan fitur yang sudah diterapkan, atau Fitur Baru untuk pengembangan baru yang menyediakan fitur baru yang belum diimplementasikan sebelumnya.
CHANGE_SHORT_DESCRIPTION adalah penjelasan singkat terkait perubahan yang diterapkan dan memudahkan identifikasi modifikasi tersebut. Jika ini terkait dengan bug yang termasuk dalam bagian Masalah, disarankan untuk menyertakan referensi identifikasi untuk bug tersebut.
OPTIONAL_LONGER_DESCRIPTION adalah deskripsi opsional yang lebih panjang untuk menjelaskan detail tentang perubahan yang diterapkan.
SIGNED_OFFS adalah entri Signed-off-by tempat nama pengguna diikuti dengan email dapat ditempatkan.
MODIFIED_FILES adalah daftar file yang telah dimodifikasi, dibuat atau dihapus dengan komit.
Biasanya, menjalankan git commit -a -s akan membuat kolom yang dijelaskan di atas.
Terakhir, jalankan saja git push dan minta penarikan perubahan Anda. Selain itu, Anda dapat menggunakan git format-patch untuk membuat patch Anda dan mengirimkannya melalui daftar distribusi resmi.
Di wiki GitHub resmi tersedia daftar halaman dan terjemahannya. Harap kloning wiki, terapkan perubahan Anda dan minta penarikan agar dapat diterapkan.
Daftar distribusi resmi dapat diakses melalui grup google skudonet-ce-users.
Untuk memposting di grup ini, kirim email ke [email protected].
Namun Anda perlu meminta bergabung terlebih dahulu ke dalam grup dengan mengirimkan email ke [email protected].
Untuk berhenti berlangganan dari grup ini, kirim email ke [email protected]
Untuk opsi lebih lanjut, kunjungi https://groups.google.com/a/skudonet.com/d/optout
