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