shelinaboxd - Online în cloud

PROGRAM:

NUME

shelinaboxd - publicați shell-ul liniei de comandă prin interfața AJAX

REZUMAT

shelinaboxd
[ -b | --fundal[=pidfile] ] [ -c | --cert=certdir ] [ --cert-fd=fd ]
[ --css=nume de fișier ] [ --cgi[=portrange] ] [ -d | --depanare ] [ -f | --static-
fisier=url:fişier ] [ -g | --grup=ghid ] [ -h | --Ajutor ]
[ --linkify=[nici unul|normală.|agresiv] ] [ --localhost-only ] [ --nu-bip ] [ -n |
--numeric ] [ --pidfile=pidfile ] [ -p | --port=port ] [ -s | --serviciu=serviciu ]
[ -t | --disable-ssl ] [ --disable-ssl-meniu ] [ -q | --Liniște ] [ -u | --utilizator=uid ]
[ --user-css=stiluri ] [ -v | --verbos ] [ --versiune ]

DESCRIERE

shelinaboxd daemon implementează un server web care ascultă pe cele specificate port.
serverul web publică unul sau mai multe Servicii care va fi afișat într-un emulator VT100
implementat ca o aplicație web AJAX. În mod implicit, portul este 4200 și implicit
URL-ul serviciului este http://localhost: 4200 /.

Dacă nu anume serviciu a fost solicitat, serverul se lansează /bin/login interogarea utilizatorului
pentru numele de utilizator și parola lor. Apoi pornește shell-ul implicit de conectare al utilizatorului.

Orice browser modern activat cu JavaScript și CSS va putea accesa conținutul publicat serviciu
fără a necesita pluginuri suplimentare.

OPŢIUNI

Următorii parametri de linie de comandă controlează funcționarea demonului:

-b | --fundal[=pidfile]
Lansa shelinaboxd ca proces demon de fundal. Opțional, scrieți ID-ul procesului
la pidfile.

-c | --cert=certdir
Dacă este construit cu suportul SSL/TLS activat, demonul va căuta certdir pentru orice
certificate. Dacă nu este specificat, aceasta este implicită în directorul de lucru curent.

Dacă browserul a negociat a server de Nume Identificare demonul va căuta o
potrivire certificat-NUMELE SERVERULUI.pem fişier. Acest lucru permite găzduirea virtuală a mai multor persoane
nume de server pe aceeași adresă IP și același port.

Daca nu SNI strângerea de mână a avut loc, se recurge la utilizarea certificatului în
certificat.pem fișier.

Administratorul ar trebui să se asigure că există certificate potrivite pentru fiecare dintre ele
gazdele virtuale de pe acest server și că există un generic certificat.pem fișier.

Dacă nu este instalat niciun certificat adecvat, shelinaboxd va încerca să invoce
/usr/bin/openssl și creați un nou certificat autosemnat. Acest lucru reușește doar dacă,
după renunțarea la privilegii, shelinaboxd are permisiuni de scriere pentru certdir.

Majoritatea browserelor afișează un mesaj de avertizare atunci când întâlnesc un certificat autosemnat și
apoi permite utilizatorului opțiunea de a accepta certificatul. Datorită acestei posibilități de utilizare
problema, iar din cauza implicațiilor de securitate percepute, utilizarea auto-generate
certificatele autosemnate sunt destinate doar testării sau implementărilor intranet.

--cert-fd=fd
În loc să ofere un --cert director, este, de asemenea, posibil să furnizați un
filedescriptor fd unde certificatul și cheia pot fi preluate. În timp ce această opțiune
dezactivează SNI suport, oferă o soluție alternativă pentru furnizarea în siguranță
datele cheii private către demon.

--css=nume de fișier
Uneori, nu este necesar să înlocuiți întreaga foaie de stil folosind --static-
fişier opțiune. Dar, în schimb, o mică schimbare incrementală ar trebui făcută vizualului
aspectul terminalului. The --css opțiunea oferă un mijloc de a adăuga suplimentar
regulile de stil până la sfârșitul valorii implicite styles.css foaie. Mai mult de o --css opțiune
poate fi dat pe aceeași linie de comandă.

