MeowMeow

Meowmeow -Webserver (ehemals Ghost Webserver)

Abstrakt

Dies ist ein einfacher Webserver, der in Plain Erlang geschrieben wurde.

Erlang Version

Erlang/OTP 23 muss diesen Server ausführen. Erlang/OTP 24 wird reflektiert.

Läuft

Debug -Modus

Der beste Weg, um das Programm zu debuggen, besteht darin, nur zu folgen:

 $ cd src/
$ erlc *.erl && erl; rm -rf ./*.beam # This will rebuild everything from scratch, so there would be no problems with cached files
...
Eshell V11.2  (abort with ^G)
1> server:start().

Vergessen Sie vor der Verwendung dieses Ansatzes nicht, Konfigurationsdateien zu erstellen:

 $ cp -r configs/ /etc/MeowMeow/ # Porbably you will need root(i.e. sudo)

Produktionsmodus

Kompilieren Sie mit Rebar3:

 $ rebar3 as prod release

Dann müssen Sie Konfigurationen in /etc/MeowMeow/ erstellen. Danach können Sie Server ausführen:

 $ ./_build/prod/rel/MeowMeow/bin/MeowMeow <desired mode of running>

Wenn Sie Hilfe beim Ausführen von Modi benötigen, um Skript ohne Argumente auszuführen, um Hilfe zu erhalten.

Verwendung

Setzen Sie Ihre Dateien in /var/www/ verzeichnis. Sie werden statisch bedient. Derzeit sind FASTCGI -Unterstützung für die Servieren von Dateien verfügbar, die nicht statisch sind.

Konfigurieren

Wichtiger Hinweis: In aktuellen Versionssyntaxfehlern in der Konfiguration werden nicht überprüft, sodass eine Missverständnis zu tödlichen Fehlern führen kann.

Server

Die Serverkonfiguration wird in /etc/MeowMeow/meow.conf gespeichert. Die Syntax ist wie folgt:

 Directive1 Args
Directive2 Args

Aktuelle Versionsunterstützung nach Anweisungen:

• LogLevel <<LEVEL>> Die Protokollierungsstufe von 0 bis 4 festlegen (0 - Nichts, 4 - Alles protokollieren)
• KeepAlive <<MS>> Standardverbindung Keep-Alive-Zeit in Millisekunden
• ListenPort <<PORT>> Port, wo Sie auf Verbindungen hören können
• ListenHost <<HOSTNAME/IP>> Hostname zum Anhören
• DocDir <<DIRECTORY>> Verzeichnis mit Dateien zu dienen

Routen

Um Routen zu konfigurieren, müssen Sie /etc/MeowMeow/routes.conf bearbeiten. Die Syntax ist wie folgt:

 Route <wildcard pattern> 
 Directive1 Args 
 Directive2 Args
 Host <wildcard pattern>
  Directive3 Args
 End
End

Route definiert das Muster von Anforderungspfaden, für die Richtlinien angewendet würden. Zusätzlich können Richtlinien mit Host -Header angewendet werden (wie in einem Beispiel oben). Die Anweisungen werden in der Reihenfolge angewendet, da sie in der Konfigurationsdatei hinzugefügt wurden. Die derzeit vom Server unterstützten Richtlinien:

• Abort <<CODE>> - Bearbeiten Sie die Anforderung an und senden Sie HTTP/1.1 Statuscode <<CODE>> an den Client
• No-Content - sendet HTTP/1.1 204 No Content an den Client
• Disallow - sendet HTTP/1.1 403 Forbidden an den Kunden
• Set-Header <<HEADER>> <<VALUE>> - Legt die Antwort Header <<HEADER>> zu <<VALUE>> fest
• ExecFCGI <<FILE>> <<FCGI_HOST>> <<FCGI_PORT>> <<FCGI_TIMEOUT>> - fragt Fastcgi, die auf <<FCGI_HOST>>:<<FCGI_PORT>> ausführen <<FILE>> mit Timeout von <<FCGI_TIMEOUT>> ms ausgeführt wird.
• Set-Code <<CODE>> Legt den Statuscode für eine Antwort fest.
• Send-File <<PATH>> sendet die Datei als Antwort.

Sie können hier ein Beispiel für die Konfiguration von Routing -Regeln sehen

Credits

• ERL_FASTCGI - Copyright 2017, Marcelo Gornstein [email protected] (Apache -2.0 -Lizenz).
  Eingeführte Änderungen (Datei: src/erl_fastcgi.erl ):
  • Protokollierung in den Meowmeow -Webserver hinzugefügt
  • Fehlgeschlagene Handhabung von Fehlern hinzugefügt, wenn der FastCGI -Server ausgefallen ist

Code -Urheberrechte

Die in einigen Dateien in src/ Directory definierten Code -Urheberrechnung sind keine Rechtsberatung und sind nur für den internen Gebrauch gezwungen. Der gesamte Code, außer im Abschnitt Credits erwähnt, ist unter der MIT -Lizenz lizenziert (weitere Informationen finden Sie unter Lizenz)