ouistiti

Ouistiti - server http unggulan kecil

Ouistiti

Ouistiti (ˈwistiti) adalah nama Prancis dari Marmoset monyet kecil dari dunia baru.

Ouistiti adalah server web kecil untuk mengelola dan mengkonfigurasi perangkat kecil. Ini memungkinkan untuk membuat antarmuka web terpadu untuk keamanan pada dokumen , WebSocket , REST API dan banyak lagi.

Ouistiti didedikasikan untuk tertanam pada perangkat untuk dikontrol dari server web.

Dengan Ouistiti , semua halaman, websockets, skrip dilindungi dengan cara yang sama. Tidak ada gunanya mengelola otentikasi dengan diri Anda sendiri.

Fitur

Versi multi http:

• Http/0.9 http/1.0 http/1.1 : Ouistiti dapat mengelola setiap versi protokol HTTP dari permintaan atau hanya menerima permintaan satu versi.
• Keep Alive Connection: Koneksi klien dapat digunakan untuk beberapa permintaan.
• Permintaan Pipa : Ouistiti dapat menerima permintaan selama pengelolaan yang sebelumnya dalam koneksi yang sama.

Http aman - https :

Koneksi TLS/SSL tersedia sebagai modul dengan MBEDTLS atau OpenSSL Library.

Otentikasi:

Otentikasi tersedia di semua koneksi klien . Kata sandi pengguna mungkin dienkripsi untuk penyimpanan. Tantangan berikut didukung:

• Otentikasi Dasar : Ouistiti dapat memeriksa pengguna dengan cara paling sederhana.
• Digest Authentication : Ouistiti memungkinkan untuk membuat halaman koneksi Anda dan memeriksa haknya.
• Authentication Bearer : Ouistiti dapat membuat token dan semua contoh Ouistiti dapat memeriksa token ini pada domain jaringan yang sama.
• OpenID Authentication : Kelola pengguna di server OpenID (seperti Google) dan Ouistiti memeriksa hak pengguna di atasnya.

Websocket:

Modul membangun jembatan websocket antara klien soket http dan soket unix. Ini dapat mengelola jabat tangan dan transfer data ke aplikasi Anda. Anda mengembangkan server Cammands di soket UNIX, Ouistiti melindunginya dengan koneksi HTTPS dan gerbang otentikasi. Anda dapat menemukan contoh server:

• server obrolan
• Server JSONRPC
• SQLite DB Server
• server hemat

WebStream:

Seperti Websocket , Ouistiti dapat melindungi server stream Anda. Aplikasi Anda hanya boleh mengirim data pada soket UNIX, Ouistiti melakukan sisanya.

• Mp3 Music Broadcast dengan Pump Up the Volume.
• Motion-JPEG Streamer untuk streaming kamera melalui HTTP.
• JSON Data Streamer.

Dokumen Statis:

Seperti server web lainnya, Ouistiti dapat mengirim segala jenis file ke klien Anda. Dan pada saat yang sama dapat mengelolanya di server Anda:

• REST API : Ini memungkinkan untuk mengelola file dokumen dengan API REST untuk mengunggah, menghapus, mengganti nama file secara langsung di server.
• Home Directory : Setiap pengguna dapat mengelola direktori sendiri dengan hak -hak pribadinya .
• Permintaan Range : File dapat dibagi menjadi banyak potongan untuk diunduh.

CGI/1.1:

Script CGI dapat dihubungi dari klien.

Redirect:

Beberapa URI harus dialihkan pada URI lain. Modul ini melakukannya dengan hanya file konfigurasi.

• file ke file lain.
• kesalahan ke file.
• menghasilkan-204 untuk meniru gateway wifi.

Penyaringan Koneksi:

Server dapat dimulai dengan daftar hitam dan daftar putih alamat IP.

Pengguna Filtering:

Server menyimpan ke dalam database aturan tentang akses URI. Aturan adalah kombinasi dari "peran" pengguna, jenis permintaan dan ekspresi pada URI. Setiap permintaan diperiksa setelah otentikasi dan sebelum mengakses ke resource.

Modul berisi RESTAPI sendiri untuk mengatur database, dan menggunakan modul otentikasi untuk pemeriksaan hak.

Meningkatkan:

Modul ini dapat meningkatkan koneksi dan mentransfer data antara soket yang dibuka dan server soket UNIX.