--cgi[=portrange]
În loc să alergi shelinaboxd ca proces permanent, poate fi încărcat la cerere ca a
Extensie de server web CGI. Când faceți acest lucru, va genera un server care trăiește pentru
durata sesiunii utilizatorului. Dacă este opțional portrange a formei MINPORT-MAXPORT
a fost furnizat, serverul se limitează la aceste numere de porturi. Ar trebui să fie
configurat să treacă prin firewall.

--cgi opțiunea se exclud reciproc cu --fundal, --pidfile si --port
opțiuni.

Pentru a fi util ca script CGI, programul shelinaboxd binar probabil va trebui
fi făcut rădăcină-setuid. Aceasta este în prezent o configurație descurajată. Utilizați cu grijă.

-d | --depanare
Activează modul de depanare, rezultând o mulțime de mesaje de jurnal stderr. Această opțiune este
se exclud reciproc cu --Liniște si --verbos.

-f | --static-file=url:fişier
Daemonul servește diverse resurse încorporate de la adresele URL de sub serviciu monta
puncte. Una sau mai multe --static-file opțiunile permit înlocuirea acestor resurse cu
personalizat furnizat extern fișiere. url poate fi fie un absolut, fie a
cale relativă. În primul caz, suprascrie exact o resursă încorporată pentru una
specific serviciu, în timp ce în ultimul caz suprascrie resursele pentru fiecare definit
serviciu.

Următoarele resurse sunt disponibile pentru personalizare:

bip.wav probă audio care este redată ori de câte ori se aude terminalul BEL.

favicon.ico fișier imagine favicon care este afișat în navigarea browserului
bar.

ShellInABox.js Fișier JavaScript care implementează emulatorul de terminal AJAX.

styles.css Fișier în stil CSS care controlează aspectul vizual al terminalului.

print-styles.css Fișier în stil CSS care controlează aspectul vizual al paginilor tipărite
când utilizați caracteristica de imprimare transparentă VT100.

Nu este recomandat să suprascrieți pagina HTML rădăcină pentru un anumit serviciu.
În schimb, mutați serviciul la o adresă URL anonimă și difuzați a fişier-static că trimiteri
il serviciu într-un .

În loc de a fişier, este posibil să furnizați numele unui director. Aceasta se întoarce
shelinaboxd într-un simplu server web care publică toate fișierele din acesta
anume director. Această opțiune poate fi utilă atunci când publicați o rădăcină mai complexă
Pagina HTML.

-g | --grup=ghid
Când a început ca rădăcină, serverul pierde majoritatea privilegiilor la pornire. Cu excepția cazului în care este anulat
langa --grup opțiunea, se comută la nogrup.

Când rulează deja ca utilizator neprivilegiat, modificările grupului nu sunt posibile.

Dacă rulați cu suportul SSL/TLS activat, certificatele trebuie să fie accesibile pentru
utilizator și/sau grup neprivilegiat cu care rulează demonul.

-h | --Ajutor
Afișează un scurt mesaj de utilizare care arată parametrii validi pentru linia de comandă.

--linkify=[nici unul|normală.|agresiv]
demonul încearcă să recunoască URL-urile în ieșirea terminalului și le face
pe care se poate face clic. Acesta nu este neapărat un proces sigur și atât fals negative, cât și
sunt posibile fals pozitive. În mod implicit, numai adresele URL care încep cu un bine cunoscut
protocol de http://, https://, ftp: //, mailto: sunt recunoscute. În agresiv mod,
orice lucru care arată ca un nume de gazdă, o adresă URL sau o adresă de e-mail este recunoscut, chiar dacă nu
precedat de un protocol.

--localhost-only
In mod normal, shelinaboxd ascultă pe toate interfețele de rețea disponibile. La operare
în spatele unui proxy invers care nu este întotdeauna de dorit. Această opțiune de linie de comandă spune
demonul să asculte doar pe interfața de loopback.

--nu-bip
nu numai semnalele sonore sunt nedorite în unele medii de lucru, ci și browserul
suportul pentru redarea media este adesea defectuos. Setarea acestei opțiuni suprimă toate
redarea audio și activează implicit clopoțelul vizual.

