mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-30 12:11:57 +00:00
SDK, dev docs images, SSH-over-Tor, Misc edits
This commit is contained in:
@@ -4,3 +4,68 @@
|
||||
SSH Over Tor
|
||||
============
|
||||
|
||||
.. note:: The following guide requires that you have already added an `SSH key to your Embassy<ssh-setup>`.
|
||||
|
||||
This is currently only supported on Linux, but may work on Windows with `Torifier <https://torifier.com/>`_.
|
||||
|
||||
Setup
|
||||
-----
|
||||
|
||||
#. First, you'll need one dependency, ``torsocks``, which will allow you to use SSH over Tor on the machine that you want access with. Select your Linux flavor to install:
|
||||
|
||||
.. tabs::
|
||||
|
||||
.. group-tab:: Debian / Ubuntu
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
apt install torsocks
|
||||
|
||||
.. group-tab:: Arch / Manjaro / Garuda
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
pacman -S torsocks
|
||||
|
||||
#. SSH in:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ssh root@embassy-xxxxxxx.local
|
||||
|
||||
#. Add the following 2 lines to ``/etc/tor/torrc`` **EITHER** by using your preferred text editor:
|
||||
|
||||
``HiddenServiceDir /var/lib/tor/ssh``
|
||||
``HiddenServicePort 22 127.0.0.1:22``
|
||||
|
||||
**OR** by entering the following 2 commands:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
echo "HiddenServiceDir /var/lib/tor/ssh" >> /etc/tor/torrc
|
||||
echo "HiddenServicePort 22 127.0.0.1:22" >> /etc/tor/torrc
|
||||
|
||||
#. Then reload the Tor configuration with your edits:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
systemctl reload tor
|
||||
|
||||
#. Next, gather the ``.onion`` address you just created:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
cat /var/lib/tor/ssh/hostname
|
||||
|
||||
.. note:: All these changes are on the overlay and won't persist after a restart of your Embassy
|
||||
|
||||
#. Add an additional SSH key in your EmbassyUI if you want to access from a machine other than the one you did this setup with.
|
||||
|
||||
Access
|
||||
------
|
||||
|
||||
Now to log in, simply use the following command, using the ``.onion`` hostname you printed above:
|
||||
|
||||
.. code-block::
|
||||
|
||||
torsocks ssh root@xxxxxxxxxxxxxxxxx.onion
|
||||
|
||||
Reference in New Issue
Block a user