Server UNIX dapat mengirim dan menerima segala jenis data di soket. Ini memungkinkan untuk menggunakan kembali server yang tidak aman dan menggunakan fitur HTTP seperti otentikasi dan koneksi TLS.

Ini ditutup untuk modul Websocket, tetapi mungkin berguna untuk beberapa protokol melalui HTTP.

Python:

Modul ini menjalankan interpretor Python untuk memanggil skrip. Saat ini, modul ini dipentaskan dan ingin menjalankan situs Django.

Mono Threading atau Multi Threading:

Ouistiti dapat dibangun untuk mengelola koneksi klien dengan hanya satu proses, untuk menjadi server web tercepat . Atau dapat membuat proses independen untuk setiap koneksi klien, untuk membuat kotak pasir di sekitarnya.

Dependensi

Ouistiti ditulis untuk dibangun di atas sistem maksimum. Kode sesuai dengan C99, utas dapat dinonaktifkan dan konfigurasi dapat dimuat dari memori.

libhttpserver (libouistiti)

Ouistiti dibangun di atas Perpustakaan Libhttpserver. Perpustakaan ini berisi parser http, manajemen soket dan beberapa modul generik.

Proyek ini tersedia di GitHub

libhttpserver dapat diganti namanya menjadi libouistiti ketika sumber perpustakaan tersedia di dalam proyek ouistiti .

libb64

Proyek LIBB64 wajib dengan beberapa tambalan. Sumber tersedia dalam proyek Ouistiti atau di dalam proyek Ouistiti .

Perpustakaan Kriptografi

Dukungan SSL/TLS dapat disediakan oleh beberapa perpustakaan:

• Perpustakaan Mbedtls
• Perpustakaan OpenSSL

Untuk dialog otentikasi dengan klien, kata sandi dapat dienkripsi dengan algoritma MD5 (yang ini tidak aman, tetapi setidaknya wajib untuk otentikasi dasar dan pencernaan). Jika SSL/TLS tidak tersedia, satu perpustakaan MD5 wajib untuk modul otentikasi:

• Perpustakaan MD5-C
• Perpustakaan libmd5-rfc

Perpustakaan Thread

Ouistiti tidak boleh menggunakan pustaka pthread, ini tergantung pada konfigurasi. Tetapi beberapa alat dapat menggunakan pustaka pthread seperti server WebSocket.

Konfigurasi

Ouistiti menggunakan perpustakaan libconfig, untuk mengatur server, dan modul yang berbeda.

Dokumentasi: mod_auth

perpustakaan lainnya

• Perpustakaan Jansson untuk JWT di dalam modul otentikasi
• Perpustakaan SQLite untuk mengelola database pengguna otentikasi

Dukungan platform

Versi pertama berjalan di Linux dan Windows. Saat ini hanya versi Linux yang diuji.

Bangun dan Instalasi

Unduh

Langkah pertama mengunduh pohon sumber.

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

Dan proyek libhttpserver

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

Ada 2 cara untuk membangun:

• Bangun Libhtppserver di luar pohon ouistiti
• Tambahkan direktori libhttpserver di dalam akar ouistiti

Konfigurasi

Proyek ini menggunakan Makemore untuk membangun semua binari.

Makemore berisi file gnumake dan skrip konfigurasi . Script digunakan untuk menulis file konfigurasi dari file default.config . Dengan konfigurasi Anda dapat memilih direktori instalasi dan bagian yang akan dibangun.

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

Makemore dapat berjalan sebagai KBuild Makefile. Dimungkinkan untuk memilih file konfigurasi secara langsung dengan Make.

Konfigurasi lain tersedia di dalam konfigurasi/ direktori: * fastmono_defconfig untuk server cepat tetapi tanpa perlindungan crash. * fullforked_defconfig untuk server yang dapat terus berjalan setelah kehancuran koneksi.

$ make fastmono_defconfig

atau

$ make fullforked_defconfig

atau untuk konfigurasi default:

$ make defconfig

Untuk perangkat tertanam seperti gateway atau kotak, fullforked_defconfig direkomendasikan.

Bangun konfigurasi:

Konfigurasi adalah file teks dengan bidang dan nilai. File defconfig pada direktori root tidak boleh diubah. Dimungkinkan untuk memodifikasi atau menyalin file yang ada di Configs/ Directory.

Ladang

• File_config: Gunakan file ouistiti.conf untuk konfigurasi.

• VThread: Aktifkan multithreading ke server.