-n | --numeric
Când alergi înăuntru --verbos modul, demonul imprimă un Apache-style fișier jurnal la stderr.
În mod implicit, numele de gazdă ale colegilor sunt rezolvate înainte de a le înregistra. După cum pot face căutările DNS
fi costisitoare, este posibil să solicitați în schimb înregistrarea adreselor IP numerice.

--pidfile=pidfile
shelinaboxd demonul poate fi configurat pentru a-și stoca identificatorul de proces în pidfile.

-p | --port=port
Dacă nu este suprascris de această opțiune, serverul web ascultă pe portul 4200 pentru intrare
Solicitări HTTP și HTTPS.

shelinaboxd poate distinge între cererile SSL/TLS și cererile necriptate. Aceasta
stie si sa negocieze server de Nume Identificare, permițând utilizarea unui singur
port pentru toate tipurile de solicitări chiar și atunci când sunt găzduite virtuale.

-s | --serviciu=serviciu
Unul sau mai multe servicii pot fi înregistrate pe căi URL diferite:
SERVICIU := ':' APLICARE

Există o predefinită cerere, „LOGIN”, care determină invocarea demonului
/bin/login solicitând numele și parola utilizatorului și pornind shell-ul de conectare.
Aceasta este opțiunea implicită pentru rădăcină utilizator, dacă nu --serviciu a fost definit. Pornire
/bin/login Necesită rădăcină privilegii.

Există un altul predefinit cerere, „SSH”. În loc să invoce /bin/login, Aceasta
Apeluri ssh. Aceasta este opțiunea implicită pentru utilizatorii neprivilegiati, dacă nu --serviciu a fost
definit. Această operațiune este disponibilă atât pentru utilizatorii privilegiați, cât și pentru utilizatorii obișnuiți. Dacă
facultativ gazdă parametrul este omis, shelinaboxd se conectează la localhost.

Alternativ, un cerere poate fi specificat prin furnizarea unui utilizator descriere, a
director de lucru și o linie de comandă:
APLICARE := 'Autentificare' | „SSH” [ „:” ] | USER ':' CWD ':' CMD

Cuvântul cheie „AUTH” indică faptul că utilizator ar trebui solicitate informații
interactiv, în loc să fie furnizat ca parte a serviciu Descriere:
USER := 'AUTH' | ':'

Directorul de lucru poate fi dat fie ca o cale absolută, fie poate fi
directorul principal al utilizatorului:
CWD := 'ACASĂ' :

Comanda că shelinaboxd execute poate fi specificat fie ca „SHELL”
cuvânt cheie, care indică shell-ul implicit de conectare al utilizatorului sau o linie de comandă arbitrară:
CMD := „COCHILA” :

The acceptă extinderea variabilelor de forma ${VAR}. Sprijinit
variabilele sunt:

${columns} numar de coloane.

${gid} ID grup numeric.

${grup} numele Grupului.

${home} directorul principal.

${linii} număr de rânduri.

${peer} numele peer-ului la distanță.

${realip} valoarea câmpului antet HTTP „X-Real-IP”.

${uid} ID numeric de utilizator.

${url} URL-ul care servește sesiunea terminalului.

${user} nume de utilizator.

În afară de variabilele de mediu ale $TERM, $COLUMNS, $LINES,
$SHELLINABOX_PEERNAME, $SHELLINABOX_REALIP si $SHELLINABOX_URL, serviciile pot avea
variabilele de mediu le-au trecut, precedând cu spațiu separat
atribuiri variabile ale formularului CHEIE=VALUE.

The acceptă ghilimele simple și duble, precum și barele oblice inverse pentru evadare
personaje în mod familiar.

Vă rugăm să rețineți că atunci când invocați shelinaboxd dintr-un shell de linie de comandă, suplimentar
citarea ar putea fi necesară pentru a preveni extinderea shell-ului a variabilelor înainte de
trecându-le demonului.

Dacă nu este explicit --serviciu a fost solicitat, shelinaboxd implicit atașarea
serviciu implicit în directorul rădăcină al serverului web. Pentru rădăcină, Aceasta este
/bin/login, iar pentru utilizatorii neprivilegiati, aceasta este ssh localhost. Acest lucru este echivalent cu
spunând --service=/:LOGIN, --service=/:SSH, respectiv.

