xsp4 - Online sa Cloud

PROGRAMA:

NAME

XSP - Mono ASP.NET Web Server (xsp4 at xsp42)

SINOPSIS

xsp4 [mga pagpipilian]

or

mod-mono-server [mga pagpipilian]

or

fastcgi-mono-server [mga pagpipilian]

DESCRIPTION

Ang XSP, mod-mono-server at fastcgi-mono-server ay mga host para sa ASP.NET-based na mga application.

Kung tatakbo bilang `xsp4', ang proseso ay nagbibigay ng isang minimalistic na web server na nagho-host ng ASP.NET
runtime at maaaring gamitin upang subukan at i-debug ang mga web application na gumagamit ng System.Web
mga pasilidad sa Mono. Ang server na ito ay pinaka-maginhawa para sa pagsubok at pagpapatakbo ng maliliit na site,
hindi nag-aalok ng lahat ng iniaalok ng production web server.

Ang `mod-mono-server' at 'fastcgi-mono-server' ay parehong mga host ng ASP.NET runtimes na maaaring
makipag-usap sa isa pang web server (sa oras ng pagsulat na ito, ang Apache 1.3-2.2 ay
suportado sa pamamagitan ng mod_mono at ilang iba pang mga web server sa pamamagitan ng FastCGI). Ang mekanismong ito
ay mas mahusay na ginagamit para sa mga server na may mataas na trapiko o mga sistema ng produksyon, dahil maaari itong isama sa
ang pangunahing HTTP server at gamitin ang lahat ng mga pag-optimize at extension ng isang umiiral na
server, habang nagbibigay ng ASP.NET runtime. Maaari mong piliin ang ginagamit na channel ng komunikasyon
sa pagitan ng mod_mono at mod-mono-server. Kung magbibigay ka ng isang --filename na opsyon, ang unix socket ay
ginamit, kung hindi, maaari kang magbigay ng --port upang gumamit ng TCP socket.

Opsyon

--address addr
Itinatakda ang IP address upang makinig. Bilang default, ito ay 0.0.0.0 para sa xsp4 at 127.0.0.1
para sa mod-mono-server. Pangalan ng key ng AppSettings: MonoServerAddress

--port PORT
Binabago ang default na port kung saan makikinig ang XSP server sa mga kahilingan. Bilang default
Nakikinig ang XSP sa port 8080 at walang default ang mod-mono-server. Pangalan ng key ng AppSettings:
MonoServerPort

--backlog N
Ang backlog ng mga koneksyon na itatakda sa listener socket. Bilang default ang halaga ay
nakatakda sa 500.

--minThreads N
Ang pinakamababang bilang ng mga thread na inilalaan ng threadpool. Taasan ang halagang ito sa
mas mahusay na hawakan ang biglaang pagdating ng mga koneksyon. Natutukoy ang default na halaga
sa pamamagitan ng mono runtime.

--filename file (mod-mono-server at fastcgi-mono-server)
Ang pangalan ng file ng unix socket na pakikinggan. Default na halaga: /tmp/mod_mono_server
(fastcgi-mono-server: /tmp/fastcgi-mono-server) Pangalan ng key ng AppSettings:
UnixSocketFileName (fastcgi-mono-server: MonoUnixSocket)

--ugat PATH
Ang root directory para sa XSP. Ang default ay ang direktoryo kung saan ang XSP ay pinaandar.
Ang kasalukuyang direktoryo ay babaguhin sa isang ito bago gumawa ng anumang application.
Pangalan ng key ng AppSettings: MonoServerRootDir

--appconfigfile FILENAME
Nagdaragdag ng mga kahulugan ng application mula sa XML configuration file. Tingnan ang sample
configuration file na kasama ng server (sample.webapp) at WEBAPP FILE
FORMAT sa ibaba. Pangalan ng key ng AppSettings: MonoApplicationsConfigFile

--appconfigdir DIR
Nagdaragdag ng mga kahulugan ng application mula sa lahat ng XML file na matatagpuan sa tinukoy na direktoryo
DIR. Dapat ay may extension na '.webapp' ang mga file. Pangalan ng key ng AppSettings:
MonoApplicationsConfigDir

--mga aplikasyon APPS
Isang listahan na pinaghihiwalay ng kuwit ng virtual na direktoryo at totoong direktoryo para sa lahat ng
mga application na gusto naming pamahalaan sa server na ito. Ang virtual at tunay na dirs. ay
pinaghihiwalay ng colon. Ang default na halaga ay '/:.'.

Ang ilang mga halimbawa:

'/:.' Ang virtual / ay nakamapa sa kasalukuyang direktoryo.

'/blog:../myblog'
Ang virtual /blog ay nakamapa sa ../myblog

'/:.,/blog:../myblog'
Dalawang application tulad ng mga nasa itaas ang pinangangasiwaan.

myhost.someprovider.net:/blog:../myblog
Ang virtual /blog sa myhost.someprovider.net ay nakamapa sa ../myblog.

--panginoon

Ang pagkakataong ito ay gagamitin ng mod_mono upang lumikha ng ASP.NET
mga aplikasyon kapag hinihiling. Kung ang opsyong ito ay ibinigay, hindi na kailangang magbigay ng a
listahan ng mga application na sisimulan. Nalalapat lang ito sa mod-mono-server.exe.
--walang tigil Bilang default, hihinto ang xsp4/mod-mono-server sa pagproseso ng mga kahilingan kapag ang
pinindot ang return key. Gamitin ito upang maiwasan ang pag-uugaling ito.

--hindi nakatago
Huwag protektahan ang mga nakatagong file/direktoryo mula sa pag-access ng mga kliyente. Nakatago
Ang mga file/direktoryo ay ang mga may Hidden attribute sa Windows at ang pangalan ay nagsisimula
na may tuldok sa Unix. Ang anumang file/direktoryo sa ibaba ng isang nakatagong direktoryo ay hindi naaalis.
Ino-off ng opsyong ito ang default na gawi ng pagprotekta sa mga naturang lokasyon. Kung ang iyong
Ang application ay hindi naglalaman ng anumang mga nakatagong file/direktoryo, maaaring gusto mong gamitin
ang opsyong ito dahil ang proseso ng pagsusuri ay may halaga sa bawat kahilingan. Pangalan ng key ng AppSettings:
MonoServerCheckHiddenFiles (isang boolean na tumatanggap ng 'true' o 'false')

--https
Pinapagana ang suporta ng HTTPS sa server, dapat kang magbigay ng X.509 certificate at a
pribadong key na may alinman sa --cert/--pkfile na mga opsyon o sa --p12file (na
pinagsasama ang parehong sertipiko at ang pribadong key sa isang solong file).

Upang magamit kailangan mo munang lumikha ng isang X.509 na sertipiko para sa iyong server, para sa
halimbawa:
$ makecert -r -eku 1.3.6.1.5.5.7.3.1 -n "CN=server" -p12 server.p12 s3kr3t
Mono MakeCert - bersyon 1.1.9.0
X.509 Tagabuo ng Sertipiko
Copyright 2002, 2003 Motus Technologies. Copyright 2004-2005 Novell. Lisensyado ng BSD.

Tagumpay