• VTHREAD_TYPE: Ambil nilai seperti [fork | pthread | windows] untuk menentukan cara mengelola utas.

• Statis: Bangun aplikasi, pustaka (libhttpserver, libouiutils ...) dan modul menjadi biner mandiri.

• Dibagi: Bangun/tautkan pustaka dinamis (libhttpserver, ...) dan aplikasi dengan modul terintegrasi.

• Modul: Bangun modul sebagai pustaka dinamis, aplikasi akan memuat pada waktu berjalan.

• MAX_SERVERS: Izinkan untuk memilih jumlah server dan host virtual untuk dikelola.

Konfigurasi Modul:

• MBEDTLS: Bangun dukungan SSL/TLS dengan MBEDTLS.
• CGI: Bangun dukungan CGI/1.1.
• Dokumen: Bangun modul dokumen.
• AUTH: Bangun modul otentikasi.
• Vhost: Bangun ekstensi hosting virtual
• WebSocket: Bangun modul WebSocket.
• ClientFilter: Bangun modul penyaringan koneksi.
• UserFilter: Bangun modul UserFilter.

Kompilasi

Kompilasi dilakukan dengan Gmake dan menerima konfigurasi di baris perintah.

Ouistiti tersedia Debug opsi tertentu untuk menambahkan jejak dalam kode dan simbol debug.

$ make DEBUG=y

[Makemore] memungkinkan untuk menonton garis kompilasi dengan opsi V :

$ make V=1

Kompilasi silang

Ouistiti dapat dibangun untuk target lain selain pembuatan host. Untuk melakukan itu, Anda perlu menambahkan beberapa konfigurasi:

• Cross_Compile: Menentukan awalan GCC untuk digunakan.
• Sysroot: Menentukan jalur sysroot di mana alat harus menemukan ketergantungan.

$ make CROSS_COMPILE=arm-linux-gnueabihf

Instalasi

Instalasi default akan menyalin perpustakaan ke /usr/local/lib/ direktori, dan biner ke /usr/lokal/bin dengan konfigurasi default. Jalur dapat diubah selama konfigurasi proyek (lihat di bawah)

 > make install

Untuk membuat pohon direktori baru sebelum instalasi, variabel destdir dapat diubah.

 > make DESTDIR= ~ /packages/ouistiti install

Kemasan

Ouistiti didistribusikan dengan resep untuk membangun paket distribusi.

• Buildroot
• yocto
• Slackware
• Debian

Konfigurasi

Ouistiti menggunakan libconfig untuk konfigurasi. Temukan informasi lebih lanjut ke bab Konfigurasi.

Pertunjukan

Ukuran biner

Ouistiti memungkinkan untuk memilih setiap fitur yang Anda butuhkan selama konfigurasi build. Konfigurasi default memungkinkan untuk menggunakan semua fitur ke tempat minimum.

Di sini beberapa ukuran untuk lengan setelah stripping:

• Semua fitur terkait secara statis: 154ko + (mbedtls, libconfig, sqlite3, crypt dan c perpustakaan)
• Konfigurasi Kecil (Dokumen): 73ko + (Perpustakaan C)
• dengan fitur sebagai modul: 24ko + 158ko modul + 60ko dari libhttpserver dan perpustakaan lainnya

Penggunaan memori

Penggunaan memori tergantung pada konfigurasi build dan jumlah koneksi simultan.

Dengan konfigurasi default untuk arsitektur lengan, penggunaannya sekitar 4,5 juta untuk proses utama dan sekitar 13,5 juta untuk koneksi setiap klien. Tetapi konfigurasi kecil hanya membutuhkan 5,5 bulan .

Dengan hanya satu proses di Ouistiti , VMSZE adalah sekitar 26mo .

Halaman Kinerja memberikan lebih banyak informasi tentang penggunaan memori.

Waktu

Ouistiti bukan server web untuk jaringan besar, tetapi mendapatkan hasil yang baik untuk pengiriman dokumen. Kinerja tergantung pada konfigurasi build dan Anda perlu.

• Untuk mendapatkan hasil terbaik, Ouistiti perlu dibangun tanpa manajemen utas (vThread = n).
• Untuk mendapatkan keamanan maksimum, Ouistiti perlu dibangun dengan satu proses per klien (vhtread = y dan vthread_type = fork).

Ouistiti mungkin lebih cepat dari Lighttpd 1.4, tetapi tanpa semua fitur. Anda dapat menemukan beberapa hasil tes ke halaman Kinerja.