From 40c16e28da32b8382fd886bd5eb157ef9e70bbb8 Mon Sep 17 00:00:00 2001 From: mihaiitdata Date: Fri, 13 Feb 2026 00:13:06 +0200 Subject: [PATCH] =?UTF-8?q?Adaug=C4=83=20README=5FSCRIPTS.md=20-=20rezumat?= =?UTF-8?q?=20scripturilor=20de=20instalare?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README_SCRIPTS.md | 393 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 393 insertions(+) create mode 100644 README_SCRIPTS.md diff --git a/README_SCRIPTS.md b/README_SCRIPTS.md new file mode 100644 index 0000000..b6f8902 --- /dev/null +++ b/README_SCRIPTS.md @@ -0,0 +1,393 @@ +# 📦 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:** +```bash +# 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:** +```bash +# 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:** +```bash +./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ă + +```bash +# 1. Clone repository +git clone https://gitlab.back.ro/itdata/underchat-ircd.git +cd underchat-ircd + +# 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ă + +```bash +# 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) +```bash +sudo apt-get install build-essential autoconf libssl-dev +./install.sh +``` + +### Linux (RHEL/CentOS) +```bash +sudo yum install gcc make autoconf openssl-devel +./install.sh +``` + +### macOS +```bash +xcode-select --install +brew install autoconf libtool openssl +./install.sh +``` + +### BSD/Unix +```bash +# 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/itdata/underchat-ircd.git +□ cd underchat-ircd +□ ./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** + ```bash + ./admin.sh → 7) Generare parola operator + ``` + +2. ✅ **Securizează fișierul de config** + ```bash + chmod 600 ~/ircd/etc/ircd.conf + ``` + +3. ✅ **Backup configurare** + ```bash + cp ~/ircd/etc/ircd.conf ~/ircd/etc/ircd.conf.backup + ``` + +4. ✅ **Configurează firewall** + ```bash + sudo ufw allow 6667/tcp + sudo ufw allow 6697/tcp + ``` + +5. ✅ **Monitorizează log-urile** + ```bash + tail -f ~/ircd/log/ircd.log + ``` + +--- + +## 🆘 Troubleshooting Rapid + +### Nu merge ./install.sh +```bash +# Verifică permisiuni +chmod +x install.sh configure-interactive.sh admin.sh + +# Rulează din nou +./install.sh +``` + +### Server nu pornește +```bash +./admin.sh +# 8) Test sintaxă configurare +# 4) Verifica status +# 6) Vizionare log-uri +``` + +### Port deja în uz +```bash +./admin.sh +# 5) Editare configurare +# Schimbă portul în Port { port = 6668; } +# 3) Restart server +``` + +### Probleme compilare +```bash +cd underchat-ircd +make clean +./configure --enable-debug +make +make install +``` + +--- + +## 📊 Fișiere Noi Adăugate + +``` +underchat-ircd/ +├── 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 underchat-ircd) + +--- + +## 🚀 Start Acum! + +```bash +git clone https://gitlab.back.ro/itdata/underchat-ircd.git +cd underchat-ircd +./install.sh +``` + +**În 5-10 minute, serverul tău IRC e gata!** ✨ + +--- + +**Succes cu instalarea!** 🎉 +