ouistiti

OUISTITI - เซิร์ฟเวอร์ HTTP ที่โดดเด่นขนาดเล็ก

ouistiti

Ouistiti (ˈwistiti) เป็นชื่อฝรั่งเศสของ Marmoset ซึ่งเป็นลิงเล็ก ๆ ของโลกใหม่

Ouistiti เป็นเว็บเซิร์ฟเวอร์ขนาดเล็กในการจัดการและกำหนดค่าอุปกรณ์ขนาดเล็ก อนุญาตให้สร้าง เว็บอินเตอร์เฟสแบบครบวงจร เพื่อ ความปลอดภัย บน เอกสาร , WebSocket , REST API และอื่น ๆ

Ouistiti ทุ่มเทให้ฝังอยู่บนอุปกรณ์เพื่อควบคุมจากเว็บเซิร์ฟเวอร์

ด้วย Ouistiti , ทุกหน้า, websockets, สคริปต์ได้รับการปกป้องด้วยวิธีเดียวกัน มันไม่มีประโยชน์ในการจัดการการรับรองความถูกต้องด้วยตัวเอง

คุณสมบัติ

รุ่น HTTP หลายรุ่น:

• HTTP/0.9 HTTP/1.0 HTTP/1.1 : Ouistiti สามารถจัดการโปรโตคอล HTTP แต่ละรุ่นจากคำขอหรือยอมรับเฉพาะคำขอของเวอร์ชันเดียวเท่านั้น
• Keep Alive Connection: การเชื่อมต่อไคลเอนต์อาจใช้สำหรับคำขอหลายอย่าง
• คำขอ ไปป์ไลน์ : Ouistiti สามารถรับคำขอได้ในระหว่างการจัดการของคำสั่งก่อนหน้านี้ในการเชื่อมต่อเดียวกัน

รักษาความปลอดภัย http - https :

การเชื่อมต่อ TLS/SSL มีอยู่เป็นโมดูลที่มีไลบรารี MBEDTLS หรือ OPENSSL

การรับรองความถูกต้อง:

การรับรองความถูก ต้องมีอยู่ใน การเชื่อมต่อของไคลเอนต์ทั้งหมด รหัสผ่านของผู้ใช้อาจถูกเข้ารหัสสำหรับที่เก็บข้อมูล สนับสนุนความท้าทายต่อไปนี้:

• การตรวจสอบขั้นพื้นฐาน : Ouistiti สามารถตรวจสอบผู้ใช้ด้วยวิธีที่ง่ายที่สุด
• Digest Authentication : Ouistiti อนุญาตให้สร้างหน้าการเชื่อมต่อของคุณและตรวจสอบสิทธิ์
• การรับรองความถูกต้องของผู้ถือ : Ouistiti สามารถสร้างโทเค็นและอินสแตนซ์ทั้งหมดของ Ouistiti สามารถตรวจสอบโทเค็นนี้ในโดเมนเครือข่ายเดียวกัน
• OpenID Authentication : จัดการผู้ใช้บนเซิร์ฟเวอร์ OpenID (เช่น Google) และ Ouistiti ตรวจสอบสิทธิ์ของผู้ใช้

WebSocket:

โมดูลสร้าง สะพาน WebSocket ระหว่าง HTTP Socket Client และ UNIX Socket สามารถจัดการการจับมือกันและการถ่ายโอนข้อมูลไปยังแอปพลิเคชันของคุณ คุณพัฒนาเซิร์ฟเวอร์ Cammands บนซ็อกเก็ต Unix Ouistiti ปกป้องด้วยการเชื่อมต่อ HTTPS และประตูการตรวจสอบสิทธิ์ คุณสามารถค้นหาตัวอย่างของเซิร์ฟเวอร์:

• เซิร์ฟเวอร์ แชท
• เซิร์ฟเวอร์ JSONRPC
• เซิร์ฟเวอร์ SQLite DB
• เซิร์ฟเวอร์ เจริญเติบโตอย่างรวดเร็ว

Webstream:

เช่นเดียวกับ WebSocket Ouistiti สามารถปกป้อง เซิร์ฟเวอร์สตรีมของ คุณได้ แอปพลิเคชันของคุณควรส่งข้อมูลบนซ็อกเก็ต Unix เท่านั้น Ouistiti จะทำส่วนที่เหลือ

• MP3 Music ออกอากาศด้วย Pump Up the Volume
• Motion-JPEG Streamer เพื่อสตรีมกล้องผ่าน HTTP
• สตรีม ข้อมูล JSON

เอกสารคงที่:

เช่นเดียวกับเว็บเซิร์ฟเวอร์ใด ๆ Ouistiti สามารถส่งไฟล์ใด ๆ ไปยังไคลเอนต์ของคุณได้ และในเวลาเดียวกันก็สามารถจัดการได้บนเซิร์ฟเวอร์ของคุณ:

• REST API : อนุญาตให้จัดการไฟล์เอกสารด้วย REST API เพื่ออัปโหลดลบเปลี่ยนชื่อไฟล์บนเซิร์ฟเวอร์โดยตรง
• Home Directory : ผู้ใช้แต่ละคนสามารถจัดการไดเรกทอรีของเขาเองด้วย สิทธิ์ส่วนตัว ของเขา
• คำขอช่วง : ไฟล์อาจถูกแบ่งออกเป็นชิ้น ๆ มากมายสำหรับการดาวน์โหลด

CGI/1.1:

สคริปต์ CGI อาจโทรจากลูกค้า

เปลี่ยนเส้นทาง:

URI บางตัวจะต้องเปลี่ยนเส้นทางใน URI อื่น โมดูลนี้ทำอย่างนั้นด้วยไฟล์กำหนดค่าเท่านั้น

• ไฟล์ ไปยังไฟล์อื่น
• ข้อผิดพลาด กับไฟล์
• สร้าง -204 เพื่อเลียนแบบเกตเวย์ WiFi

การกรองการเชื่อมต่อ:

เซิร์ฟเวอร์อาจเริ่มต้นด้วย บัญชีดำ และที่อยู่ IP ที่อนุญาต

การกรองผู้ใช้:

เซิร์ฟเวอร์เก็บไว้ในฐานข้อมูลกฎเกี่ยวกับการเข้าถึง URI กฎการรวมกันของ "บทบาท" ของผู้ใช้ประเภทของคำขอและนิพจน์บน URI แต่ละคำขอจะถูกตรวจสอบหลังจากการตรวจสอบและก่อนที่จะเข้าถึง ressource

โมดูลมี RESTAPI ของตัวเองเพื่อตั้งค่าฐานข้อมูลและใช้โมดูลการรับรองความถูกต้องสำหรับการตรวจสอบสิทธิ์

อัพเกรด:

โมดูลนี้สามารถอัพเกรดการเชื่อมต่อและถ่ายโอนข้อมูลระหว่างซ็อกเก็ตที่เปิดและเซิร์ฟเวอร์ซ็อกเก็ต Unix

เซิร์ฟเวอร์ UNIX อาจส่งและรับข้อมูลประเภทใดก็ได้บนซ็อกเก็ต ช่วยให้นำเซิร์ฟเวอร์ที่ไม่ปลอดภัยกลับมาใช้ใหม่และใช้คุณสมบัติ HTTP เช่นการตรวจสอบสิทธิ์และการเชื่อมต่อ TLS

มันถูกปิดไปยังโมดูล WebSocket แต่อาจเป็นประโยชน์สำหรับโปรโตคอลบางอย่างผ่าน HTTP

Python:

โมดูลนี้เรียกใช้ล่าม Python เพื่อเรียกสคริปต์ ปัจจุบันโมดูลนี้กำลังจัดเตรียมและต้องการเรียกใช้ไซต์ Django

การทำเกลียวโมโนหรือหลายเธรด:

