2026-02-23 23:50:50 +02:00
2026-02-13 17:29:37 +02:00

🚀 Underchat IRCU2 - UnderChat IRCd

Repository: https://gitlab.back.ro/underchat/ircu2.git
Limbă: Română 🇷🇴
Data: 15 februarie 2026
Versiune: v1.7.5 🔒🎨📡
Status: ✅ Production Ready - SECURIZAT + PERSONALIZAT + MONITORING COMPLET
Features: 149 (74.5% complete) + SNOMASK Notifications (OPMODE included)


📖 Descriere

Underchat IRCU2 este o distribuție profesională a UnderChat IRCd - un server IRC avansat bazat pe protocolul P10. Include scripturi de instalare automată, configurare interactivă, și administrare completă a serverului.


✨ Caracteristici Principale

🚀 Instalare Automată

  • ✅ Script install.sh - Complet automatizat
  • ✅ Verificare dependențe automate
  • ✅ Compilare și instalare
  • ✅ Suport aarch64 (ARM 64-bit)

⚙️ Configurare Profesională

  • ✅ Model bazat pe node-ase.ovh
  • ✅ 8 secțiuni configurare
  • ✅ 40+ features avansate
  • ✅ Domeniu underchat.org preconfiguarat

👥 Managementul Operatorilor

  • ✅ Cerere interactivă username
  • ✅ Parola cu validare și criptare automată
  • ✅ Format hash PLAIN ready

🌐 Server-to-Server Linking

  • ✅ Configurare link-uri server-to-server (independent de HUB/LEAF)
  • ✅ Autoconnect activat - Serverul se reconectează automat la HUB
  • ✅ Interfață interactivă pentru: nume server, IP, port, parolă
  • ✅ Generare automată bloc Connect {} în ircd.conf
  • ✅ Flexibilitate maximă - orice topologie de rețea
  • ✅ Separare clară între HUB flag și configurarea link-urilor

🛠️ Administrare

  • ✅ Meniu TUI admin.sh
  • ✅ Pornire/oprire/restart
  • ✅ Editare config cu backup
  • ✅ Monitorizare status și log-uri

📖 Documentație Completă

  • ✅ 9+ ghiduri în limba română
  • ✅ Exemple practice
  • ✅ Troubleshooting complet
  • ✅ Quick start (5 minute)

🚀 Quick Start

1. Clone Repository

git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2

2. Instalare (3 comenzi)

./install.sh
# Răspunde la întrebări (Server, Admin, Operator, HUB)
# Script generează config automat

3. Administrare

./admin.sh
# Meniu pentru:
# - Pornire/oprire server
# - Editare configurare
# - Monitorizare status
# - Log viewing

4. Conectare

Server: localhost
Port: 6667 (normal) sau 6697 (SSL)
Nick: nickname

📋 Scripturi Incluse

install.sh (Instalare Automată)

./install.sh
# - Verifică dependențe (gcc, make, SSL)
# - Detectează platformă (Linux, BSD, macOS, aarch64)
# - Configureaza și compileaza
# - Cere date server (domeniu, nume, numeric)
# - Cere date operator (username, parola)
# - Cere tip server (HUB/Leaf)
# - Dacă HUB, cere info linking
# - Generează ircd.conf complet

admin.sh (Meniu Administrare)

./admin.sh
# Opțiuni:
# 1. Pornire server (cu verificări avansate v1.0.2)
# 2. Oprire server
# 3. Restart server
# 4. Verifica status
# 5. Editare configurare
# 6. Vizionare log-uri
# 7. Generare parola operator
# 8. Test sintaxă (cu diagnosticare detaliată v1.0.2)

diagnose.sh (Diagnosticare Probleme) 🆕 v1.0.2

./diagnose.sh
# - Verificare existență și permisiuni config
# - Verificare conținut și sintaxă
# - Detectare probleme comune (acolade, ghilimele)
# - Test compilare cu ircd -c
# - Raport complet cu soluții

configure-interactive.sh (Configurare Avansată)

./configure-interactive.sh
# 6 etape interactive:
# 1. Setări generale
# 2. Informații admin
# 3. Configurare porturi
# 4. Clase de conexiuni
# 5. Operatori
# 6. Caracteristici avansate

admin.sh (Meniu Administrare)

./admin.sh
# Opțiuni:
# 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ă

fix-aarch64.sh (Fix ARM 64-bit)

./fix-aarch64.sh
# Fixare automată config.guess pentru aarch64
# Backup config
# Patch dinamic
# Test validare

📖 Documentație

Ghiduri Rapide

  • QUICKSTART.md - Start în 5 minute
  • CONFIGURARE_PROFESIONALA.md - Model profesional

Referințe Detaliate

  • INSTALL_AUTO.md - Instalare completă
  • OPERATORI_HUB_LINKING.md - Operatori + HUB
  • FIX_AARCH64.md - Support ARM
  • COMANDA_CONFIGURE.md - Parametrii ./configure

Troubleshooting

  • TROUBLESHOOTING_CONFIG_READ.md - Erori de citire config 🆕 v1.0.2

Overview & Index

  • INDEX.md - Roadmap complet
  • README_SCRIPTS.md - Descriere scripturi
  • CLAUDE.md - Detalii tehnice

🌍 Platforme Suportate

OS Status Note
Ubuntu/Debian ✅ Full Testat
RHEL/CentOS ✅ Full Instrucțiuni
macOS ✅ Full Instrucțiuni
FreeBSD ✅ Full Instrucțiuni
Oracle Linux ARM ✅ Full Fix aarch64
Solaris ⚠️ Legacy Instrucțiuni

🔧 Opțiuni Instalare

Standard