Pagkatapos ay dapat mong ipasa ang mga sumusunod na flag sa xsp4:
$ xsp4 --https --p12file server.p12 --pkpwd s3kr3t

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--https-client-accept
Tulad ng --https pinapagana nito ang suporta sa HTTPS sa server. Gayunpaman ang pagpipiliang ito din
magpadala ng "imbitasyon" sa mga kliyente upang magbigay ng mga sertipiko ng kliyente upang patotohanan
kanilang sarili. Ang kliyente ay malayang magbigay, o hindi, ng sertipiko ng kliyente. Web
Maaaring makita ng application kung ang isang sertipiko ng kliyente ay ginamit at tumugon nang naaayon. Karamihan
Ang web browser ay hindi magpapadala ng isang sertipiko ng kliyente maliban kung sila ay tahasan
hiniling na gawin ito.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--https-client-require
Tulad ng --https pinapagana nito ang suporta sa HTTPS sa server. Gayunpaman ang pagpipiliang ito din
nangangailangan mga kliyente na gumamit ng mga sertipiko ng kliyente upang patotohanan ang kanilang mga sarili. Kliyente kung sino
huwag magbigay ng mga sertipiko ng kliyente ay makakatanggap ng isang error. Tandaan na maaaring magpadala ang kliyente
isang walang laman na istraktura ng sertipiko kaya dapat suriin ng web application ang sertipiko
nilalaman.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--p12file FILENAME
Ginamit upang tukuyin ang PKCS#12 file na gagamitin. Kasama sa file na ito ang parehong X.509
certificate at pribadong key na kinakailangan upang i-encrypt ang trapiko ng HTTP.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--cert FILENAME
Ginagamit upang tukuyin ang server X.509 certificate file. Ito ay karaniwang ginagamit sa
--pkfile.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--pkfile FILENAME
Ginagamit upang tukuyin ang landas sa pribadong keyfile. Ang PVK format ay hindi masyadong secure
at dapat mong gamitin ang format na PKCS#12 (--p12file na opsyon) para mag-imbak ng mga bagong pribadong key.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--pkpwd PASSWORD
Kung ang iyong pribadong key ay protektado ng password, ang PASSWORD ay ang password na ginamit upang mag-decote
ang pribadong susi. Gumagana ang opsyong ito para sa parehong PVK at PKCS#12 na mga format.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--protocol PROTOKOL
Tinutukoy kung aling mga protocol ang magagamit para sa pag-encrypt ng mga komunikasyon. Ang
posibleng mga halaga ay Default, Tls at Ssl3. ssl2 ay hindi suportado. Ang default
ang value ay "Default" na awtomatikong nagde-detect ng client protocol at nag-aayos ng server
protocol nang naaayon.

Ang pagpipiliang ito ay may bisa lamang para sa XSP. Para sa mod_mono dapat mong i-configure ang Apache para sa SSL/TLS.

--tapusin (mod-mono-server lamang)
Magalang na tinatapos ang isang tumatakbong instance ng mod-mono-server. Lahat ng iba pang mga pagpipilian ngunit
--filename o --address at --port ay hindi papansinin kung ang pagpipiliang ito ay ibinigay.

--bersyon
Ipinapakita ang impormasyon ng bersyon at paglabas.

- Tumulong Ipinapakita ang listahan ng mga opsyon at labasan.

--verbose
Nagpi-print ng mga karagdagang mensahe. Kapaki-pakinabang para sa pag-debug.

--pidfile FILE
Isinulat ang xsp4 PID sa tinukoy na file.

Mono RUNTIME Opsyon

Ang xsp4 at xsp42 ay mga script na tinatawag na mono. Kung gusto mong ipasa ang mga opsyon sa mono (para sa
halimbawa, mga opsyon upang makakuha ng mga numero ng linya sa mga stack traces), maaari mong gamitin ang MONO_OPTIONS
variable ng kapaligiran kapag gumagamit ng xsp4 o xsp42.

Halimbawa:
$ MONO_OPTIONS=--debug xsp42

DEFAULT INDEX MGA FILE

Maaari mong piliin kung aling mga file ang itinuturing na ginagamit ng index xsp4.exe.config configuration
file tulad nito:


<add key="MonoServerDefaultIndexFiles"
value="index.aspx" />


Bilang default, mayroon itong index.aspx, Default.aspx, default.aspx, index.html at index.htm. Ang
mahalaga ang order.

WEBAPP FILE FORMAT

Ang format ng mga .webapp na file na ginagamit para sa --appconfigfile at --appconfigdir ay:



{appname}
{virtual host para sa aplikasyon}
{port para sa application}
{virtual na direktoryo sa apache}
{physical path to aspx files}
is true by default -->
{true|false}



Maaari mong isama ang anumang bilang ng node, isa sa bawat ASP.NET application na tatakbo.

Mayroong isang sample.webapp file sa direktoryo ng mga sample ng XSP.

MGA AUTHORS

Ang Mono XSP server ay isinulat ni Gonzalo Paniagua Javier ([protektado ng email]). Fastcgi-
Ang mono-server ay isinulat ni Brian Nickelhttp://kerrick.wordpress.com>.

Kapaligiran MGA VARIABLE

MONO_ASPNET_NODELETE
Kung nakatakda sa anumang halaga, pansamantalang source file na nabuo ng ASP.NET support classes
hindi matatanggal. Itatago ang mga ito sa pansamantalang direktoryo ng user.

Gumamit ng xsp4 online gamit ang mga serbisyo ng onworks.net