Vai al contenuto
Home » IL Blog del mondo IRC e Linux » Installazione e configurazione KiwiIRC

Installazione e configurazione KiwiIRC

Installazione e configurazione kiwiirc web client

Download e installazione di KiwiIRC

Per L’ Installazione e configurazione KiwiIRC è il caso di scaricare il pacchetto corretto per il tuo sistema ed installarlo usando i tuoi soliti metodi di installazione. Puoi trovare l’elenco completo degli installatori qui.

QUi trovi un articolo che parla dei migliori client IRC per linux

 

Configurazione di KiwiIRC

L’ operazione di Installazione e configurazione KiwiIRC continua. Una volta installato kiwiIrc, troverai i file di configurazione in /etc/kiwiirc/ che puoi modificare per impostare la rete IRC e altre impostazioni.

Esistono file separati per il server e il client. Il server è volutamente mantenuto il più semplice possibile per mantenerlo leggero e sicuro. Qui è dove limiterai le reti IRC a cui gli utenti possono connettersi e aggiungerai password webirc/cgi:irc. Qui è dove vengono effettuate tutte le connessioni IRC per conto del client situato nel browser degli utenti.

Il file di configurazione del client gestisce l’aspetto della pagina Web, il modo in cui viene caricata e le impostazioni client predefinite visualizzate dai tuoi utenti.

 

Il server kiwiIRC

config.conf è il file di configurazione del server che ti consente di inserire nella whitelist o bloccare le reti IRC a cui i tuoi utenti possono connettersi. Questo anche dove sono impostate le tue password webirc o cgi:irc.

Nota: le reti IRC sono indicate come upstream nel file di configurazione.

Se stai usando Kiwi IRC per una singola rete, puoi modificare l’esempio upstream chiamato [upstream.1] . Per impostazione predefinita, gli utenti che utilizzano questo server potranno connettersi solo a questo upstream ed a nessun altro.

In questa guida ammettiamo che vogliamo che questo server sia disponibile su chat.example.com, porta 80 che è la porta HTTP standard da utilizzare per i siti web. Nella sezione [server.1] , assicurati che la porta sia impostata su 80 e modifica qualsiasi altra impostazione in base al tuo ambiente. Per casi semplici, l’impostazione predefinita dovrebbe funzionare immediatamente.

Una volta che sei soddisfatto delle tue impostazioni, ora puoi riavviare il server tramite ‘service kiwiirc restart’ per rendere effettive le impostazioni.

Considerazioni sulla sicurezza

La guida all’ Installazione e configurazione KiwiIRC parla anche di sicurezza.  Per impostazione predefinita, chiunque può connettersi al tuo server da qualsiasi sito web. Nella maggior parte dei casi questo non è auspicabile in quanto apre il tuo server ad abusi. Ad esempio, qualcuno potrebbe mettere la propria versione di Kiwi IRC su un sito web popolare che si connette automaticamente al tuo server causando un’ondata di spam.

Per ovviare a questo problema, il server ti consente di autorizzare siti Web specifici che potrebbero connettersi al tuo server. Questo fa uso delle intestazioni del browser “Origin” che tutti i browser utilizzano oggi.

Nel file di configurazione è presente una sezione [allowed_origins] in cui è possibile elencare i nomi di dominio del sito Web a cui si desidera consentire la connessione. Puoi usare i caratteri jolly qui. Ad esempio, se hai un sito web example.com, potresti voler consentire a *.example.com di consentire tutti i sottodomini (e HTTP/HTTPS) sul tuo sito web.

 

Il client KiwiIRC

client.json è la configurazione del client. Per impostazione predefinita, questo file in formato json viene caricato dopo che la pagina web è stata caricata, ma può essere trovato in diversi modi per integrarsi meglio con il tuo sito web esistente.

Per questa guida rapida supponiamo che tu stia configurando Kiwi IRC per una singola rete. Il file di configurazione di esempio dovrebbe farti uscire dalla scatola ma dovrai cambiare l’indirizzo di rete IRC a cui vuoi che gli utenti si connettano. Qui puoi anche cambiare il nickname predefinito con cui gli utenti vengono accolti, usando un ?carattere per inserire un numero casuale. Per esempio. “Utente?” sarà cambiato in qualcosa come “Utente12”.

Nota: durante la modifica e il test del file di configurazione, ricorda di cancellare o disabilitare la cache del browser in modo da ricevere ogni volta le ultime modifiche!

 

Avvio del client web

Una volta che i 2 file di configurazione sono stati impostati, dovresti essere pronto per avviare il client nel tuo browser.

