https://github.com/link-wolf/ft_onion

42 project - Web server that shows a webpage on the Tor network
https://github.com/link-wolf/ft_onion

42 42born2code 42school cybersecurity docker macos tor

Last synced: about 2 months ago
JSON representation

42 project - Web server that shows a webpage on the Tor network

• Host: GitHub
• URL: https://github.com/link-wolf/ft_onion
• Owner: Link-Wolf
• Created: 2023-09-14T14:45:53.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-09-19T14:40:11.000Z (almost 2 years ago)
• Last Synced: 2025-01-27T12:49:41.528Z (over 1 year ago)
• Topics: 42, 42born2code, 42school, cybersecurity, docker, macos, tor
• Language: HTML
• Homepage:
• Size: 929 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          




 

 

 

 

 

 









  
ft_onion


  


   Unleash the power of anonymity on the Internet!


    A web server that shows a webpage on the Tor network 

    


    


    Report Bug

    ·

    Request Feature

  



  Table of Contents

  


    


      Goal

    

    


      Getting Started

      


        
Prerequisites

        
Installation

      

    

    
Usage

    
Contributing

    
Contact

  


## Goal



  

	

  



This cybersecurity project aims to create a basic web application accessible from the Tor network by creating a `hidden service`.

It has to run on a Docker container and be accessible through a url of the type xxxxxxxxxxxxx.onion.

Nginx is used to configure the web server.

The port 80 must be enabled to access the static page via HTTP and the port 4242 must be enabled to access the server using SSH.

(back to top)


## Getting Started

### Prerequisites

Having [Docker](https://docker.com) installed on your system and be able to run the `docker compose` command on your system

### Installation

1. Clone the repo

    ```sh

    $> git clone https://github.com/Link-Wolf/ft_onion.git

    ```

2. Launch the docker container

    ```sh

    $> cd ft_onion

    $> make

    ```

(back to top)


## Usage examples

![](assets/terminal.png)

![](assets/web_page.jpg)

(back to top)


## Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

1. Fork the Project

2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)

3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)

4. Push to the Branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request

(back to top)


## Contact

Mail : xxxxxxx@student.42mulhouse.fr

Project Link: [https://github.com/Link-Wolf/ft_onion](https://github.com/Link-Wolf/ft_onion)

(back to top)