Coś na Linux'a:
polBNC
1. WSTEP
1.1 Wymagania
1.2 Mozliwosci programu
1.3 Bledy
2. KOMPILACJA
2.3 Instalacja klienta Polchata
3. KONFIGURACJA
4. KOMENDY
5. WPIS DO CRONTAB'A
6. LICENCJA
1. WSTEP---------- polBNC jest program, ktory jest posrednikiem (proxy) miedzy serwerem chata (Polchat), a klientem (czatowiczem). polBNC daje klientowi nowe mozliwosci, nowe opcje, ktorych nie ma w oryginalnym serwerze Polchata.
1.1 Wymagania (*) Konto shellowe z mozliwoscia kompilacji programow (*) Dostep do WWW na serwerze z kontem shellowym (ewentualnie dostep do programu redir)
1.2 Mozliwosci programu (*) Mozliwosc pozostawienia aktywnej sesji z serwerem chata
po rozlaczeniu klienta z polBNC
(*) Dodawanie oraz usuwanie uzytkownikow (tylko wlasciciel)
(*) Kompatybilnosc z wszystkimi serwerami Polchata 2.x
(*) Obsluga VHostow (virtual host)
(*) Zabezpieczenie sesji przed osobami niepowolanymi
(*) Szybki reconnect z serwerem
(*) Automatyczny reconnect po utracje polaczenia z serwerem
(*) Zapisywanie rozmow z pokoi oraz prywatnych wiadomosci
(*) Mozliwosc przeslania logow poczta elektroniczna
(*) Zdalne zarzadzanie logami
(*) Wyswietlanie godziny nadejscia wiadomosci
(*) Zapisywanie wiadomosci prywatnych podczas nieobecnosci
z mozliwoscia szybkiego odtworzenia
(*) Wbudowany opdetector
(*) Mozliwosc symulowania otwartego lub zamknietego okna
prywatnych wiadomosci
(*) Obsluga skryptu dla bota
(*) Sprawdzanie poprawnosci skryptu
(*) Zdalny download skryptu ze strony WWW na konto shellowe
(*) Mozliwosc automatycznego zamieniania sie sesji w bota, po rozlaczeniu klienta z polBNC
(*) Wysylanie komunikatu do wszystkich zalogowanych na polBNC
(*) oraz kilka innych
1.3 Bledy Niemozliwym jest uchronienie sie od roznych bledow. Te ktore
udalo mi sie wylapac, to usunalem. Moze sie zdarzyc, ze polBNC
bedzie sie w pewnych warunkach wylaczal. Jezeli tak sie stanie
to prosze o kontakt, podajac po czym nastapilo wylaczenie
(crash) programu. Dzieki temu szybciej wylapie buga i wypuszcze
nowa, poprawiona wersje programu.
2. KOMPILACJA--------------- Plik polbnc-x.x.tar.gz nalezy rozpakowac komenda:
tar -zxvf polbnc-x-x.tar.gz
gdzie x.x to numer wersji
Teraz wejdz do katalogu programu:
cd polbnc
Nastepnie trzeba skompilowac program:
make
Powinien powstac plik wykonywalny polbnc
Nastepnie trzeba program skonfigurowac (patrz pkt 3), po czym
jest gotowy do uruchomienia. Uruchamiamy go poleceniem:
./polbnc
1.1. Instalacja klienta Polchata
polBNC jest tylko serwerem proxy. Aby korzystac z niego trzeba
skorzystac z dowolnego klienta Polchata. Polecam oryginalnego
klienta Polchata napisanego w javie. Klient znajduje sie pod
linkiem:
http://s1.polchat.pl/c.jar
Ten klient moze sie laczyc wylacznie z tym samym serwerem na
ktorym sie klient znajduje (laczy sie zawsze z 127.0.0.1).
Dlatego trzeba plik c.jar umiescic na serwerze na ktorym mamy
shella. To samo trzeba zrobic z obrazkami. Wszystkie obrazki
znajdujace sie pod linkiem
http://s1.polchat.pl/img nalezy
przekopiowac do katalogu img/ wzgledem pliku c.jar
Jezeli nie masz dostepu do WWW na serwerze, to mozesz
zainstalowac serwer WWW na swoim koncie. program FHTTPD mozna
instalowac bedac zwyklym userem (
http://www.fhttpd.org)
Alternatywnym rozwiazaniem jest utworzenie tunelu na serwer
Polchata. Sluzy do tego program redir. Uruchamiamy program
w ten sposob:
redir --lport 23456 --cport 80 --caddr s1.polchat.pl &
program uruchomi sie w tle i bedzie przekierowywal polaczenie
na port 80 serwera s1.polchat.pl. Czyli laczac sie z serwerem
gdzie mamy shella na port 23456 laczymy sie z serwerem
polchata na port 80. Oczywiscie port 23456 to przyklad i
wpisujemy jakis wolny port - najlepiej jakis "egzotyczny" -
mamy wtedy wieksza pewnosc, ze nikt go nam nie zajmie.
Teraz musimy strowyc strone WWW (obojetnie gdzie), gdzie
umiescimy kod odwolujacy sie do naszego pliku c.jar.
Przyklad kodu:
<!-- poczatek kodu -->
<applet CODE="POLChat.class" ARCHIVE="c.jar" WIDTH=100%
HEIGHT=100%
<param name="port" value="34567">
<param name="room" value="polBNC">
</applet>
<!-- koniec kodu -->
Tam gdzie jest ARCHIVE="c.jar" wpisujemy lokalizacje do pliku
c.jar. Jezeli jest on w tym samym katalogu zostawiamy tak jak
jest. Jezeli zrobilismy tunel na shellu to wpisujemy np.
ARCHIVE="http://moj-shell.pl:23456/c.jar"
W linijce w ktorej jest podany port wpisujemy port na jakim
nasluchuje polBNC (zobacz pkt 3)
I to wszystko. Chcac sie polaczyc z polBNC trzeba sie laczyc
z tej strony.
3. KONFIGURACJA----------------- Przed uruchomieniem programu nalezy wyedytowac plik
konfiguracyjny polbnc.conf i zmienic wartosci parametrow.
Plik mozna wyedytowac wpisujac:
pico polbnc.conf
lub
mc -e polbnc.conf
OWNER - czyli wlasciciel programu. Zmien wartosc paramentu na
swoj nick. Wlasciciel moze zakladac nowe konta oraz usuwac.
Moze takze wylaczyc zdalne program, oraz wyslac komunikat do
wszystkich zalogowanych
PASSWORD - jest to haslo dostepu do polBNC. Kazdy nowy
uzytkownik loguje sie z tym haslem
LISTEN_PORT - tutaj podajemy port na jakim na program
nasluchiwac. Ten port podajemy takze w kodzie HTML (patrz pkt
2.1)
4. KOMENDY------------ Ponizszych komend uzywa sie juz po zalogowaniu do polBNC.
Liste komend mozna takze otrzymac wraz z ktotkim opisem wpisujac
w kliencie komende /help
Niektore komendy wymagaja podania dodatkowych parametrow.
Parametry ktore wpisalem w nawiasy <> sa obowiazkowe
(nawiasow nie wpisujemy). Natomiast komendy znajdujace sie w
nawiasach kwadratowych [] sa opcjonalne. Znak "|" oznacza
"lub"
/help - wylistowanie wszystkich dostepnych komend polBNC.
/auth <haslo> - zmiana/ustawienie hasla dostepu do konta. Kazdy
nowy uzytkownik powinien ustawic sobie swoje haslo, aby
zabezpieczyc swoja sesje. Po uzyciu tej komendy uzytkownik
loguje sie do polBNC uzywajac 2 hasel - hasla do polBNC oraz
hasla dostepu do swojego konta. Te 2 hasla wpisuje sie logujac
sie do polBNC. Hasla powinny byc oddzielone spacja. Np. jezeli
haslem do polBNC bylo "polbnc", a uzytkownik ustawil haslo
dostepu do konta np. "burak", to teraz logujac sie powinien
wpisac haslo "polbnc burak". /connect - ta komenda sluzy do polaczenia sie z serwerem chata.
Jezeli wszystkie wymagane paramentry sa poprawne (np. nick,
link, server, host, port, password, room), to program laczy
z serwerem i stawia sesje w pokoju ktory jest wartoscia
paramentu ROOM pod nickiem NICK (jezeli haslo zostalo podane
to bedzie to nick zarajestrowany - w przypadku nie podania
hasla - czyli parametr PASSWORD jest pusty - nick jest
tymczasowy). W przypadku wywolania komendy /connect, kiedy
sesja jest aktywna, nastapi reconnect z serwerem. Zmieniajac
wczesniej wartosc parametru NICK oraz PASSWORD, nastapi
reconnect pod nowym nickiem.
/bquit [powod] - komenda konczy sesje z serwerem Polchata.
Opcjonalnie mozna podac powod wyjscia.
/nick <nick> - zmiana parametru NICK. Jest to nick pod ktorym
program bedzie sie logowal na serwer Polchata podczas
nastepnego wywolania komendy /connect
/password [haslo] - zmiana parametru PASSWORD. Jezeli podamy
w parametrze haslo, to przy nastepnym wywolaniu komendy
/connect program zaloguje nas do pokoju ROOM pod nickiem
NICK zarejestrowanym z haslem PASSWORD. Jezeli nie podamy
parametru, bedzie to oznaczalo ze nick ma byc tymczasowy.
/room <pokoj> - pokoj do ktorego ma wejsc sesja po wywolaniu
komendy /connect. Program automatycznie zmienia parametr
ROOM na ostatni pokoj, w ktorym znajdowala sie sesja.
/link <adres> - niektore serwery Polchata maja zabezpieczenie,
ze mozna sie zalogowac wchodzac wylacznie ze stron
majacych autoryzacje. Program symuluje wejscie ze strony ktora
znajduje sie pod tym parametrem. Serwer polchat.pl nie ma
wlaczonej aktoryzacji, wiec adres, ktory znajduje sie pod
parametrem LINK moze byc dowolny
/server <adres> - jest to adres serwera obrazkow. Dla serwera
polchat.pl ten adres powinien byc:
http://s9.polchat.pl/
(slash na koncu).
/host <adres> - zmiana tego parametru powoduje zmiane serwera
chata. Lepiej jest podawac IP, np. 213.25.49.1, zamiast
polchat.pl, gdyz szybciej zostaniemy polaczeni z serwerem.
/vhost <adres> - niektore serwery posiadaja wiecej niz 1 adres.
Istnieja takie serwery gdzie jedna maszyna ma przypisane kilka
a nawet kilkaset innych IP. Najczesciej posiadaja one rozne
dziwaczne nazwy hostow, np. spoznia.mi.sie.okres.net a jego
IP to 212.127.83.30. wpisujac komende /vhost oraz adres vhosta
bedziemy miec taki wlasnie IP. Jako parametr mozna podac IP
albo nazwe hosta.
/port <port> - port serwera chata pod ktorym nasluchuje
(najczesciej jest to 14003)
/autoconnect <on|off> - jezeli chcesz, aby po utracie polaczenia
z serwerem, program automatycznie przywracal sesje, oraz przy
starcie programu automatycznie logowal sie do serwera chata,
to ustaw ten parametr na ON, w przeciwnym wypadku na OFF.
/savepass <on|off> - jezeli ustawisz wartosc parametru na ON, to
program bedzie zapamietywal ostatnie haslo do nicka. Nie
bedziesz musial wpisywac hasla do nicka po kazdym logowaniu
do polBNC.
/savelog <on|off> - ustawiony parametr na ON, bedzie zapisywal
wszystkie rozmowy z pokojow. Mozna je pozniej przeslac poczta
elektroniczna.
/saveprivatelog <on|off> - jezeli ustawisz wartosc tego
parametru na ON, program bedzie zapamietywal wszystkie rozmowy
prywatne, ktore pozniej mozna sobie przeslac na maila.
/playprivatelog - podczas Twojej nieobecnosci, program
automatycznie zapisuje wszystkie wiadomosci prywatne, ktore
po powrocie mozna odczytac za pomoca tej komendy. Program
automatycznie poinformuje Cie, ze masz zostawione prywatne
wiadomosci.
/eraseprivatelog - ta komenda usuwa wszystkie zostawione
wiadomosci podczas Twojej nieobecnosci.
/dellog <pokoj> - komenda usuwa wszystkie logi z podanego
pokoju.
/delprivatelog <nick> - podobnie jak /dellog, z tym, ze usuwa
ona prywatne rozmowy z nickiem, ktory podamy w parametrze.
/delalllog - usuwa logi z wszystkich pokojow.
/delallprivatelog - usuwa wszystkie logi z rozmow prywatnych.
/statuspriv <auto|on|off> - dzieki tej komendzie, mozna
symulowac otwarte okno prywatnych wiadomosci (ON), zamkniete
okno prywatnych wiadomosci (OFF), oraz automatyczna zmiana
statusu otwartych okien prywatnych (AUTO) - domyslnie.
/quit [powod] - rozlacza klienta z serwerem proxy (jezeli
byla aktywna sesja z serwerem chata, to pozostaje ona dalej
aktywna). Mozna opcjonalnie podac powod wyjscia. Komenda
/away dziala identycznie jak /quit i moze byc uzywana
zamiennie.
/timeserver - polBNC wysyla do klienta informacje o bierzacej
godzinie oraz dacie na serwerze (shell).
/opdetect - po wpisaniu tej komendy, polBNC informuje klienta
o obecnosci operatorow na kanale. Jezeli sa operatorzy, to
program wypisze ich nicki.
/setdefault - ustawienie wszystkich wartosci parametrow na
domyslne.
/sendlog <mail> <SMTP> <pokoj> [#od_linii #do_linii] - jest
to komenda do wysylania poczta elektroniczna logow z pokoju
podanego w parametrze na podany adres. Jako drugi parametr
trzeba podac adres serwera SMTP (np. kki.net.pl). Program
wysle wszystkie rozmowy z danego pokoju, chyba ze podamy numer
poczatkowej linii oraz koncowej linii rozmowy (przydatne jak
log ma zbyt duza objetosc, aby wyslac poczta).
/sendprivatelog <mail> <SMTP> <nick> [#od_linii #do_linii]
- podobnie jak sendlog, lecz zamiast pokoju podajemy nick
osoby z ktora rozmawialismy. Rozmowa zostanie przeslana na
podany adres.
/sendabort - anuluje wysylanie logow. Przydatne jak serwer
SMTP nie odpowiada przez dluzszy czas, a chcemy wyslac
inny log.
/scriptload <nazwa_skryptu> - komenda laduje podany skrypt
do pamieci.
/scriptflush - usuniecie wszystkich regul skryptu z pamieci
/scriptdelete <nazwa_skryptu> - to polecenie usuwa zdalnie
skrypt z dysku.
/scriptlist - wylistowanie wszystkich skryptow. Polecenie
wypisuje jakie skrypty znajduja sie w naszym katalogu z
ktorych mozemy skorzystac
/rehash - komenda przeladowuje skrypt (odswierza) - usuwa
skrypt z pamieci i ponownie go laduje
/scriptactive <away|always|never> - jezeli skrypt jest
w pamieci programu to zostaje automatycznie aktywny jezeli
parametr SCRIPTACTIVE jest ustawiony na ALWAYS. Jezeli ten
parametr jest ustawiony na NEVER, to skrypt mimo, ze jest w
pamieci, to nie bedzie on akrywny. Paramert AWAY oznacza, ze
skrypt jest aktywny tylko wtedy, kiedy klient nie jest
polaczony z serwerem proxy (polBNC) - czyli zamienia sie w
bota.
/scriptdownload <adres> - za pomoca tej komendy mozemy sciagnac
skrypt ze strony WWW do naszego katalogu na shellu.
/downloadabort - anulowanie sciagania skryptu.
/adduser <login> - tej komendy moze uzyc wylacznie wlasciciel
serwera proxy. Dodaje ona nowego uzytkownika, ktory bedzie
mogl sie laczyc z polBNC.
/deluser <login> - podobnie jak /adduser, z tym, ze usuwa ta
komenda konto (uzyc moze tylko wlasciciel polBNC)
/bbroadcast <wiadomosc> - ta komenda wysyla wiadomosc do
wszystkich aktualnie zalogowanych osob na serwerze proxy.
Komendy moze uzyc wylacznie wlasciciel.
/killuser <login> [powod] - komenda zabija wszystkie sesje
uzytkownika o podanym loginie. Zabija ona sesje uzytkownika
z serwerem chata, oraz zrywa polaczenie klienta z serwerem
proxy (uzyc jej moze tylko wlasciciel).
/killbnc <powod> - zabicie wszystkich sesji uzytkownikow, oraz
zabicie procesu polBNC - aby go ponownie uruchomic, konieczne
jest uruchomienie programu na shellu (tylko wlasciciel).
5. WPIS DO CRONTAB'A
----------------------
Czasem sie moze zdarzyc, ze serwer na ktorym uruchomiony jest
polBNC padnie, albo po prostu na skutek jakiegos bledu proces
zostanie skillowany. Dlatego najlepiej jest dodac wpis do
crontab'a, aby np. co 5 minut uruchamial sie program
sprawdzajacy, czy polBNC jest uruchomiony. Razem z programem
dostales skrypt polbncchk. Skrypt sprawdza czy polBNC jest
uruchomiony. W przypadku gdy nie jest on uruchomiony, to
go odpala. Musisz jednak zmienic w pliku polbncchk sciezke
do programu polbnc, zmieniajac wartosc stalej POLBNCPATH
Do pliku /etc/crontab dopisz nastepujaca linijke:
0-59/5 * * * * harmer /home/harmer/polbnc/polbncchk
Oczywiscie zastap "harmer" swoim loginem, oraz zmien
lokalizacje do pliku polbncchk.
Jezeli nie masz dostepu do crontab'a to popros administratora
serwera o wpis.
6. LICENCJA
-------------
Niniejszy program jest wolnym oprogramowaniem; mozesz go
rozprowadzac dalej i/lub modyfikowac na warunkach Powszechnej
Licencji Publicznej GNU, wydanej przez Fundacje Wolnego
Oprogramowania - wedlug wersji 2-giej tej Licencji lub ktorejs
z pozniejszych wersji.
Niniejszy program rozpowszechniany jest z nadzieja, iz bedzie on
uzyteczny - jednak BEZ JAKIEJKOLWIEK GWARANCJI, nawet domyslnej
gwarancji PRZYDATNOSCI HANDLOWEJ albo PRZYDATNOSCI DO OKRESLONYCH
ZASTOSOWAN. W celu uzyskania blizszych informacji - Powszechna
Licencja Publiczna GNU (GNU General Public Licence)
czyli w skrócie, potrzeba shella + www + applet który można ściągnąć z
http://s1.polchat.pl/c.jar