Poiché in questa guida impostiamo il server in ascolto sulla porta 80, ora possiamo andare avanti e aprire http://yourserverip/ nel nostro browser e vederlo caricare con grande successo.

Se non trova il sito Web, assicurati che la porta del tuo server non sia bloccata da alcun firewall e che nessun altro software stesse utilizzando la stessa porta prima di avviare il server kiwi.

 

Installazione e configurazione KiwiIRC continua:

OPZIONI DI CONFIGURAZIONE:

La configurazione del client è un oggetto JSON caricato prima dell’avvio di Kiwi IRC. Se non è possibile trovare una configurazione o si verifica un errore di caricamento, verrà visualizzato un messaggio di errore sulla pagina e il client non si avvierà.

Caricamento del file di configurazione

Una configurazione può essere caricata da un numero di posti a seconda di quale si adatta meglio al tuo ambiente. Se disponi di un sito Web esistente in PHP, Ruby, NodeJS, Java o qualsiasi altro linguaggio dinamico, puoi persino generare la configurazione al volo per integrare meglio il client nel tuo sito Web.

Le seguenti posizioni vengono controllate in ordine.

Usa una funzione javascript

La funzione javascript window.kiwiConfigviene controllata prima di ogni altra cosa. Se esiste, verrà chiamato e il valore restituito dovrebbe essere l’oggetto config, esattamente lo stesso della struttura config.json.

Specifica una posizione URL

Puoi specificare l’URL del tuo file di configurazione JSON in un meta tag denominato kiwiconfignella pagina del client (index.html). Esempio:<meta name="kiwiconfig" content="http://example.com/path/to/config.json">

Stringa JSON direttamente nella pagina

Se stai generando tu stesso la configurazione JSON, puoi includerla direttamente nella pagina del client (index.html) in un tag di script denominato kiwiconfig. Come bonus aggiuntivo, ciò salverà una richiesta HTTP rendendo più veloce il caricamento.

Esempio:

< nome script  =" kiwiconfig " > { "startupScreen" : "customServer" , "startupOptions" : { "server" : "irc.freenode.net" , "port" : 6697 , "tls" : true , "direct" : false , "nick" : "" } } </ script >

Semplice config.json

Carica il file JSON da static/config.json

Formato di configurazione

Le opzioni di configurazione sono in formato JSON utilizzando un oggetto semplice. Esempio: {"option1": "value", "option2": true}.

Puoi utilizzare oggetti JSON nidificati o semplici notazioni tratteggiate. Questi due file di configurazione sono equivalenti:

{
     "startupOptions" : {
         "server" : " irc.example.com "
    }
}
{
     "startupOptions.server" : " irc.example.com " 
}

Notazione punteggiata

La notazione punteggiata viene analizzata dopo il caricamento della configurazione. Ciò semplifica le configurazioni generate al volo e sovrascrive una configurazione predefinita.

Ciò significa che questo:

{
     "startupOptions" : {
         "server" : " irc.example.com "
    },
    "startupOptions.server" : " irc.otherserver.com " 
}

finisce per essere questo:

{
     "startupOptions" : {
         "server" : " irc.otherserver.com "
    }
}

Installazione e configurazione KiwiIRC e le varie opzioni di setting

Un elenco completo delle opzioni di configurazione può essere trovato qui

windowTitle

Esempio: “La mia rete IRC”

Il titolo della pagina web. Questo appare nella scheda del browser e nei gestori dei segnalibri quando viene aggiunto un segnalibro.

startupScreen

Esempio: “customServer”

La schermata che viene mostrata per prima. Maggiori informazioni su questo possono essere trovate qui

kiwiServer

Esempio: ” http://example.com/config.json ”

L’URL del tuo server kiwi. Maggiori informazioni su questo possono essere trovate qui

restricted

Esempio: trueofalse

Se impostato su true, Kiwi IRC potrà connettersi solo alla rete specificata.

themes

I temi qui elencati saranno disponibili nel client. Ci deve essere almeno un tema qui. L’URL dovrebbe puntare solo alla cartella del tuo tema che contiene il tuo theme.cssfile. Esempio:

[
  { "name": "Default", "url": "static/themes/default/" },
  { "name": "Theme2", "url": "static/themes/theme2/" },
  { "name": "Other Theme", "url": "http://example.com/kiwi_theme/" }
]

Se aggiungi un tema denominato custom, ciò consentirà all’utente di impostare temporaneamente il proprio URL del tema. Utile per i designer e per provare diversi temi.

theme

Esempio: “default”

