Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zeusssz/sputnik-c
Sputnik, a simple server written in C
https://github.com/zeusssz/sputnik-c
c http-server server simple
Last synced: 5 days ago
JSON representation
Sputnik, a simple server written in C
- Host: GitHub
- URL: https://github.com/zeusssz/sputnik-c
- Owner: zeusssz
- License: mit
- Created: 2024-09-04T15:36:46.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-01T17:16:28.000Z (13 days ago)
- Last Synced: 2024-11-01T18:21:09.681Z (13 days ago)
- Topics: c, http-server, server, simple
- Language: C
- Homepage:
- Size: 41 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
#  Sputnik
A simple multithreaded HTTP server implemented in C. This server is capable of serving static files from a designated directory and handling multiple client connections concurrently.
I certainly plan on improving this project, as I plan on using it for one of my other projects.
## Features
- Serve static files (HTML, CSS, JS from the `www/` directory).
- Multithreaded to handle multiple clients simultaneously.
- Simple logging to track server activity.
## Project Structure
```
root/
├── src/
│ ├── main.c
│ ├── server.c
│ └── client.c
├── include/
│ ├── server.h
│ └── client.h
├── www/
├── logs/
└──Makefile
```
## Prerequisites
- GCC or any compatible C compiler.
- `make` utility for building the project.
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/zeusssz/sputnik-c.git
cd my_http_server
```
2. **Build the server**:
```bash
make
```
## Usage
1. **Run the server**:
```bash
make run
```
The server will start on port `8080`. You can change the port by editing the `run` rule in the `Makefile`.
2. **Access the server**:
Open a web browser and navigate to `http://localhost:8080` to see the served static files.
## Configuration
- **Static Files**: Place your static files (HTML, CSS, JavaScript, etc.) in the `www/` directory.
- **Logs**: Server logs are stored in the `logs/` directory.
## Cleaning Up
- **Remove binaries and object files**:
```bash
make clean
```
- **Remove log files**:
```bash
make clean-logs
```
## Contributing
Feel free to fork this repository, open issues, and submit pull requests. Contributions are greatly appreciated.