Ouistiti อาจถูกสร้างขึ้นเพื่อจัดการการเชื่อมต่อไคลเอนต์ด้วยกระบวนการเดียวเพื่อเป็น เว็บเซิร์ฟเวอร์ที่เร็วที่สุด หรืออาจสร้างกระบวนการที่เป็นอิสระสำหรับการเชื่อมต่อไคลเอนต์แต่ละครั้งเพื่อสร้าง กล่องทราย รอบ ๆ

การพึ่งพาอาศัยกัน

Ouistiti ถูกเขียนขึ้นเพื่อสร้างบนระบบสูงสุด รหัสเป็นไปตามมาตรฐาน C99 เธรดอาจถูกปิดใช้งานและการกำหนดค่าอาจโหลดจากหน่วยความจำ

libhttpserver (libouistiti)

Ouistiti สร้างขึ้นเหนือไลบรารี libhttpserver ห้องสมุดนี้มี HTTP Parser, การจัดการของซ็อกเก็ตและโมดูลทั่วไปบางอย่าง

โครงการมีอยู่ใน GitHub

libhttpserver อาจถูกเปลี่ยนชื่อ libouistiti เมื่อแหล่งที่มาของห้องสมุดมีอยู่ในโครงการ Ouistiti

Libb64

โครงการ LIBB64 เป็นสิ่งจำเป็นด้วยแพทช์บางอย่าง แหล่งที่มามีอยู่ในโครงการ Ouistiti-Project หรือ Inside Ouistiti

ห้องสมุดเข้ารหัส

การสนับสนุน SSL/TLS อาจจัดทำโดยหลายห้องสมุด:

• ห้องสมุด Mbedtls
• ห้องสมุด OpenSsl

สำหรับกล่องโต้ตอบการตรวจสอบความถูกต้องกับไคลเอนต์รหัสผ่านอาจถูกเข้ารหัสด้วยอัลกอริทึม MD5 (อันนี้ไม่ปลอดภัย แต่ก็จำเป็นอย่างน้อยสำหรับการตรวจสอบขั้นพื้นฐานและการตรวจสอบข้อมูลย่อย) หาก SSL/TLS ไม่พร้อมใช้งานไลบรารี MD5 หนึ่งห้องนั้นจำเป็นสำหรับโมดูลการตรวจสอบความถูกต้อง:

• ห้องสมุด MD5-C
• ไลบรารี libmd5-rfc

ไลบรารีเธรด

Ouistiti ไม่สามารถใช้ไลบรารี pthread ซึ่งขึ้นอยู่กับการกำหนดค่า แต่เครื่องมือบางอย่างอาจใช้ไลบรารี pthread เช่นเซิร์ฟเวอร์ WebSocket

การกำหนดค่า

Ouistiti ใช้ไลบรารี libconfig เพื่อตั้งค่าเซิร์ฟเวอร์และโมดูลที่แตกต่างกัน

เอกสาร: mod_auth

ห้องสมุดอื่น ๆ

• Jansson Library สำหรับ JWT ภายในโมดูลการรับรองความถูกต้อง
• SQLite Library เพื่อจัดการฐานข้อมูลผู้ใช้ของการรับรองความถูกต้อง

รองรับแพลตฟอร์ม

เวอร์ชันแรกวิ่งบน Linux และ Windows ปัจจุบันมีการทดสอบเฉพาะเวอร์ชัน Linux เท่านั้น

สร้างและติดตั้ง

การดาวน์โหลด

ขั้นตอนแรกดาวน์โหลดแผนผังต้นทาง

    $ git clone https://github.com/ouistiti-project/ouistiti

และโครงการ libhttpserver

    $ git clone https://github.com/ouistiti-project/libhttpserver

มี 2 ​​วิธีในการสร้าง:

• สร้าง libhtppserver นอกต้น ouistiti
• เพิ่มไดเร็กทอรี libhttpserver ภายในรากของ ouistiti

การกำหนดค่า

โครงการใช้ Makemore เพื่อสร้างไบนารีทั้งหมด

MakeMore มีไฟล์ gnumake และสคริปต์ กำหนดค่า สคริปต์ใช้เพื่อเขียนไฟล์ กำหนดค่า จากไฟล์ default.config ด้วย การกำหนดค่า คุณสามารถเลือกไดเรกทอรีการติดตั้งและชิ้นส่วนที่จะสร้าง

