Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/volkansah/android-darknetserver

The Android DarkNet Server project is an Android application designed to integrate Tor and a simple web server, enabling the device to host a hidden service accessible through the Tor network. This project serves as a boilerplate intended for developers who need a basic framework to quickly set up a hidden service on Android.
https://github.com/volkansah/android-darknetserver

android-application darknet darknet-server hacking hidden-services hidden-webservice nanohttpd pentesting-tools webserver

Last synced: 18 days ago
JSON representation

The Android DarkNet Server project is an Android application designed to integrate Tor and a simple web server, enabling the device to host a hidden service accessible through the Tor network. This project serves as a boilerplate intended for developers who need a basic framework to quickly set up a hidden service on Android.

Awesome Lists containing this project

README

        

# Android DarkNet Server (Light Boilerplate)

## Overview
The Android DarkNet Server project is an Android application designed to integrate Tor and a simple web server, enabling the device to host a hidden service accessible through the Tor network. This project serves as a boilerplate intended for developers who need a basic framework to quickly set up a hidden service on Android. It is not intended for production use and is solely for developers looking to build upon this foundation for their own projects.

Before you can actually use it, you'll need to compile the latest Tor packages yourselfβ€”just to keep things interesting! πŸ˜‰ After all, we want to make sure you're using the most up-to-date .so files. So, roll up your sleeves and get compiling. Remember, we don’t make it too easy for youβ€”after all, this is for developers only, and not for criminals and script kiddies!

### Project Structure
```
DarkWeb/
β”œβ”€β”€ src/
β”‚ β”œβ”€β”€ com/darkwebapp/darkweb/
β”‚ β”‚ β”œβ”€β”€ MainActivity.java
β”‚ β”‚ β”œβ”€β”€ TorService.java
β”‚ β”‚ └── WebServer.java
β”œβ”€β”€ assets/
β”‚ └── tor/
└── res/
└── layout/
└── activity_main.xml
```

### Features of the Android APK

- **Tor Integration**
- Start the Tor service.
- Configure Tor for the hidden service.
- Monitor the Tor status.

- **Web Server Integration**
- Start a simple web server using NanoHTTPD.
- Serve content via the web server.

- **User Interface**
- Start and stop Tor and the web server via the UI.
- Display the status of Tor and the web server.
- Show the .onion address of the hidden service.

### Installation

#### Prerequisites
Before you begin, ensure you have met the following requirements:
- Android Studio installed.
- Android NDK (Native Development Kit) installed.

#### Steps
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/Android-DarkNetServer.git
```
2. **Import the project into Android Studio:**
Open Android Studio and select "Open an existing Android Studio project". Navigate to the directory where you cloned the repository and open it.

3. **Set up the environment:**
- Install the Android NDK:
```bash
sudo apt-get install android-ndk
```
- Install other necessary packages:
```bash
sudo apt-get install build-essential automake libtool
```
- Configure the Android NDK environment variables as per the instructions in [`todo.md`](assets/tor/todo.md).

4. **Compile the Tor source code for Android:**
- Follow the instructions in [`todo.md`](assets/tor/todo.md) to compile the Tor binaries for Android.

5. **Build and run the app:**
Compile your Android project in Android Studio and test the APK on your Android device.

### For What is This Boilerplate?
This boilerplate is designed to help developers quickly create hidden servers for pentesting tools or other hidden services. With this boilerplate, you can host advanced hidden services using servers like NanoHTTPD or other alternatives.

**Important:** This boilerplate is intended for educational and development purposes only. Misuse of this tool for illegal activities is strictly prohibited. Developers should ensure they comply with all local laws and regulations when using this tool.

### Contributions

Feel free to fork this repository and contribute to its development! If you have suggestions for new features or improvements, please submit a pull request.

### License
This project is licensed under the CC4 License.
### Credits
S.Volkan KΓΌcΓΌkbudak

---

This project was initiated to explore the possibilities of hosting hidden services on Android devices. It's an ongoing effort with more features and improvements planned for the future.