Ahmia - Tor Hidden Service Search
New repository!
https://github.com/ahmia/search
Compatibility
Ahmia requires Python 2.7+ and Django 1.6+
The crawler is called Onionbot and it requires Apache Solr for the data.
Installation
- Currently, ahmia is listening Solr from http://127.0.0.1:33433/
- HTTP server is required
- Please see /apache2/ to setup to run with Apache HTTP server
- Note the crontabs. The order of the task is important
- See crontabs file. It is strongly recommended to put crontask to another server than the web-server itself
Install depencies:
$ apt-get install libxml2-dev libxslt-dev python-dev
$ apt-get install libpq-dev
$ apt-get install python-socksipy python-psycopg2 libapache2-mod-wsgi
$ apt-get install libffi-dev
$ pip install -r requirements.txt
Furthermore, you will need to set the rights to the tools:
$ chmod -R ugo+rx /usr/local/lib/ahmia/tools/
And to Apache:
$ chown -R www-data:www-data /usr/local/lib/ahmia/
$Â chmod -R u=rwX,g=rX,o=rX /usr/local/lib/ahmia/
Move the Apache settings and adjust WSGI processes=X threads=Y
Upper limit to memory that Apache needs is XY8MB. For instance, 4168MB = 513MB.
cp apache2/sites-available/django-ahmia /etc/apache2/sites-available/django-ahmia
/etc/init.d/apache2 restart
And after creating the SQLite database:
$ chown www-data:www-data /usr/local/lib/ahmia
$ chown www-data:www-data /usr/local/lib/ahmia/ahmia_db
Not required, but recommended for better system performance:
- Install haveged - A simple entropy daemon
- Edit the process and threads parameters of the WSGIDaemonProcess in apache2/sites-available/django-ahmia
- Use PostgreSQL
- Install PgBouncer: a lightweight connection pooler for PostgreSQL
Features
- Search engine for Tor hidden services.
- Privacy: ahmia saves no IP logs.
- Filtering child abuse.
- Popularity tracking from Tor2web nodes, public WWW backlinks and the number of clicks in the search results.
- Hidden service online tracker.
Demo
You can try the demo by cloning this repository and running the test server with provided data:
$ python manage.py syncdb
$ python manage.py loaddata ahmia/fixtures/initial_data.json
$ python manage.py runserver
Then open your browser to http://localhost:8000
Tests
Unittests:
$ python manage.py test ahmia/tests/
For developers
Please, at least, validate your Python code with:
$ pylint --rcfile=pylint.rc ./ahmia/python_code_file.py
and fix the major problems.