Skip to content

totekuh/darkshell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

Use this tool to deploy an SSH service and make it accessible through Tor.

Usage (server)

Install docker and docker-compose:

apt install docker.io docker-compose -y

Optional step - set SSH credentials (darkshell will use default ones if you omit this step):

export DARKSHELL_USER="scrubbed"
export DARKSHELL_PASS="scrubbed"

Build and run darkshell:

docker-compose -f ./devops/docker-compose.yml build
docker-compose -f ./devops/docker-compose.yml up --detach

Once the server starts, you should see the onion hostname printed in the logs.

Note: you can use the following command for reading the logs:

docker logs darkshell

You might need to wait a few minutes before darkshell becomes reachable.

Usage (client)

Install tor and ncat:

apt update
apt install tor ncat -y

Start the Tor service:

systemctl start tor

Add the following statement with the hostname to your local SSH config (~/.ssh/config):

# Media host as Tor hidden service
host hidden
  hostname <your_onion_hostname>
  Compression yes
  Protocol 2
  PreferredAuthentications password
  proxyCommand ncat --proxy 127.0.0.1:9050 --proxy-type socks5 %h %p

Access the service via Tor using the password hexenbucht:

ssh hexenbucht@hidden

Releases

No releases published

Packages

No packages published