$ ./configure --prefix=/usr --libdir=/usr/lib/ouistiti --sysconfdir=/etc/ouistiti

Makemore อาจทำงานเป็น kbuild makefile เป็นไปได้ที่จะเลือกไฟล์การกำหนดค่าโดยตรงด้วย Make

การกำหนดค่าอื่น ๆ นั้นมีอยู่ภายใน configs/ directory: * fastmono_defconfig สำหรับเซิร์ฟเวอร์ที่รวดเร็ว แต่ไม่มีการป้องกันการชน * FullForKed_DefConfig สำหรับเซิร์ฟเวอร์ซึ่งสามารถทำงานต่อไปหลังจากการเชื่อมต่อล่มของการเชื่อมต่อ

$ make fastmono_defconfig

หรือ

$ make fullforked_defconfig

หรือสำหรับการกำหนดค่าเริ่มต้น:

$ make defconfig

สำหรับอุปกรณ์ฝังตัวเช่นเกตเวย์หรือกล่องแนะนำให้ใช้ FullForked_defconfig

สร้างการกำหนดค่า:

การกำหนดค่าเป็นไฟล์ข้อความที่มีฟิลด์และค่า ไฟล์ defconfig บนไดเรกทอรีรูทจะต้องไม่เปลี่ยนแปลง เป็นไปได้ที่จะแก้ไขหรือคัดลอกไฟล์ที่มีอยู่ใน configs/ directory

ฟิลด์

• file_config: ใช้ไฟล์ ouistiti.conf สำหรับการกำหนดค่า

• VTHREAD: เปิดใช้งานมัลติเธรดลงในเซิร์ฟเวอร์

• vthread_type: ใช้ค่าเช่น [Fork | Pthread | Windows] เพื่อระบุวิธีการจัดการเธรด

• แบบคงที่: สร้างแอปพลิเคชัน, ห้องสมุด (libhttpserver, libouiutils ... ) และโมดูลเป็นไบนารีแบบสแตนด์อโลน

• แบ่งปัน: สร้าง/เชื่อมโยงไลบรารีแบบไดนามิก (libhttpserver, ... ) และแอปพลิเคชันที่มีโมดูลรวม

• โมดูล: สร้างโมดูลเป็นไลบรารีแบบไดนามิกแอปพลิเคชันจะโหลดในเวลาทำงาน

• max_servers: อนุญาตให้เลือกจำนวนเซิร์ฟเวอร์และโฮสต์เสมือนเพื่อจัดการ

การกำหนดค่าโมดูล:

• Mbedtls: สร้างการสนับสนุน SSL/TLS ด้วย mbedtls
• CGI: สร้างการสนับสนุน CGI/1.1
• เอกสาร: สร้างโมดูลเอกสาร
• Auth: สร้างโมดูลการตรวจสอบความถูกต้อง
• Vhost: สร้างส่วนขยายของโฮสติ้งเสมือนจริง
• WebSocket: สร้างโมดูล WebSocket
• ClientFilter: สร้างโมดูลการกรองการเชื่อมต่อ
• UserFilter: สร้างโมดูล UserFilter

การรวบรวม

การรวบรวมทำด้วย GMake และยอมรับการกำหนดค่าในบรรทัดคำสั่ง

Ouistiti พร้อมใช้ งานการดีบัก ตัวเลือกเฉพาะเพื่อเพิ่มร่องรอยในรหัสและสัญลักษณ์การดีบัก

$ make DEBUG=y

[MakeMore] อนุญาตให้ดูบรรทัดการรวบรวมด้วยตัวเลือก V :

$ make V=1

การรวบรวมข้าม

Ouistiti อาจถูกสร้างขึ้นสำหรับเป้าหมายอื่นนอกเหนือจาก Build Host ในการทำเช่นนั้นคุณต้องเพิ่มการกำหนดค่าบางอย่าง:

