Mongoose Web Server Binär version: Master Mongoose Binär är en liten och lättanvänd webbserver som byggts på toppen av protokollet för nätverksbiblioteket Mongoose Embedded Web Server. Mongoose Binär är utformad med maximal enkelhet i åtanke. Om du vill dela någon mapp kan du bara släppa Mongoose Binär-körbar i den katalogen, dubbelklicka på den (på UNIX, springa den från skal) och peka din webbläsare till localhost: 8080 OBS: localhost ska ändras till maskinens namn om åtkomst från en annan dator. I Windows och Mac lägger Mongoose Binary en ikon till systemfältet när den startas. Högerklicka på ikonen för att öppna en popup-meny, där det är möjligt att stoppa Mongoose Binary eller konfigurera det. När startat söker Mongoose Binary först efter en konfigurationsfil som heter mongoose. conf i samma katalog där binären finns. Konfigurationsfilen kan vara frånvarande, i så fall används standardkonfigurationsalternativen. Konfigurationsfilen är en följd av linjer. Varje rad innehåller ett namn på konfigurationsalternativ och dess värde. Tomma linjer och linjer som börjar med ignoreras. Här är ett exempel på mongoose. conf-filen: ANMÄRK: Mongoose Binär kan startas från kommandotolken och konfigurationsparametrar kan anges som kommandoradsargument med - prepended. Till exempel: Mongoose Binary stöder digestering av autentisering. och det kan användas för att lägga till användare i. htpasswd-filen: Till skillnad från andra webbservrar behöver Mongoose Binary inte CGI-skript vara placerade i en särskild katalog. CGI-skript kan vara var som helst. CGI och SSI-filer känns igen av filnamnsmönstret. Mongoose Binary använder skalliknande globala mönster. Mönsterkampen börjar i början av strängen, så i huvudsak mönster är prefixmönster. Syntaxen är som följer:. Matchar allt. Matchar allt utom karaktär. Matchar alla tecken. Matchar slutet av strängen. Matchar om mönster på vänster sida eller höger sida matchar. Alla andra tecken i mönstret matchar sig själva. Exempel:.cgi. Varje sträng som slutar med. cgi foo. Varje sträng som börjar med foo ab. Varje sträng som slutar med a eller börjar med b Om du bara vill begränsa CGI-filer till cgi-bin-katalogen använder du den här inställningen: En Access Control List (ACL) tillåter att restriktioner läggs på listan över IP-adresser som har tillgång till webben server. När det gäller den mongoose binära webbservern är ACL en kommaseparerad lista över IP-prefixspecifikationer, där varje prefix är uppbyggt av antingen a - eller ett tecken. Ett plustecken betyder att ett minustecken betyder förneka. Om en subnätmask utelämnas, t. ex. -1.2.3.4. en 32 mask antas. Det innebär att förneka endast den enda IP-adressen. Subnätmasker kan variera från 0 till 32 inklusive. Standardinställningen är att tillåta all åtkomst. På varje förfrågan går hela listan över och den sista matchen vinner. Exempel: mongoose - accesscontrollist -0.0.0.00,192.16816 kommer att neka alla acccesser förutom de från 192.16816-subnätet. Observera att om alternativet är inställt är all åtkomst förbjuden som standard. Såsom beskrivits i föregående exempel är sålunda -0.0.0.0-delen inte nödvändig. Till exempel betyder accesscontrollist 10.0.0.08 att inte alla tillåter subnet 108. Exempel: accesscontrollist -0.0.0.00,192.16816 Standard: Ej inställd, all åtkomst är tillåten. Vägen till en fil för åtkomstloggar. Antingen hela vägen eller i förhållande till Mongoose Binär körbar. Exempel: accesslogfile c: logswebaccesslog. txt Standard: Ej inställd, ingen loggning är klar. Tillståndsriket används i. htpasswd-auktorisation. Exempel: authdomain mysite Vägen till en körbar som ska användas som tolk för alla CGI-skript oavsett scripttillägget. Om det här alternativet inte är inställt (vilket är standardvärdet), uppskattar Mongoose Binary Shebang-linjen - se en. wikipedia. orgwikiShebang (Unix). Om exempelvis både PHP och Perl CGIs används, måste pathtophp-cgi. exe och pathtoperl. exe vara de första raderna i respektive CGI-skript. Obs! Banor ska vara antingen fullständiga filvägar eller filvägar i förhållande till katalogen där Mongoose Binär-körbar finns. Om alla CGI använder samma tolk, till exempel är de alla PHP, så kan cgiinterpreter-alternativet sättas till sökvägen till php-cgi. exe exekverbar och shebang-linjen i CGI-skripten kan utelämnas. OBS! PHP-skript måste använda php-cgi. exe. inte php. exe. Exempel: cgiinterpreter C: rubyruby. exe Standard: Ej inställd. Alla filer som matchar cgipattern behandlas som CGI-skript. Standardmönstret låter CGI-filer vara överallt. Om du vill begränsa CGI till en viss katalog använder du pathtocgi-bin. cgi som ett mönster. Obs! Den fullständiga filvägen matchas mot mönstret, inte URI. När Mongoose Binary startar CGI-programmet skapar det en ny miljö för det (i kontrast brukar barnprogrammet miljö från föräldern). Flera miljövariabler är emellertid ärvda från Mongoose Binary39s miljö. De är: PATH. TMP. TEMP. TMPDIR. PERLLIB. MONGOOSECGI. På UNIX är det också LDLIBRARYPATH. På Windows är det också COMSPEC. SYSTEM. System. Program filer. Programfiles (x86). CommonProgramFiles (x86). Exempel: cgipattern. cgi Autentiseringsfilen för WebDAV-mutationsförfrågningar: PUT. RADERA. MKCOL. Formatet för den filen är samma som för. htpasswd-filen som används för att smälta autentisering. Den kan skapas och hanteras av mongoose - A kommando. Om davauthfile är inställd på -. då är DAV-autentisering inaktiverad. Exempel: davauthfile c: davauth. txt Standard: Ej inställd, WebDAV-mutationer avvisas. En rotkatalog för DAV-förfrågningar. Exempel: davroot C: davroot Standard: Ej inställd, vilket betyder att DAV-rotkatalogen är densamma som dokumentroten En rotkatalog för webbförfrågningar. Exempel: documentroot c: www Default: nuvarande arbetsmapp. Mongoose Binär - Användarhandbok Mongoose är en liten och lättanvänd webbserver byggd på toppen av protokollet för flera protokoll nätverk. Mongoose är utformad med maximal enkelhet i åtanke. Om du vill dela någon mapp kan du bara släppa Mongoose körbar i den katalogen, dubbelklicka på den (på UNIX, springa den från skalet) och peka din webbläsare på localhost: 8080 OBS: localhost ska ändras till maskinens namn om det är tillgängligt från en annan dator. På Windows och Mac lägger Mongoose en ikon till de systemfältet när de startas. Högerklicka på ikonen för att dyka upp en meny där det är möjligt att stoppa Mongoose eller konfigurera den. När startat söker Mongoose först en konfigurationsfil som heter mongoose. conf i samma katalog där binären finns. Konfigurationsfilen kan saknas, i det här fallet används standard konfigurationsalternativ. Konfigurationsfilen är en följd av linjer, varje rad innehåller konfigurationsalternativets namn och dets värde. Tomma linjer och linjer som börjar med ignoreras. Här är exemplet på mongoose. conf-filen: OBS: Mongoose kan startas från kommandotolken, och konfigurationsparametrar kan anges som kommandoradsargument med - prepended. Till exempel: Mongoose stöder digestering av autentisering. och det kan användas för att lägga till användare i. htpasswd-filen: Till skillnad från andra webbservrar kräver Mongoose inte CGI-skript i en särskild katalog. CGI-skript kan vara var som helst. CGI och SSI-filer känns igen av filnamnsmönstret. Mongoose använder skalliknande globmönster. Mönsterkampen börjar i början av strängen, så i huvudsak mönster är prefixmönster. Syntax är som följer:. Matchar allt. Matchar allt utom karaktär. Matchar alla tecken. Matchar slutet av strängen. Matchar om mönster på vänster sida eller höger sida matchar. Alla andra tecken i mönstret matchar sig själva. Exempel:.cgi. Varje sträng som slutar med. cgi foo. Varje sträng som börjar med foo ab. Varje sträng som slutar med a eller börjar med b Om du bara vill begränsa CGI-filer till cgi-bin-katalogen använder du den här inställningen: En Access Control List (ACL) tillåter att restriktioner läggs på listan över IP-adresser som har åtkomst till webbservern . När det gäller Mongoose-webbservern är ACL en kommaseparerad lista över IP-prefixspecifikationer, där varje prefix är uppbyggt av antingen a - eller ett tecken. Ett plustecken betyder tillåtelse, och ett minustecken betyder att neka. Om en subnätmask utelämnas, t. ex. -1.2.3.4. en 32 mask antas och det betyder att neka den enda IP-adressen. Subnätmasker kan variera från 0 till 32 inklusive. Standardinställningen är att tillåta alla åtkomst. På varje förfrågan går hela listan över och den sista matchen vinner. Exempel: mongoose - accesscontrollist -0.0.0.00,192.16816 för att neka alla acccesser förutom de från 192.16816 subnet. Observera att om alternativet är inställt är alla åtkomster som standard förbjudna. Således i ett tidigare exempel är -0.0.0.0 del inte nödvändigt. Till exempel betyder accesscontrollist 10.0.0.08 att inte alla tillåter subnet 108. Exempel: accesscontrollist -0.0.0.00,192.16816 Standard: Ej inställd, alla åtkomst är tillåtna. Vägen till en fil för åtkomstloggar. Antingen full väg, eller i förhållande till Mongoose körbar. Exempel: accesslogfile c: logswebaccesslog. txt Standard: Ej inställd, ingen loggning är klar. Auktoriseringsområde som används i. htpasswd-auktorisation. Exempel: Authdomain mysite-sökväg till en körbar att användas används som tolk för alla CGI-skript oavsett scriptförlängning. Om det här alternativet inte är inställt (vilket är standardvärdet), uppskattar Mongoose Shebang-linjen - se en. wikipedia. orgwikiShebang (Unix). Om exempelvis både PHP och Perl CGIs används, måste pathtophp-cgi. exe och pathtoperl. exe vara första raderna i respektive CGI-skript. Observera att sökvägar ska vara antingen fullständiga filvägar eller filvägar i förhållande till katalogen där Mongoose-körbarheten finns. Om alla CGIs använder samma tolk, till exempel är de alla PHP, då kan cgiinterpreter-alternativet sättas till sökvägen till php-cgi. exe exekverbar och shebang-linjen i CGI-skripten kan utelämnas. OBS! PHP-skript måste använda php-cgi. exe. inte php. exe. Exempel: cgiinterpreter C: rubyruby. exe Standard: Ej inställd. Alla filer som matchar cgipattern behandlas som CGI-skript. Standardmönster tillåter CGI-filer var som helst. Om du vill begränsa CGI till en viss katalog använder du pathtocgi-bin. cgi som ett mönster. Observera att hela filvägen matchas mot mönstret, inte URI. När Mongoose startar CGI-program skapar det ny miljö för det (i kontrast brukar barnprogrammet få miljö från föräldern). Flera miljövariabler är emellertid ärvda från Mongoose39s miljö, de är: PATH. TMP. TEMP. TMPDIR. PERLLIB. MONGOOSECGI. På UNIX är det också LDLIBRARYPATH. På Windows är det också COMSPEC. SYSTEM. System. Program filer. Programfiles (x86). CommonProgramFiles (x86). Exempel: cgipattern. cgi Autentiseringsfil för WebDAV-mutationsförfrågningar: PUT. RADERA. MKCOL. Formatet för den filen är samma som för. htpasswd-filen som används för att smälta autentisering. Den kan skapas och hanteras av mongoose - A kommando. Om davauthfile är inställd på -. då är DAV-autentisering inaktiverad. Exempel: davauthfile c: davauth. txt Standard: Ej inställd, WebDAV-mutationer avvisas. En rotkatalog för DAV-förfrågningar. Exempel: davroot C: davroot Standard: Ej inställd, vilket betyder att DAV-rotkatalogen är densamma som documentrootMongoose är ett intuitivt och kraftfullt program som är designat från grunden för att göra det möjligt för användare att bädda in den redan befintliga applikationen för att tillhandahålla webbgränssnitt för dem. Lätt att installera och att komma igång Programmet genomgår en strömlinjeformad installationsprocess tack vare ett kompilerat Windows-binärt efter vilket det automatiskt integreras med systemfältet. Att lära sig att använda Mongoose är en enkel process med användare som bara måste ställa in den delade katalogen från sitt system och skriva följande adress i adressfältet för en installerad webbläsare: localhost: 8080. Observera att båda dessa uppgifter kan enkelt uppnås från app039s systemfält-meny. Om du vill ha extra konfigurationsalternativ får du tillgång till avsnittet Avancerade inställningar för app039 Om någon ytterligare konfiguration krävs - till exempel en annan lyssningsport eller IP-baserad åtkomstkontroll, kan en 039mongoose. conf039-fil med respektive alternativ skapas i samma katalog där körbarheten lever. Ännu mer kan användarna få tillgång till app039s avancerade inställningar via ett webbaserat gränssnitt. Genom att klicka på lämplig post från app039s systemfält-meny, riktas användarna automatiskt till en omfattande webbserverinställningsavdelning. Kommer med stöd för ett brett spektrum av protokoll Det är värt att notera att Mongoose kommer med inbyggt stöd för PicoTCP-inbyggd TCPIP-stack, LWIP-integrerad TCPIP-stack. Dessutom sammanfogar det också ett brett spektrum av protokoll, till exempel: vanlig TCP, vanlig UDP, HTTP-klient, HTTP-server, JSON-RPC-klient, JSON-RPC-server, MQTT-klient, MQTT-mäklare, CoAP-klient, CoAP-server, DNS klient, DNS-server, async DNS-resolver. Funktionslistan för utility039 kompletteras med SSLTLS-säkerhet med användarautentisering via Digest Authentification, stöd för statisk HTMLCSS och aktuell tidgrafik eller händelsedata via WebSocket-anslutning. Integrera det med dina projekt på några sekunder Totalt är Mongoose en användbar inbäddad webser, med ett protokollbibliotek och direkta funktioner som anser det lämpligt för flera projekt som demo, snabbtester, fildelning och webbprogrammering. Bäst av allt kan du enkelt integrera det i ditt projekt genom att bara kopiera mongoose. c och mongoose. h-filer direkt till byggträdet. Ny i Mongoose 6.5: NY FUNKTIONALITET: Mongoose Embedded Web Server LogoImproved TI CC3200 support: Först på listan över funktioner är det förbättrade stödet för TI CC3200. Cesanta är officiell partner till Texas Instruments och det var viktigt för oss att säkerställa att vi har starkt stöd för denna populära MCU. Read the full changelogmongoose (1) - Linux man sida mongoose - lätt webbserver mongoose configfile OPTIONS mongoose - A htpasswdfile domännamn användarnamn lösenord Beskrivning mongoose är liten, snabb och enkel att använda webbserver med CGI, SSL, MD5-behörighet och grundläggande SSI-stöd . mongoose lossnar inte från terminal och använder nuvarande arbetsmapp som webbrot, om inte - r-alternativet anges. Det är möjligt att ange flera portar att lyssna på. Till exempel, för att göra mongoose att lyssna på HTTP port 80 och HTTPS port 443, bör man starta det som: mongoose - s cert. pem - p 80,443s. I motsats till andra webbservrar kräver mongoose inte att CGI-skript läggs i en särskild katalog. CGI-skript kan vara var som helst. CGI (och SSI) - filerna känns igen av filnamnsmönstret. mongoose använder skalliknande globmönster med följande syntax: Matchar allt utom slash karaktär, Matchar alla tecken Matchar strängens ände Matchar om mönster på vänster sida eller höger sida matchar. Mönster på vänster sida matchas först Alla övriga tecken i mönstret matchar sig. Om inga argument ges, söker mongoose en konfigurationsfil som heter mongoose. conf i samma katalog där mongoose binär finns. Alternativt kan ett filnamn anges i kommandoraden. Formatet för konfigurationsfilen är detsamma som för kommandoradsalternativen, förutom att varje alternativ måste anges på en separat rad, måste ledande streck för alternativnamn utelämnas. Linjer som börjar med och tomma rader ignoreras. Lades till användarens lösenord i lösenordsfilen. Att radera användare kan göras med någon textredigerare. Funktionalitet liknar Apaches htdigest verktyg. - C cgipattern Alla filer som helt matchar cgipattern behandlas som CGI. Standardmönster tillåter CGI-filer var som helst. För att begränsa CGI till en viss katalog, använd t. ex. - C cgi-bin. cgi. Standard:.cgi. pl. php - E cgienvironment Extra miljövariabler som ska skickas till CGI-skriptet utöver de standardiserade. Listan måste vara kommaseparerad lista över XY-par, så här: VARIABLE1VALUE1, VARIABLE2VALUE2. Standard: - G putdeletepasswordsfile PUT och DELETE lösenord fil. Detta måste anges om PUT eller DELETE metoder används. Standard: - I cgiinterpreter Använd cgiinterpreter som CGI-tolk för alla CGI-skript oavsett scripttillägg. Mongoose bestämmer vilken tolk som ska användas genom att titta på den första raden i ett CGI-skript. Standard: . - M maxrequestize Maximal HTTP-förfrågningsstorlek i byte. Standard: 16384 - P protecturi Kommaseparerad lista över URIPATH-par, som anger att givna URI måste skyddas med respekterade lösenordsfiler. Standard: - R Autentiseringsdomän Auktoriseringsområde. Standard: mydomain - S ssipattern Alla filer som helt matchar ssipattern behandlas som SSI. Okända SSI-direktiv ignoreras tyst. För närvarande stöds två SSI-direktiv, inkluderar och exec. Standard:.shtml. shtm - a accesslogfile Åtkomstloggfil. Standard: Ingen loggning görs. - d enabledirectorylisting Enaktiverbar kataloglista. Standard: ja - e errorlogfile Felloggfil. Standard: Inga fel är inloggade. - g globalpasswordsfile Plats för en global lösenordsfil. Om det är inställt, ignoreras. htpasswd-filer per katalog, och alla förfrågningar måste godkännas mot den filen. Standard: - i indexfiles Kommaseparerad lista över filer som ska behandlas som katalogindexfiler. Standard: index. html, index. htm, index. cgi - l accesscontrollist Ange åtkomstkontrolllista (ACL). ACL är en kommaseparerad lista över IP-undernät, varje delnät är uppbyggt av - eller tecken. Plusmedel tillåter, minusmedel förnekar. Om subnätmasken är utelämnad, som -1.2.3.4 betyder det en enda IP-adress. Masken kan variera från 0 till 32 inklusive. På varje förfrågan går hela listan över och sista matchen vinner. Standardinställningen är att tillåta alla. Till exempel, för att bara tillåta 192.16816-subnät att ansluta, kör mongoose -0.0.0.00,192.16816. Standard: - m extramimetyper Extra mime typer att känna igen, i form extension1type1, extension2type2. . Extension måste innehålla punkt. Exempel: mongoose - m. cppplaintext,.javaplaintext. Standard: - p lyssningsportar Kommaseparerad lista över portar att lyssna på. Om porten är SSL måste en bokstav sändas, till exempel - p 80,443s öppnar port 80 och port 443 och anslutningar på port 443 kommer att vara SSL-ed. Det är möjligt att ange en IP-adress att binda till. I detta fall måste en IP-adress och ett kolon införas i portnumret. Till exempel, för att binda till ett loopback-gränssnitt på port 80 och till alla gränssnitt på HTTPS-port 443, använd mongoose - p 127.0.0.1:80,443s. Standard: 8080 - r dokumentrot Plats för WWW-rotkatalogen. Standard: . sscertificate Plats för SSL-certifikatfil. Standard: - t numthreads Antal arbetstrådar att starta. Standard: 10 - u runasuser Byt till angivna användaruppgifter efter start. Standard: - w urlrewritepatterns Kommaseparerad lista över URL omskrivs i form av patternsubstitution. Om mönstret matchar något prefix för den begärda webbadressen, ersätts det matchade prefixet med substitution. Till exempel, - w configetc,.doc. rtfcgi-binhandledoc. cgi, serverar alla webbadresser som börjar med config från mappen, och anrop handledoc. cgi-skript för. doc och. rtf-filförfrågningar. Om något mönster matchar, utförs ingen ytterligare matchningsbyte (första matchande mönstervinster). Standard: mongoose var utformad för att kunna integreras i CC-applikationer. Eftersom källkoden finns i en enda C-fil är det ganska enkelt att bädda in det och följa uppdateringarna. Vänligen hänvisa till code. googlepmongoose för detaljer. Börja betjäna filer från var Lyssna på port 8080 för HTTP och 8043 för HTTPS-anslutningar. Använd etccert. pem som SSL-certifikatfil. mongoose - l -0.0.0.00,10.0.0.08,1.2.3.4 Förneka anslutningar från överallt, tillåta endast IP-adress 1.2.3.4 och alla IP-adresser från 10.0.0.08-subnät att ansluta. mongoose - w myscript. cgi Inkalla myscript. cgi för varje inkommande begäran, oavsett webbadressen. mongoose är licensierad enligt villkoren i MIT-licensen. BSD 31 aug 2010 BSD
Comments
Post a Comment