Vă rugăm să rețineți că pentru ca serviciul SSH să funcționeze corect, avem nevoie de un server ssh care rulează
sistem local cu autentificarea prin parolă activată. Dacă folosim parametru,
aceleași condiții trebuie să fie adevărate pe acel sistem de la distanță.

-t | --disable-ssl
În mod implicit, shelinaboxd redirecționează toate solicitările HTTP primite către echivalentul lor
URL-uri HTTPS. Dacă nu se dorește promovarea conexiunilor la sesiuni SSL/TLS criptate,
acest comportament poate fi dezactivat.

Această opțiune este utilă și în timpul testării sau pentru implementarea în intranet-uri de încredere, dacă
Certificatele SSL nu sunt disponibile.

--disable-ssl-meniu
Dacă utilizatorul nu ar trebui să poată comuta între modurile HTTP și HTTPS, această alegere
poate fi eliminat din meniul contextual. Utilizatorul poate face această alegere direct
mergând la adresa URL corespunzătoare.

-q | --Liniște
Suprimă toate mesajele către stderr. Această opțiune se exclude reciproc cu --depanare
si --verbos.

-u | --utilizator=uid
Dacă a început ca rădăcină, serverul renunță la privilegii prin schimbarea în nimeni, cu excepția cazului în care uid
a fost înlocuită de această opțiune.

Pentru mai multe detalii, consultați descrierea --grup opțiune.

--user-css=stiluri
Aspectul vizual al emulatorului de terminal poate fi personalizat prin intermediul utilizatorului
foi de stil selectabile. Aceste foi de stil vor apărea ca opțiuni în dreapta-
faceți clic pe meniul contextual al emulatorului de terminal.

Foaia de stiluri alcătuiește opțiuni de activare/dezactivare selectabile independent sau multiple
foile de stil pot fi grupate. Când se formează un grup, un singur membru al
grupul poate fi activ în orice moment. Acesta este utilizat pentru opțiuni cu alegere multiplă.

Mai multe grupuri independente sunt separate prin punct și virgulă:
STILURI := GRUP { ';' GRUP }*

Membrii unui grup sunt separați prin virgule:
GRUP := OPȚIUNE { ',' OPȚIUNE }*

Grupurile cu exact un membru sunt folosite pentru opțiunile care pot fi transformate independent
pornit și oprit.

Opțiunile includ o etichetă care poate fi citită de om care va fi afișată în meniul contextual,
urmat de numele fișierului CSS. De asemenea, trebuie să includă un indicator care arată
dacă opțiunea ar trebui inițial activată sau dezactivată. În cadrul unui grup,
ar trebui activată exact o opțiune:
OPȚIUNE := ':' [ '-' | „+”]

Selectarea opțiunilor de către utilizator va fi menținută într-un cookie. Aceasta înseamnă că
setările implicite ale opțiunilor, așa cum sunt transmise pe linia de comandă, nu au efecte decât în ​​momentul în care
prima dată când utilizatorul vizitează emulatorul de terminal în browserul său. Pe toate cele ulterioare
vizite, preferintele utilizatorului au prioritate.

-v | --verbos
Activează înregistrarea Apache-style fișier jurnal la stderr. Această opțiune este reciprocă
exclusiv cu --depanare si --Liniște.

--versiune
Tipărește numărul de versiune a binarului și iese.

CONFIGURARE

Nu există fișiere de configurare sau setări permanente pentru shelinaboxd.

Un număr mic de opțiuni de configurare în timpul rulării sunt disponibile dintr-un meniu contextual care
devine disponibil când faceți clic pe butonul din dreapta al mouse-ului. Aceste opțiuni sunt persistente într-un
cookie de browser.

Multe site-uri au deja un server web care rulează și ar dori să se integreze shelinaboxd în
site-ul lor existent. Acest lucru se face cel mai frecvent prin intermediul unei intrări reverse-proxy pentru
server web principal. Pentru Apache aceasta ar necesita adăugarea unei opțiuni precum:

