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