underchat
/
ircu2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ircu2/README_SCRIPTS.md

7.9 KiB
Raw Blame History

📦 Scripturile de Instalare Automată - Rezumat Complet

🎯 Ce am Creat

Am adăugat 4 scripturi shell bash și 2 ghiduri documentare complete în limba română pentru instalare și administrare automată a Nefarious IRCd.

📜 Scripturile Incluse

1️⃣ install.sh - Instalare Automată Principală

Funcție: Automatizează complet instalarea de la clonare la pornire

Ce face:

  • ✅ Verifică dependențele (gcc, make, SSL, autoconf)
  • ✅ Rulează ./configure cu parametri optimali
  • ✅ Compilează codul sursă
  • ✅ Instalează binare și biblioteci
  • ✅ Cere date despre server (interactive)
  • ✅ Generează fișierul ircd.conf
  • ✅ Creează structura de directoare
  • ✅ Generează fișierele MOTD

Utilizare:

# Instalare standard
./install.sh

# Instalare customizată
./install.sh --prefix /opt/ircd --maxcon 8192 --debug

# Opțiuni disponibile:
  -h, --help              Ajutor
  -p, --prefix PATH       Calea de instalare
  -m, --maxcon NUM        Maxim conexiuni
  -d, --debug             Modul debug
  -s, --no-ssl            Fără SSL/TLS

2️⃣ configure-interactive.sh - Configurare Interactivă Avansată

Funcție: Ghidare step-by-step prin toate setările serverului

Ce face:

  • ✅ Etapa 1: Setări generale (nume, descriere, numeric)
  • ✅ Etapa 2: Informații administrator (locație, email)
  • ✅ Etapa 3: Configurare porturi (standard, SSL, server-to-server)
  • ✅ Etapa 4: Clase de conexiuni (maxlinks, sendq, pingfreq)
  • ✅ Etapa 5: Operatori (nick, host, parola)
  • ✅ Etapa 6: Setări avansate (AUTH, persist channels, SWHOIS)

Utilizare:

# După instalare, pentru configurare detaliată
./configure-interactive.sh

# Sau din nou din 0
./install.sh
./configure-interactive.sh

3️⃣ admin.sh - Meniu Interactiv de Administrare

Funcție: Tool grafic (TUI) pentru administrare server zilnică

Opțiuni Meniu:

1. Pornire server
2. Oprire server
3. Restart server
4. Verifica status (PID, CPU, RAM, porturi)
5. Editare configurare (cu backup automat)
6. Vizionare log-uri (tail, live, search)
7. Generare parola operator
8. Test sintaxă configurare
9. Iesire

Utilizare:

./admin.sh

# Deschide meniu interactiv cu toate opțiunile

📚 Documentare

📖 QUICKSTART.md - Start Rapid (Recomandabil pentru Începători)

Conținut:

  • Instalare în 3 comenzi
  • Ce face script-ul automat
  • Opțiuni instalare
  • Setare parola operator
  • Conectare la server
  • Comenzi utile
  • Troubleshooting rapid

Perfect pentru: Primii 5 minute

📖 INSTALL_AUTO.md - Documentație Completă

Conținut:

  • Cerințe sistem pe fiecare platforma
  • Instalare rapidă vs customizată
  • Toate opțiunile disponibile
  • Structura directoarelor post-instalare
  • Pornire și oprire server
  • Setare parola cu umkpasswd
  • Editare avansată configurare
  • Conectare la server
  • Verificare status și log-uri
  • Rezolvare probleme comune
  • Networking (link la alte servere)
  • Comenzi administrator
  • Sfaturi de securitate

Perfect pentru: Referință completă

🎓 Exemplu de Utilizare Tipic

Scenariu: Instalare Completă

# 1. Clone repository
git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2

# 2. Instalare automată (cere doar date de bază)
./install.sh
# Răspunzi la: Nume server, Descriere, Admin email, etc.

# 3. Configurare avansată (opțional, pentru setări detaliate)
./configure-interactive.sh

# 4. Generare parola operator
./admin.sh
# Alege: 7) Generare parola operator

# 5. Editare configurare dacă trebuie
nano ~/ircd/etc/ircd.conf

# 6. Pornire server
./admin.sh
# Alege: 1) Pornire server

# 7. Verificare status
./admin.sh
# Alege: 4) Verifica status

# 8. Urmărire log-uri
./admin.sh
# Alege: 6) Vizionare log-uri

