balki/nnss
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add install instructions to README

Browse Source
This commit is contained in:
Balakrishnan Balasubramanian
2025-01-31 00:27:18 -05:00
parent f2c57f7ac0
commit b1926a4640
1 changed files with 18 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -2,11 +2,17 @@
Create network namespace where all¹ network requests go via ssh connection. Create network namespace where all¹ network requests go via ssh connection.
## Installing
1. Install from [AUR][2].
2. Download and install pre-built archlinux package: [link][3].
3. For other linux, copy the files to appropriate path as done [here][4].
## Creating new namespace ## Creating new namespace
1. Create a simple ssh config at `/etc/nnss/<namespace_name>/config`. This will be 1. Create a simple ssh config at `/etc/nnss/<namespace_name>/config`. This will
included with [other settings][0]. be included with [other settings][0].
2. Create the ssh private key at `/etc/nnss/<namespace_name>/privatekey` 2. Copy your ssh private key to `/etc/nnss/<namespace_name>/privatekey`
3. [Edit][1] your service file to include below properties 3. [Edit][1] your service file to include below properties
```systemd ```systemd
@@ -34,7 +40,12 @@ Port 8822 # If the ssh server is not on default port 22
## Testing namespace ## Testing namespace
```bash ```bash
❯ sudo systemd-run --property=NetworkNamespacePath=/run/netns/vps1ns --property=User=$USER --property=Requires=nnss-tunsocks@vps1.service --property=After=nnss-tunsocks@vps1.service --shell ❯ sudo systemd-run \
--property=NetworkNamespacePath=/run/netns/vps1ns \
--property=User=$USER \
--property=Requires=nnss-tunsocks@vps1.service \
--property=After=nnss-tunsocks@vps1.service \
--shell
[sudo] password for balki: [sudo] password for balki:
Running as unit: run-p233279-i233579.service Running as unit: run-p233279-i233579.service
Press ^] three times within 1s to disconnect TTY. Press ^] three times within 1s to disconnect TTY.
@@ -72,3 +83,6 @@ DNS by default still goes via host.
[0]: ./ssh_config [0]: ./ssh_config
[1]: https://wiki.archlinux.org/title/Systemd#Editing_provided_units [1]: https://wiki.archlinux.org/title/Systemd#Editing_provided_units
[2]: https://aur.archlinux.org/packages/nnss
[3]: https://gitea.balki.me/balki-aur/-/packages/arch/nnss/0.1.0-1
[4]: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=nnss#n14