./install.sh

Custom Path

./install.sh --prefix /opt/ircd

Cu Maxim Conexiuni

./install.sh --maxcon 8192

Cu Debug

./install.sh --debug

Fără SSL

./install.sh --no-ssl

📁 Structură După Instalare

~/ircd/
├── bin/
│   ├── ircd                 ← Server main
│   ├── umkpasswd           ← Password generator
│   └── ...
├── etc/
│   ├── ircd.conf           ← Configurare
│   ├── ircd.motd           ← Message of the Day
│   └── ircd.opermotd       ← Operator MOTD
├── log/
│   └── ircd.log            ← Log file
└── var/
    └── ...

🎯 Exemple Utilizare

Server Leaf (NU e HUB)

./install.sh
# Răspunzi: domain, server name, operator, NO la HUB
# → Generates leaf server config

Server HUB

./install.sh
# Răspunzi: domain, server name, operator, YES la HUB
# Cereri: HUB name, IP, port, password
# → Generates HUB config cu Connect block

Dezvoltare/Testing

./install.sh --prefix /tmp/test --debug --maxcon 100

🔐 Securitate

După instalare:

  1. ✅ Schimbă parola operator
  2. ✅ Securizează config: chmod 600 ~/ircd/etc/ircd.conf
  3. ✅ Backup config: cp ~/ircd/etc/ircd.conf ~/ircd/etc/ircd.conf.backup
  4. ✅ Firewall rules: ufw allow 6667/tcp
  5. ✅ Monitorizează log-uri: tail -f ~/ircd/log/ircd.log

📊 Features

Server

  • ✅ Protocol P10
  • ✅ Event engines (epoll, kqueue, /dev/poll)
  • ✅ SSL/TLS support
  • ✅ IPv4 și IPv6 ready
  • ✅ Host hiding
  • ✅ Dynamic configuration

Clienți

  • ✅ Maxim customizable conexiuni
  • ✅ Auto-join channels
  • ✅ CTCP versioning
  • ✅ GeoIP support
  • ✅ Account persistence

Servere

  • ✅ Hub linking
  • ✅ Network synchronization
  • ✅ Server-to-server encryption
  • ✅ Custom routing rules

🆘 Troubleshooting

Instalare

# Check dependencies
./install.sh --help

# Manual fix config.guess (aarch64)
./fix-aarch64.sh

# Revert la backup
git checkout -- config.guess config.sub

Server

# Verifică config sintaxă
~/ircd/bin/ircd -c

# Debug mode
~/ircd/bin/ircd -d

# Check logs
tail -f ~/ircd/log/ircd.log

Networking

# Port deja în uz
lsof -i :6667

# Schimbă port în config
nano ~/ircd/etc/ircd.conf

# Restart
./admin.sh → 3) Restart

📚 Referințe

Documentație Proiect

  • doc/example.conf - Config detaliat
  • doc/p10.txt - Protocol P10
  • doc/readme.features - Features

Comenzi IRC

/OPER username password   - Login operator
/STATS u                  - Uptime
/STATS c                  - Conexiuni
/LUSERS                   - Utilizatori
/WALLOPS "mesaj"          - Operator message

📞 Support

Probleme Instalare

→ Citește INSTALL_AUTO.md secțiunea Troubleshooting

Probleme Configurare

→ Citește CONFIGURARE_PROFESIONALA.md

Probleme aarch64

→ Citește FIX_AARCH64.md

Probleme Operatori

→ Citește OPERATORI_HUB_LINKING.md


📝 Changelog

[v1.0.2] - 13 februarie 2026

  • ✅ Nou: Script diagnose.sh pentru diagnosticare automată probleme
  • ✅ Îmbunătățit: admin.sh cu verificări extinse de permisiuni și citire config
  • ✅ Îmbunătățit: Funcția start_server() cu diagnosticare detaliată
  • ✅ Îmbunătățit: Funcția test_config() cu rapoarte detaliate
  • ✅ Fix: Detectare probleme de permisiuni la citirea config
  • ✅ Documentație: TROUBLESHOOTING_CONFIG_READ.md pentru erori comune

[v1.0.1] - 13 februarie 2026

  • ✅ Fix: Adăugare pauze în admin.sh pentru vizualizare output
  • ✅ Utilizatorul poate acum vedea erorile și mesajele înainte de revenirea la meniu
  • ✅ Fiecare funcție din admin.sh așteaptă apăsarea Enter după execuție
  • ✅ Îmbunătățire experiență utilizator în troubleshooting

[v1.0.0] - 13 februarie 2026

  • ✅ Release inițial
  • ✅ Instalare automată completă
  • ✅ Configurare profesională
  • ✅ Suport operatori și HUB linking
  • ✅ Documentație în limba română

📜 Licență

UnderChat IRCd este sub GNU General Public License.

Toate scripturile și documentația adăugate sunt sub aceeași licență.


🎉 Status

✅ Instalare automată
✅ Configurare profesională
✅ Managementul operatorilor
✅ HUB linking automat
✅ Suport aarch64
✅ Documentație completă
✅ Limba română
✅ Production ready

🚀 Gata?

# Clone
git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2

# Install
./install.sh

# Admin
./admin.sh

Succes! 🎉


Repository: https://gitlab.back.ro/underchat/ircu2.git
Data: 13 februarie 2026
Versiune: v1.0.1
Status: ✅ Production Ready

S
Description
IRCd v2 UnderChat Network
https://underchat.org
Readme
3.2 MiB
0 Stars 1 Watchers 0 Forks
Languages
C 79.8%
Shell 6.8%
TypeScript 5%
Perl 2.3%
Makefile 2.2%
Other 3.9%