Adaugă README_SCRIPTS.md - rezumat scripturilor de instalare
This commit is contained in:
mihaiitdata
parent
e264e5399c
commit
40c16e28da
|
|
@ -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!** 🎉
|
||||||
|
|
||||||
Loading…
Reference in New Issue