webserv/htdocs/site-2/examples/README.md
2025-10-09 22:57:31 +02:00

74 lines
1.8 KiB
Markdown

Welcome to WebServ Examples Directory
This directory contains example files and configurations to demonstrate
various features of the WebServ HTTP server.
Files in this directory:
========================
webserv.conf - Complete example configuration file
README.md - This file
test.txt - Simple text file for testing
sample.html - Basic HTML page
large-file.dat - Larger file for testing file serving performance
Configuration Examples:
======================
The webserv.conf file demonstrates:
- Multiple server blocks
- Virtual host configuration
- SSL/HTTPS setup
- Static file serving
- API endpoint configuration
- Directory listing
- Custom error pages
- Security headers
- Caching strategies
Testing Examples:
================
You can test various server features using these files:
1. Static File Serving:
curl http://localhost:8080/examples/test.txt
2. HTML Content:
curl http://localhost:8080/examples/sample.html
3. Directory Listing:
curl http://localhost:8080/examples/
4. Large File Download:
curl -O http://localhost:8080/examples/large-file.dat
5. Error Handling:
curl http://localhost:8080/examples/nonexistent.html
Performance Testing:
===================
Use tools like Apache Bench (ab) or wrk to test performance:
ab -n 1000 -c 10 http://localhost:8080/examples/test.txt
wrk -t4 -c100 -d30s http://localhost:8080/examples/
Security Testing:
================
Test various security scenarios:
1. Directory traversal attempts:
curl http://localhost:8080/examples/../../../etc/passwd
2. Hidden file access:
curl http://localhost:8080/examples/.htaccess
3. Backup file access:
curl http://localhost:8080/examples/config.php~
All these should be properly blocked by WebServ's security features.
For more information, visit the WebServ documentation.