mirror of
https://github.com/trailofbits/algo.git
synced 2025-04-16 22:27:20 +02:00
Few cosmetic change to readme (#1813)
Several small improvements around markup for code blocks
This commit is contained in:
parent
9ac64cbf21
commit
3f86ae0713
1 changed files with 21 additions and 15 deletions
36
README.md
36
README.md
|
@ -55,18 +55,18 @@ The easiest way to get an Algo server running is to run it on your local system
|
|||
|
||||
- **Linux:** Recent releases of Ubuntu, Debian, and Fedora come with Python 3 already installed. Make sure your system is up-to-date and install the supporting package(s):
|
||||
* Ubuntu and Debian:
|
||||
```bash
|
||||
sudo apt install -y python3-virtualenv
|
||||
```
|
||||
```bash
|
||||
sudo apt install -y python3-virtualenv
|
||||
```
|
||||
* Fedora:
|
||||
```bash
|
||||
sudo dnf install -y python3-virtualenv
|
||||
```
|
||||
```bash
|
||||
sudo dnf install -y python3-virtualenv
|
||||
```
|
||||
* Red Hat and CentOS 7 and later (for earlier versions see this [documentation](docs/deploy-from-redhat-centos6.md)):
|
||||
```bash
|
||||
sudo yum -y install epel-release
|
||||
sudo yum install -y python36-virtualenv
|
||||
```
|
||||
```bash
|
||||
sudo yum -y install epel-release
|
||||
sudo yum -y install python36-virtualenv
|
||||
```
|
||||
|
||||
- **Windows:** Use the Windows Subsystem for Linux (WSL) to create your own copy of Ubuntu running under Windows from which to install and run Algo. See the [Windows documentation](docs/deploy-from-windows.md).
|
||||
|
||||
|
@ -151,19 +151,25 @@ Depending on the platform, you may need one or multiple of the following files.
|
|||
|
||||
If you turned on the optional SSH tunneling role, then local user accounts will be created for each user in `config.cfg` and SSH authorized_key files for them will be in the `configs` directory (user.ssh.pem). SSH user accounts do not have shell access, cannot authenticate with a password, and only have limited tunneling options (e.g., `ssh -N` is required). This ensures that SSH users have the least access required to setup a tunnel and can perform no other actions on the Algo server.
|
||||
|
||||
Use the example command below to start an SSH tunnel by replacing `<user>` and `<ip>` with your own. Once the tunnel is setup, you can configure a browser or other application to use 127.0.0.1:1080 as a SOCKS proxy to route traffic through the Algo server.
|
||||
Use the example command below to start an SSH tunnel by replacing `<user>` and `<ip>` with your own. Once the tunnel is setup, you can configure a browser or other application to use 127.0.0.1:1080 as a SOCKS proxy to route traffic through the Algo server:
|
||||
|
||||
`ssh -D 127.0.0.1:1080 -f -q -C -N <user>@algo -i configs/<ip>/ssh-tunnel/<user>.pem -F configs/<ip>/ssh_config`
|
||||
```bash
|
||||
ssh -D 127.0.0.1:1080 -f -q -C -N <user>@algo -i configs/<ip>/ssh-tunnel/<user>.pem -F configs/<ip>/ssh_config
|
||||
```
|
||||
|
||||
## SSH into Algo Server
|
||||
|
||||
Your Algo server is configured for key-only SSH access for administrative purposes. Open the Terminal app, `cd` into the `algo-master` directory where you originally downloaded Algo, and then use the command listed on the success message:
|
||||
|
||||
`ssh -F configs/<ip>/ssh_config <hostname>`
|
||||
```
|
||||
ssh -F configs/<ip>/ssh_config <hostname>
|
||||
```
|
||||
|
||||
where `<ip>` is the IP address of your Algo server. If you find yourself regularly logging into the server then it will be useful to load your Algo ssh key automatically. Add the following snippet to the bottom of `~/.bash_profile` to add it to your shell environment permanently.
|
||||
where `<ip>` is the IP address of your Algo server. If you find yourself regularly logging into the server then it will be useful to load your Algo ssh key automatically. Add the following snippet to the bottom of `~/.bash_profile` to add it to your shell environment permanently:
|
||||
|
||||
`ssh-add ~/.ssh/algo > /dev/null 2>&1`
|
||||
```
|
||||
ssh-add ~/.ssh/algo > /dev/null 2>&1
|
||||
```
|
||||
|
||||
Alternatively, you can choose to include the generated configuration for any Algo servers created into your SSH config. Edit the file `~/.ssh/config` to include this directive at the top:
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue