https://github.com/satwikkansal/tor-hidden-service-python
A very basic project creating a `.onion` website for Tor using Flask framework and python.
https://github.com/satwikkansal/tor-hidden-service-python
flask hidden-service onion python tor tor-browser
Last synced: 18 days ago
JSON representation
A very basic project creating a `.onion` website for Tor using Flask framework and python.
- Host: GitHub
- URL: https://github.com/satwikkansal/tor-hidden-service-python
- Owner: satwikkansal
- License: mit
- Created: 2017-08-20T10:31:01.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-08-15T23:40:19.000Z (over 5 years ago)
- Last Synced: 2025-04-10T17:02:31.791Z (18 days ago)
- Topics: flask, hidden-service, onion, python, tor, tor-browser
- Language: HTML
- Homepage:
- Size: 45.9 KB
- Stars: 33
- Watchers: 2
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tor-hidden-service-python
> A simple boilerplate of creating a `.onion` website for Tor using Flask and Python.
## Table of Contents
- [Instructions](#instructions)
- [Screenshots](#screenshots)
- [Contributing](#contributing)
- [License](#license)
## Instructions
- Download Tor browser from the official site ([link](https://www.torproject.org/download/download))
- Configure your hidden service.
+ Go to the Tor browser directory.
+ Open the "torrc" file in an editor. (Probably located in `Browser/TorBrowser/Data/Tor` directory)
+ Add the following lines to the file
```
HiddenServiceDir /any/path/where/you/want/config/to/be/stored
HiddenServicePort 80 127.0.0.1:5000
```
+ Save and close the file.
- Clone this repository in your local system
```sh
$ git clone https://github.com/satwikkansal/tor-hidden-service-python.git
$ cd tor-hidden-service
```
- Install the pypi requirements
```sh
$ pip -r requirements.txt
```
- Run the server
```sh
$ python run.py
```
- Launch the Tor Browser
- Copy the url generated in the `hostname` file
```sh
$ cat /path/to/config/directory/hostname
>>> some-obfuscated-url.onion
```
- Open this copied url in the Tor Browser and it should work :tada:
## Screenshots
## Contributing
All patches welcome!
## License
MIT License - see the [LICENSE](https://github.com/satwikkansal/tor-hidden-service-python/blob/master/LICENSE) file for details.