• Cross_compile: กำหนดคำนำหน้า GCC ที่จะใช้
• SYSROOT: กำหนดเส้นทางของ SYSROOT ซึ่งเครื่องมือควรค้นหาการพึ่งพา

$ make CROSS_COMPILE=arm-linux-gnueabihf

การติดตั้ง

การติดตั้งเริ่มต้นจะคัดลอกไลบรารีลงใน /usr/local/lib/ ไดเรกทอรีและไบนารีเข้าสู่ /usr/local/bin ด้วยการกำหนดค่าเริ่มต้น เส้นทางอาจมีการเปลี่ยนแปลงในระหว่างการกำหนดค่าโครงการ (ดูด้านล่าง)

 > make install

ในการสร้างแผนผังไดเรกทอรีใหม่ก่อนการติดตั้งตัวแปร destdir อาจมีการเปลี่ยนแปลง

 > make DESTDIR= ~ /packages/ouistiti install

การบรรจุหีบห่อ

Ouistiti จัดจำหน่ายด้วยสูตรอาหารเพื่อสร้างแพ็คเกจการกระจาย

• buildroot
• Yocto
• การหย่อน
• เดเบียน

การกำหนดค่า

Ouistiti ใช้ libconfig สำหรับการกำหนดค่า ค้นหาข้อมูลเพิ่มเติมในบทการกำหนดค่า

การแสดง

ขนาดไบนารี

Ouistiti อนุญาตให้เลือกแต่ละคุณสมบัติที่คุณต้องการในระหว่างการกำหนดค่าการสร้าง การกำหนดค่าเริ่มต้นอนุญาตให้ใช้คุณสมบัติทั้งหมดในสถานที่ขั้นต่ำ

ที่นี่มีขนาดบางขนาดสำหรับแขนหลังจากลอก:

• คุณสมบัติทั้งหมดที่เชื่อมโยงกันแบบคงที่: 154ko + (Mbedtls, libconfig, SQLite3, ห้องสมุด Crypt และ C)
• การกำหนดค่าขนาดเล็ก (เอกสาร): 73KO + (ไลบรารี C)
• ด้วยคุณสมบัติเป็นโมดูล: 24KO + 158KO ของโมดูล + 60KO ของ libhttpserver และไลบรารีอื่น ๆ

การใช้หน่วยความจำ

การใช้หน่วยความจำขึ้นอยู่กับการกำหนดค่าการสร้างและจำนวนการเชื่อมต่อพร้อมกัน

ด้วยการกำหนดค่าเริ่มต้นสำหรับสถาปัตยกรรม ARM การใช้งานอยู่ที่ประมาณ 4.5mo สำหรับกระบวนการหลักและประมาณ 13.5mo สำหรับการเชื่อมต่อของลูกค้าแต่ละราย แต่การกำหนดค่าขนาดเล็กต้องการเพียง 5.5 เดือน

ด้วยกระบวนการเดียวใน Ouistiti Vmsize อยู่ที่ประมาณ 26mo

หน้าประสิทธิภาพให้ข้อมูลเพิ่มเติมเกี่ยวกับการใช้หน่วยความจำ

การกำหนดเวลา

Ouistiti ไม่ใช่เว็บเซิร์ฟเวอร์สำหรับเครือข่ายขนาดใหญ่ แต่ได้ผลลัพธ์ที่ดีสำหรับการส่งเอกสาร การแสดงขึ้นอยู่กับการกำหนดค่าการสร้างและคุณต้องการ

• เพื่อให้ได้ผลลัพธ์ที่ดีที่สุด Ouistiti จำเป็นต้องสร้างโดยไม่ต้องจัดการเธรด (vthread = n)
• เพื่อให้ได้ความปลอดภัยสูงสุด ouistiti จำเป็นต้องสร้างด้วยกระบวนการหนึ่งต่อไคลเอนต์ (vhtread = y และ vthread_type = fork)

Ouistiti อาจเร็วกว่า LightTPD 1.4 แต่ไม่มีคุณสมบัติทั้งหมด คุณสามารถค้นหาผลการทดสอบบางอย่างในหน้าประสิทธิภาพ