Adaugă QUICKSTART guide pentru instalare rapidă
This commit is contained in:
parent
d2cf773cd3
commit
e264e5399c
|
|
@ -0,0 +1,356 @@
|
||||||
|
# 🚀 Quick Start - Instalare Rapidă Nefarious IRCd
|
||||||
|
|
||||||
|
## ⚡ Instalare în 3 Comenzi
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Clonează repository-ul
|
||||||
|
git clone https://gitlab.back.ro/itdata/underchat-ircd.git
|
||||||
|
cd underchat-ircd
|
||||||
|
|
||||||
|
# 2. Execută instalarea (va cere informații)
|
||||||
|
./install.sh
|
||||||
|
|
||||||
|
# 3. Pornește serverul
|
||||||
|
~/ircd/bin/ircd
|
||||||
|
```
|
||||||
|
|
||||||
|
**Gata!** 🎉 Serverul tău IRC e pornit pe `localhost:6667`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Ce face Script-ul Automat
|
||||||
|
|
||||||
|
```
|
||||||
|
✓ Verifică dependențele (gcc, make, SSL)
|
||||||
|
✓ Configureaza proiectul cu setări optime
|
||||||
|
✓ Compilează codul sursă C
|
||||||
|
✓ Instaleaza binare și biblioteci
|
||||||
|
✓ Cere date de bază (nume, admin, porturi)
|
||||||
|
✓ Generează fișierul ircd.conf
|
||||||
|
✓ Creează structura de directoare
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎮 Opțiuni de Instalare
|
||||||
|
|
||||||
|
### Standard (Recomandat)
|
||||||
|
```bash
|
||||||
|
./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Cu Configurare Interactivă Avansată
|
||||||
|
```bash
|
||||||
|
./install.sh
|
||||||
|
./configure-interactive.sh # Pentru setări detaliate
|
||||||
|
```
|
||||||
|
|
||||||
|
### Customizat
|
||||||
|
```bash
|
||||||
|
# Prefix diferit
|
||||||
|
./install.sh --prefix /opt/ircd
|
||||||
|
|
||||||
|
# Maxim conexiuni mai mare
|
||||||
|
./install.sh --maxcon 8192
|
||||||
|
|
||||||
|
# Cu debug
|
||||||
|
./install.sh --debug
|
||||||
|
|
||||||
|
# Fără SSL
|
||||||
|
./install.sh --no-ssl
|
||||||
|
|
||||||
|
# Combinație
|
||||||
|
./install.sh --prefix /var/ircd --maxcon 16384 --debug
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔑 Setare Parola Operator
|
||||||
|
|
||||||
|
După instalare, generează parola pentru operator:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Generează hash
|
||||||
|
~/ircd/bin/umkpasswd
|
||||||
|
# Introdu parola 2x
|
||||||
|
# Copiază hash-ul
|
||||||
|
|
||||||
|
# Editează config și înlocuiește password
|
||||||
|
nano ~/ircd/etc/ircd.conf
|
||||||
|
# Cauta: Operator { password = "..."; }
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🖥️ Administrare Server
|
||||||
|
|
||||||
|
Am inclus o interfață de administrare complet automată:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./admin.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Meniu opciuni:**
|
||||||
|
1. Pornire server
|
||||||
|
2. Oprire server
|
||||||
|
3. Restart server
|
||||||
|
4. Verifica status
|
||||||
|
5. Editare configurare
|
||||||
|
6. Vizionare log-uri
|
||||||
|
7. Generare parola operator
|
||||||
|
8. Test sintaxă configurare
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📁 După Instalare - Directoare
|
||||||
|
|
||||||
|
```
|
||||||
|
~/ircd/
|
||||||
|
├── bin/
|
||||||
|
│ ├── ircd ← Executable principal
|
||||||
|
│ ├── umkpasswd ← Generator parole
|
||||||
|
│ └── ...
|
||||||
|
├── etc/
|
||||||
|
│ ├── ircd.conf ← EDITEAZĂ ASTA
|
||||||
|
│ ├── ircd.motd
|
||||||
|
│ └── ircd.opermotd
|
||||||
|
├── log/
|
||||||
|
│ └── ircd.log ← Log-uri server
|
||||||
|
└── var/
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🌐 Conectare la Server
|
||||||
|
|
||||||
|
Folosind orice IRC client:
|
||||||
|
|
||||||
|
```
|
||||||
|
Server: localhost
|
||||||
|
Port: 6667 (normal) sau 6697 (SSL)
|
||||||
|
Nick: nickname_ales
|
||||||
|
```
|
||||||
|
|
||||||
|
Sau cu comanda:
|
||||||
|
```bash
|
||||||
|
irc://localhost:6667
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 Comenzi Útile
|
||||||
|
|
||||||
|
### Status Server
|
||||||
|
```bash
|
||||||
|
# Verifica dacă e pornit
|
||||||
|
ps aux | grep ircd
|
||||||
|
|
||||||
|
# Porturi ascultate
|
||||||
|
netstat -tlnp | grep ircd
|
||||||
|
|
||||||
|
# Log-uri live
|
||||||
|
tail -f ~/ircd/log/ircd.log
|
||||||
|
```
|
||||||
|
|
||||||
|
### Control Server
|
||||||
|
```bash
|
||||||
|
# Restart
|
||||||
|
~/ircd/bin/ircd -r
|
||||||
|
|
||||||
|
# Cu debug
|
||||||
|
~/ircd/bin/ircd -d
|
||||||
|
|
||||||
|
# Verifica config
|
||||||
|
~/ircd/bin/ircd -c
|
||||||
|
```
|
||||||
|
|
||||||
|
### Administrator
|
||||||
|
```
|
||||||
|
/OPER root password ← Login operator
|
||||||
|
/STATS c ← Statistici
|
||||||
|
/LUSERS ← Lista utilizatori
|
||||||
|
/WALLOPS "mesaj" ← Mesaj operatori
|
||||||
|
/KILL nick razlog ← Ban utilizator
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Documentație Completă
|
||||||
|
|
||||||
|
Pentru detalii complete, citește:
|
||||||
|
|
||||||
|
- **INSTALL_AUTO.md** - Documentație instalare detaliată
|
||||||
|
- **CLAUDE.md** - Documentație tehnică
|
||||||
|
- **doc/example.conf** - Exemplu complet configurare
|
||||||
|
- **doc/readme.features** - Lista caracteristici
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ Configurare Avansată
|
||||||
|
|
||||||
|
### Conectare la alte servere (Linking)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano ~/ircd/etc/ircd.conf
|
||||||
|
|
||||||
|
# Adaugă în config:
|
||||||
|
Connect {
|
||||||
|
name = "server2.example.com";
|
||||||
|
host = "192.168.1.100";
|
||||||
|
port = 6666;
|
||||||
|
password = "link_password_hash";
|
||||||
|
class = "servers";
|
||||||
|
};
|
||||||
|
|
||||||
|
# Restart
|
||||||
|
./admin.sh # Alege opțiunea 3 (Restart)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Porturi Personalizate
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano ~/ircd/etc/ircd.conf
|
||||||
|
|
||||||
|
# Cauta Port { } și modifică:
|
||||||
|
Port {
|
||||||
|
port = 6668; ← Schimbă portul
|
||||||
|
mask = 0.0.0.0;
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### SSL/TLS Certificat
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Generează certificat auto-semnat (testing)
|
||||||
|
openssl req -x509 -newkey rsa:2048 -keyout ircd.pem -out ircd.pem -days 365 -nodes
|
||||||
|
|
||||||
|
# Mută în directorul config
|
||||||
|
mv ircd.pem ~/ircd/etc/
|
||||||
|
|
||||||
|
# Editează config pentru SSL
|
||||||
|
nano ~/ircd/etc/ircd.conf
|
||||||
|
# Setează certificate path
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔒 Securitate
|
||||||
|
|
||||||
|
### Schimbă Parola Operator
|
||||||
|
```bash
|
||||||
|
./admin.sh
|
||||||
|
# Alege: 7) Generare parola operator
|
||||||
|
# Editează config cu noua parola
|
||||||
|
```
|
||||||
|
|
||||||
|
### Restricționează Acces
|
||||||
|
```bash
|
||||||
|
# Restricționer port (firewall)
|
||||||
|
sudo ufw allow 6667/tcp
|
||||||
|
sudo ufw allow 6697/tcp
|
||||||
|
|
||||||
|
# Sau cu iptables
|
||||||
|
sudo iptables -A INPUT -p tcp --dport 6667 -j ACCEPT
|
||||||
|
```
|
||||||
|
|
||||||
|
### Backupuri
|
||||||
|
```bash
|
||||||
|
# Backup configurare
|
||||||
|
cp ~/ircd/etc/ircd.conf ~/ircd/etc/ircd.conf.backup
|
||||||
|
|
||||||
|
# Backup complet
|
||||||
|
tar -czf ircd_backup_$(date +%Y%m%d).tar.gz ~/ircd/
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🐛 Troubleshooting
|
||||||
|
|
||||||
|
### Server nu pornește
|
||||||
|
```bash
|
||||||
|
# Verifică erori
|
||||||
|
tail -20 ~/ircd/log/ircd.log
|
||||||
|
|
||||||
|
# Testează config
|
||||||
|
~/ircd/bin/ircd -c
|
||||||
|
|
||||||
|
# Debug mode
|
||||||
|
~/ircd/bin/ircd -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### Port deja folosit
|
||||||
|
```bash
|
||||||
|
# Verifică ce folosește portul
|
||||||
|
lsof -i :6667
|
||||||
|
|
||||||
|
# Schimbă portul în config
|
||||||
|
nano ~/ircd/etc/ircd.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
### Probleme compilare
|
||||||
|
```bash
|
||||||
|
# Curață și recompilează
|
||||||
|
cd underchat-ircd
|
||||||
|
make clean
|
||||||
|
./configure --enable-debug
|
||||||
|
make
|
||||||
|
make install
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📞 Ajutor Rapid
|
||||||
|
|
||||||
|
**Ne.test rapid:**
|
||||||
|
```bash
|
||||||
|
./install.sh && ./admin.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Doar configurare:**
|
||||||
|
```bash
|
||||||
|
./configure-interactive.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Update repository:**
|
||||||
|
```bash
|
||||||
|
cd underchat-ircd
|
||||||
|
git pull origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✨ Sfaturi Finale
|
||||||
|
|
||||||
|
1. **Testează local prima dată** - `localhost:6667`
|
||||||
|
2. **Citește INSTALL_AUTO.md** - Pentru detalii complete
|
||||||
|
3. **Inspectează log-urile** - `tail -f ~/ircd/log/ircd.log`
|
||||||
|
4. **Backup configurarea** - Înainte de editări mari
|
||||||
|
5. **Urmărește comunitatea** - Pentru updates și tips
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Data**: 13 februarie 2026
|
||||||
|
**Limbă**: Română 🇷🇴
|
||||||
|
**Versiune**: 1.0
|
||||||
|
**Support**: Citește documentația din `doc/`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Gata? Start!
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone
|
||||||
|
git clone https://gitlab.back.ro/itdata/underchat-ircd.git && cd underchat-ircd
|
||||||
|
|
||||||
|
# Install
|
||||||
|
./install.sh
|
||||||
|
|
||||||
|
# Start
|
||||||
|
~/ircd/bin/ircd
|
||||||
|
|
||||||
|
# Admin
|
||||||
|
./admin.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Succes!** 🚀
|
||||||
|
|
||||||
Loading…
Reference in New Issue