# 9. Conectare client
# irc://localhost:6667

🔄 Flux de Lucru Zilnică

# Meniu central pentru administrare
./admin.sh

# De aici:
# - Pornești/oprești serverul
# - Editezi configurare cu backup automat
# - Urmărești log-urile live
# - Generezi parole operator
# - Testezi sintaxă

🌍 Suport Multiplatforma

Linux (Debian/Ubuntu)

sudo apt-get install build-essential autoconf libssl-dev
./install.sh

Linux (RHEL/CentOS)

sudo yum install gcc make autoconf openssl-devel
./install.sh

macOS

xcode-select --install
brew install autoconf libtool openssl
./install.sh

BSD/Unix

# Verifică INSTALL_AUTO.md pentru detalii
./install.sh

📋 Checklist Instalare

□ Sistem cu gcc, make, autoconf instalate
□ Spațiu pe disk suficient (~100MB)
□ Permisiuni de scriere în $HOME
□ Port 6667 disponibil (sau schimbă în config)

□ git clone https://gitlab.back.ro/underchat/ircu2.git
□ cd ircu2
□ ./install.sh
  □ Răspunde la întrebări
  □ Astepta completarea

□ ./admin.sh
  □ Alege: 7) Generare parola
  □ Alege: 1) Pornire server

□ Conectare cu IRC client
□ Verificare log-uri

GATA! ✓

🔐 Puncte Importante de Securitate

Imediat După Instalare:

  1. ✅ Schimbă parola operator

    ./admin.sh → 7) Generare parola operator

  2. ✅ Securizează fișierul de config

    chmod 600 ~/ircd/etc/ircd.conf

  3. ✅ Backup configurare

    cp ~/ircd/etc/ircd.conf ~/ircd/etc/ircd.conf.backup

  4. ✅ Configurează firewall

    sudo ufw allow 6667/tcp
sudo ufw allow 6697/tcp

  5. ✅ Monitorizează log-urile

    tail -f ~/ircd/log/ircd.log

🆘 Troubleshooting Rapid

Nu merge ./install.sh

# Verifică permisiuni
chmod +x install.sh configure-interactive.sh admin.sh

# Rulează din nou
./install.sh

Server nu pornește

./admin.sh
# 8) Test sintaxă configurare
# 4) Verifica status
# 6) Vizionare log-uri

Port deja în uz

./admin.sh
# 5) Editare configurare
# Schimbă portul în Port { port = 6668; }
# 3) Restart server

Probleme compilare

cd ircu2
make clean
./configure --enable-debug
make
make install

📊 Fișiere Noi Adăugate

ircu2/
├── install.sh                    (Instalare automată)
├── configure-interactive.sh      (Configurare avansată)
├── admin.sh                      (Meniu administrare)
├── QUICKSTART.md                (Start rapid - 5 min)
├── INSTALL_AUTO.md              (Documentație completă)
└── README_SCRIPTS.md            (Acest fișier)

🎯 Roadmap Viitor

Versiune 2.0 (Planificat)

  • Suport pentru Docker deploy
  • Monitoring dashboard (web UI)
  • Backup/restore automat
  • Multi-server management
  • Plugin system
  • Statistics & analytics

📞 Suport & Feedback

Documentație:

  • QUICKSTART.md - Start rapid
  • INSTALL_AUTO.md - Referință completă
  • CLAUDE.md - Detalii tehnisce
  • doc/example.conf - Config detaliat

Probleme comune:

  • Citește INSTALL_AUTO.md secțiunea "Rezolvare probleme"

Updates:

  • git pull origin main pentru latest versiune

✨ Caracteristici Script-uri

Feature install.sh configure-interactive.sh admin.sh
Instalare automată ✅ - -
Configurare interactivă ✅ ✅ -
Pornire server - - ✅
Oprire/Restart - - ✅
Status monitoring - - ✅
Editare config - ✅ ✅
Log viewing - - ✅
Parola generator ✅ ✅ ✅
Config testing - ✅ ✅

🎓 Versiunea & Info

  • Data creării: 13 februarie 2026
  • Versiune: 1.0
  • Limbă: Română 🇷🇴
  • Platform: Linux, macOS, BSD, Unix
  • Licență: GNU General Public License (din ircu2)

🚀 Start Acum!

git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2
./install.sh

În 5-10 minute, serverul tău IRC e gata! ✨

Succes cu instalarea! 🎉