ProxyPass http://localhost: 4200 /
Ordinul permite, refuză
Permiteți tuturor


Dacă utilizați un alt server web, consultați documentația serverului respectiv
configurați operațiuni de proxy invers.

Când utilizați un proxy invers, --localhost-only în mod normal, opțiunea ar fi activată.
În plus, --disable-ssl ar putea fi luate în considerare și în funcție de exact
detaliile de configurare ale proxy-ului invers.

EXEMPLE

shelinaboxd Atașează un shell de conectare activat pentru web la https://localhost:4200/. Dacă utilizatorul
conectat fără SSL, sesiunea va fi promovată automat. Dacă nu
Certificatele SSL pot fi găsite în directorul curent, demonul o va face
genera automat certificate adecvate autosemnate. Dacă comanda a fost
invocat de un non-rădăcină utilizator, demonul folosește ssh în loc de /bin/login pentru
sesiune.

shelinaboxd -t
Atașează un shell de conectare activat pentru web la http://localhost: 4200 / cu SSL/TLS
suport dezactivat.

shelinaboxd -t -f beep.wav:/dev/null
Rulează toate serviciile cu clopoțelul sonor dezactivat permanent.

shelinaboxd -s /:SSH:example.org
Terminalul se conectează la a ssh sesiune pe exemplu.org.

shelinaboxd -t -s /:AUTH:HOME:/ bin / bash
Solicitați interactiv numele și parola utilizatorului înainte de a lansa a
coajă Bourne. Această comandă poate fi rulată de utilizatori neprivilegiati. Dar dacă procedând astfel,
permite doar acestui utilizator să se autentifice.

shelinaboxd -c Certificatele -u Shellinabox -g Shellinabox
În cazul în care Certificatele directorul există și poate fi scris de către Shellinabox utilizator
și certificatele SSL autosemnate de grup vor fi generate în acest director.
Acest lucru ar putea necesita mai întâi crearea unui utilizator cu numele corespunzător. Rularea asta
comanda ca rădăcină permite oricărui utilizator din sistem să se conecteze la
http://localhost: 4200 /. Sesiunile vor fi promovate automat la SSL/TLS.

shelinaboxd -t -s /:AUTENTIFICARE -s /cine:nimeni:niciun grup:/:w
Pe lângă shell-ul de conectare la http://localhost: 4200, arată o listă de
utilizatorii conectați în prezent la accesare http://localhost:4200/cine. Acest
comanda trebuie rulată ca rădăcină pentru a putea trece la nimeni: niciun grup
așa cum este cerut de descrierea serviciului.

shelinaboxd -t -s '/:root:root:/:wy60 -c /bin/login'
În loc de standard ANSI/VT100 terminal, publicați a Înţelept 60 ™ Terminal.
Din nou, această comandă ar trebui să fie rulată ca rădăcină.

shelinaboxd --css alb-pe-negru.css
Încarcă alb-pe-negru.css foaia de stil din directorul curent și
îl anexează la încorporat styles.css foaie. Acest lucru determină terminalul să
redați întotdeauna textul alb pe un fundal negru.

shelinaboxd --user-css Normal:+negru-pe-alb.css, Revers:-alb-pe-negru.css
Permiteți utilizatorului să selecteze dacă dorește ca textul să fie redat normal sau în
video invers. Această opțiune de linie de comandă adaugă o nouă intrare la clic-dreapta
meniul contextual.

DIAGNOSTIC

Daemonul returnează un cod de ieșire diferit de zero în caz de eșec. Cu excepția unui mic
numărul de cazuri de eroare obișnuite care sunt tratate în mod explicit, majoritatea erorilor au ca rezultat tipărirea a
"Verifica a eșuat" mesaj. Acest lucru nu indică de obicei o eroare în program, dar este
în schimb modul său normal de raportare a erorilor.

Condițiile comune de defecțiune sunt reutilizarea unui port care este deja în uz, lipsa unui port suficient
privilegii de a rula un serviciu, eșecul de a găsi certificate SSL/TLS și eșecul de a scrie
certificate nou generate în directorul de certificare.

Utilizați Shellinaboxd online folosind serviciile onworks.net