From d26f015a1dd89eed06a93a8a9635f6868c055a8e Mon Sep 17 00:00:00 2001
From: TiynGER <kantemarten@googlemail.com>
Date: Thu, 6 May 2021 15:40:52 +0200
Subject: [PATCH] searx: added traffic route through tor

tor can be used with searx to route
all search traffic through it.
Added a paragraph in the searx site and
added the docker-image used.
---
 wiki/docker-images/dperson_-_torproxy.md | 37 ++++++++++++++++++++++++
 wiki/searx.md                            | 12 ++++++++
 wiki/tor.md                              |  9 ++++++
 3 files changed, 58 insertions(+)
 create mode 100644 wiki/docker-images/dperson_-_torproxy.md
 create mode 100644 wiki/tor.md

diff --git a/wiki/docker-images/dperson_-_torproxy.md b/wiki/docker-images/dperson_-_torproxy.md
new file mode 100644
index 0000000..eff85f8
--- /dev/null
+++ b/wiki/docker-images/dperson_-_torproxy.md
@@ -0,0 +1,37 @@
+# dperson - torproxy
+
+The container and documentation was made by [dperson](https://hub.docker.com/r/dperson/torproxy).
+
+## Volumes
+
+Set the following volumes with the -v tag.
+
+| Volume-Name | Container mount | Description                |
+| ----------- | --------------- | -------------------------- |
+| `tor_var`   | `/var/lib/tor`  | Location for various files |
+| `tor_etc`   | `/etc/tor`      | Various other config       |
+
+## Ports
+
+Set the following ports with the -p tag.
+
+| Container Port | Recommended outside port | Protocol | Description         |
+| -------------- | ------------------------ | -------- | ------------------- |
+| `8118`         | `8118`                   | TCP      | privoxy web proxy   |
+| `9050`         | `9050`                   | TCP      | socks protocol port |
+
+## Rebuild
+
+```shell
+#!/bin/sh
+docker stop tor-proxy
+docker rm tor-proxy
+docker pull dperson/torproxy:latest
+docker run --name tor-proxy \
+        --restart unless-stopped \
+        -p 8118:8118 \
+        -p 9050:9050 \
+        -v tor_var:/var/lib/tor \
+        -v tor_etc:/etc/tor \
+        -d dperson/torproxy
+```
diff --git a/wiki/searx.md b/wiki/searx.md
index ad916c8..da7f41e 100644
--- a/wiki/searx.md
+++ b/wiki/searx.md
@@ -12,3 +12,15 @@ Add Searx as a new search engine for firefox and set it as main search for the
 address bar as described in [the Firefox article](./firefox.md).
 Follow the addon part of the guide and put searx with
 `<url to searx instance>/search?q=%s` as search string.
+
+## Route search traffic through tor
+
+You can setup a torproxy with [the dperson image](./docker-images/dperson_-_torproxy.md).
+In the `settings.yml` file locate the section for `proxies :` and
+change it to the following:
+
+```txt
+proxies :
+    http : socks5://<path to torproxy server>:9050
+    https: socks5://<path to torproxy server>:9050
+```
diff --git a/wiki/tor.md b/wiki/tor.md
new file mode 100644
index 0000000..5f6519a
--- /dev/null
+++ b/wiki/tor.md
@@ -0,0 +1,9 @@
+# Tor
+
+[Tor](https://www.torproject.org/) is a free and open source software for anonymous
+communication via internet traffic.
+
+## Tor proxy
+
+A tor proxy can be used to access `.onion` sites or to anonymize traffic.
+It can be set up using [docker](./docker-images/dperson_-_torproxy.md).