Il nome del tema predefinito da utilizzare. Questo nome deve essere nell’elenco dei temi disponibili.

embedly.key

Esempio:  “embedly API key”

Kiwi IRC utilizza il servizio embedly per mostrare un’anteprima dei collegamenti direttamente all’interno del client. Se disponi di una chiave API incorporabile per personalizzare le anteprime o rimuoverne il marchio, puoi inserire la tua chiave API qui.

startupOptions

Oggetto/configurazione per la prima schermata del client. Per esempio. la schermata di connessione

startupOptions.server

Esempio: “irc.freenode.net”

Questo sarà il server IRC predefinito a cui il client si connetterà. Può essere lasciato vuoto per obbligare l’utente a entrare in un server.

startupOptions.port

Esempio: 6667

Questa sarà la porta predefinita per il server IRC a cui si connetterà il client. Per impostazione predefinita utilizza 6667 o 6697 se si utilizza SSL/TLS.

startupOptions.tls

Esempio: trueofalse

Se impostato su true, Kiwi IRC abiliterà SSL/TLS per impostazione predefinita per la connessione al server IRC. Se impostato su false, verrà utilizzata una connessione in testo normale non sicura.

startupOptions.password

Esempio: “mypassword”

Questa è la password inviata al server IRC utilizzando PASS.

startupOptions.direct

Esempio: trueofalse

Kiwi IRC supporta la connessione diretta ai server IRC che supportano i websocket. Impostandolo su truesi connetterà direttamente invece di utilizzare un server Kiwi. (Nota: questo potrebbe essere più instabile a seconda del browser dell’utente, della rete, dell’antivirus, dei proxy, tra le altre situazioni)

startupOptions.channel

Esempio: “#channel1,#channel2”

Questo sarà il canale predefinito a cui il client si unirà automaticamente.

startupOptions.nick

Esempio: “a_nick”

Questo sarà il nick predefinito che utilizzerà il client. Un ?carattere può essere usato per specificare un numero casuale per aiutare a ridurre i nick in conflitto.

startupOptions.autoConnect

Esempio: trueofalse

Se si utilizza la welcomeschermata di avvio, questo dirà al client di connettersi automaticamente con le impostazioni di connessione fornite.

startupOptions.state_key

Esempio: “kiwi-state”

La chiave di stato è il nome della sessione utente. L’impostazione predefinita è “stato kiwi”. Le connessioni e i canali IRC degli utenti verranno ricordati nel browser per la prossima volta che apriranno la pagina web. Se impostato su una stringa vuota ( ""), non verrà ricordato nulla.

startupOptions.remember_buffers

Esempio: trueofalse

Quando la sessione utente viene salvata tramite vengono salvate startupOptions.state_keysolo le impostazioni utente. Imposta questa opzione su true per salvare anche le reti e i canali degli utenti.

startupOptions.greetingText

Esempio: “Hello!”

L’intestazione che viene mostrata nella pagina di avvio. L’HTML può essere utilizzato anche qui.

startupOptions.buttonText

Esempio: “Start”

Il testo mostrato sul pulsante di connessione nella pagina di avvio. L’HTML può essere utilizzato anche qui.

startupOptions.infoContent

Esempio: "Welcome to my network! Please visit my <a href='/home' target='_blank'>homepage</a> for help."

Il contenuto HTML mostrato sul lato destro della pagina di avvio.

startupOptions.infoBackground

Esempio: “/info_background.jpg”

L’immagine di sfondo per il lato destro della pagina di avvio.

 

Ecco un esempio del file di configurazione:

{
    "windowTitle": "Kiwi IRC - The web IRC client",
    "startupScreen": "customServer",
    "kiwiServer": "http://example.com/webirc/kiwiirc/",
    "restricted": false,
    "theme": "default",
    "themes": [
        { "name": "Default", "url": "static/themes/default.css" }
    ],
    "startupOptions" : {
        "server": "irc.freenode.net",
        "port": 6697,
        "tls": true,
        "channel": "",
        "nick": ""
    },
    "embedly": {
        "key": ""
    },
    "plugins": []
}

Bene una volta fatto tutto e aver installato e configurato kiwiirc, ed aver settato il vostro IRCd, siete pronti a chattare nella vostra chat preferita Senza abbonamenti e gratuita.

Installazione e configurazione KiwiIRC tradotta da github.com

Tag:

2 commenti su “Installazione e configurazione KiwiIRC”

  1. Pingback: Risorse IRC link utili * IRCwebNet - IRC and Linux World

  2. Pingback: Come incorporare una chat IRC con KiwiIRC * Il miglior IRC web Client

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *