Difference between revisions of "SSHFS"
PauliusRug (talk | contribs) |
|||
(5 intermediate revisions by 2 users not shown) | |||
Line 10: | Line 10: | ||
* Any Rut or TRB device. | * Any Rut or TRB device. | ||
− | * Ubuntu | + | * Ubuntu VM to host OpenSSH server. |
− | * | + | * VirtualBox or VMware to install the Ubuntu VM |
We will be testing this feature over local network '''192.168.0.0/24'''. For you, if you want to test it over '''WAN''', your SSH Server machine needs to be accessible via '''Public IP or Hostname''' over the WAN network. | We will be testing this feature over local network '''192.168.0.0/24'''. For you, if you want to test it over '''WAN''', your SSH Server machine needs to be accessible via '''Public IP or Hostname''' over the WAN network. | ||
== Configuration Scheme == | == Configuration Scheme == | ||
− | [[File: | + | [[File:Networking rutx configuration example sshfs configuration Scheme v1.png|border|class=tlt-border|530x530px]] |
Line 26: | Line 26: | ||
1. Get the Ubuntu Linux OS Desktop image from [https://ubuntu.com/download here] | 1. Get the Ubuntu Linux OS Desktop image from [https://ubuntu.com/download here] | ||
− | 2. Install the image in the virtual box application. Make sure that Ubuntu machine is perfectly running and put the machine in the same network as that of the router. For this, go to network settings option of the virtual machine and select Bridged Adapter and select the same adapter to which your Teltonika router is connected. | + | 2. Install the image in the virtual box application. Make sure that Ubuntu machine is perfectly running and put the machine in the same network as that of the router. For this, go to network settings option of the virtual machine and select Bridged Adapter and select the same adapter to which your Teltonika router is connected.[[File:Networking rutx configuration example sshfs ubuntu machine bridged adapter v1.png|border|class=tlt-border|595x595px]] |
− | [[File:Networking rutx configuration example sshfs ubuntu machine bridged adapter v1.png|border|class=tlt-border]] | + | |
− | 3. To verify your VM network, go to Settings-> Network option on the Ubuntu VM. | + | |
− | [[File:Networking rutx configuration example sshfs ubuntu machine network settings v1.png|border|class=tlt-border]] | + | |
+ | 3. To verify your VM network, go to Settings-> Network option on the Ubuntu VM.[[File:Networking rutx configuration example sshfs ubuntu machine network settings v1.png|border|class=tlt-border|683x683px]] | ||
+ | |||
+ | |||
+ | |||
Here you can see that VM machine is in network of 192.168.0.0/24, which is same as the LAN network of the router. If VM doesn’t show router network range IP, try to turn OFF the adapter on the same settings option as above picture and then turn it ON again. | Here you can see that VM machine is in network of 192.168.0.0/24, which is same as the LAN network of the router. If VM doesn’t show router network range IP, try to turn OFF the adapter on the same settings option as above picture and then turn it ON again. | ||
Line 43: | Line 47: | ||
sudo systemctl status ssh | sudo systemctl status ssh | ||
Result of the above command should be like this: | Result of the above command should be like this: | ||
− | [[File:Networking rutx configuration example sshfs ubuntu machine sshstatus v1.png|border|class=tlt-border]] | + | [[File:Networking rutx configuration example sshfs ubuntu machine sshstatus v1.png|border|class=tlt-border|868x868px]] |
+ | |||
Active (running) indicates that SSH service is fully functional and running on the machine. | Active (running) indicates that SSH service is fully functional and running on the machine. | ||
Line 53: | Line 58: | ||
sudo ufw status | sudo ufw status | ||
Result of the above command should be like this: | Result of the above command should be like this: | ||
− | [[File:Networking rutx configuration example sshfs ubuntu machine ufw status v1.png|border|class=tlt-border]] | + | |
+ | [[File:Networking rutx configuration example sshfs ubuntu machine ufw status v1.png|border|class=tlt-border|527x527px]] | ||
+ | |||
Above screenshot shows that two ufw rules for port 22 are active. | Above screenshot shows that two ufw rules for port 22 are active. | ||
Line 61: | Line 68: | ||
1. Go to '''Services-> Package manager''', install SSHFS package. | 1. Go to '''Services-> Package manager''', install SSHFS package. | ||
− | 2. Go to '''Services-> SSHFS''' page. Enable the SSHFS and configure the information as shown in the picture below: | + | 2. Go to '''Services-> SSHFS''' page. Enable the SSHFS and configure the information as shown in the picture below:[[File:Networking rutx configuration example sshfs Rut configuration v1.png|border|class=tlt-border|777x777px]] |
− | [[File:Networking rutx configuration example sshfs Rut configuration v1.png|border|class=tlt-border]] | + | |
After applying above configurations on the router, click on save & apply button. | After applying above configurations on the router, click on save & apply button. | ||
Line 68: | Line 75: | ||
After the configuration part is completed, now it’s the time to test the setup and see if it is working as intended or not. You can test it on your router to see if the filesystem has been successfully mounted or not. | After the configuration part is completed, now it’s the time to test the setup and see if it is working as intended or not. You can test it on your router to see if the filesystem has been successfully mounted or not. | ||
− | # Go to router’s CLI and change directory to '''/mnt''' and list the contents of the directory. You will see that Ubuntu machine’s directory '''/home/ramman''' contents can be found there.[[File:Networking rutx configuration example sshfs Rut Testing configuration v1.png| | + | # Go to router’s CLI and change directory to '''/mnt''' and list the contents of the directory. You will see that Ubuntu machine’s directory '''/home/ramman''' contents can be found there. <br />[[File:Networking rutx configuration example sshfs Rut Testing configuration v1.png|border|class=tlt-border|678x678px]] |
+ | Here you can read, write, and modify the files over SSH. Every time, when user makes any changes in the filesystem through router, they will automatically get reflected on the Ubuntu machine. | ||
== See also == | == See also == | ||
[https://wiki.teltonika-networks.com/view/RUT950_SSHFS SSHFS] | [https://wiki.teltonika-networks.com/view/RUT950_SSHFS SSHFS] | ||
+ | [[Category:Router control and monitoring]] |
Revision as of 17:42, 3 August 2023
Introduction
In computing, SSHFS (SSH Filesystem) is a filesystem client to mount and interact with directories and files located on a remote server or workstation over a normal SSH connection. The client interacts with the remote file system via the SSH File Transfer Protocol (SFTP), a network protocol providing file access, file transfer, and file management functionality over any reliable data stream that was designed as an extension of the Secure Shell protocol (SSH) version 2.0.
Note: For Teltonika devices, SSHFS can be installed from the Services → Package Manager as an additional package.
Configuration overview and prerequisites
Before we begin, let's overview the configuration that we are attempting to achieve and the prerequisites that make it possible.
Prerequisites:
- Any Rut or TRB device.
- Ubuntu VM to host OpenSSH server.
- VirtualBox or VMware to install the Ubuntu VM
We will be testing this feature over local network 192.168.0.0/24. For you, if you want to test it over WAN, your SSH Server machine needs to be accessible via Public IP or Hostname over the WAN network.
Configuration Scheme
In the picture, configuration scheme of this example has been displayed. RUT device is connected to the Ubuntu VM machine locally.
Ubuntu VM Installation and Configuration
As mentioned above, VM of Ubuntu Linux is required to host the OpenSSH server. OpenSSH server will allow the Teltonika router to access Ubuntu machine’s filesystem over SSH connection.
1. Get the Ubuntu Linux OS Desktop image from here
2. Install the image in the virtual box application. Make sure that Ubuntu machine is perfectly running and put the machine in the same network as that of the router. For this, go to network settings option of the virtual machine and select Bridged Adapter and select the same adapter to which your Teltonika router is connected.
3. To verify your VM network, go to Settings-> Network option on the Ubuntu VM.
Here you can see that VM machine is in network of 192.168.0.0/24, which is same as the LAN network of the router. If VM doesn’t show router network range IP, try to turn OFF the adapter on the same settings option as above picture and then turn it ON again.
4. Next, we need to install OpenSSH package in the Ubuntu machine. Open the terminal and issue the following commands:
sudo apt update
sudo apt-get install openssh-server
Now, enable the SSH service, and start it.
sudo systemctl enable ssh
sudo systemctl start ssh
Check the status of the SSH service with below command:
sudo systemctl status ssh
Result of the above command should be like this:
Active (running) indicates that SSH service is fully functional and running on the machine.
5. Further, we need to allow SSH connection on ufw. Configure firewall and open port 22 with following commands:
sudo ufw allow ssh
Enable SSH with below command
sudo ufw enable
Lastly, check the firewall status to see if rules have been configured or not:
sudo ufw status
Result of the above command should be like this:
Above screenshot shows that two ufw rules for port 22 are active.
Configure Router
Once Ubuntu machine is configured as above. Now, router will be configured to use SSHFS service. Make sure that router has internet connectivity because user need to download the SSHFS package over the internet. If the SSHFS package is already installed in the router, then there is no need for internet connectivity unless you are testing your setup over WAN network.
1. Go to Services-> Package manager, install SSHFS package.
2. Go to Services-> SSHFS page. Enable the SSHFS and configure the information as shown in the picture below:
After applying above configurations on the router, click on save & apply button.
Testing
After the configuration part is completed, now it’s the time to test the setup and see if it is working as intended or not. You can test it on your router to see if the filesystem has been successfully mounted or not.
- Go to router’s CLI and change directory to /mnt and list the contents of the directory. You will see that Ubuntu machine’s directory /home/ramman contents can be found there.
Here you can read, write, and modify the files over SSH. Every time, when user makes any changes in the filesystem through router, they will automatically get reflected on the Ubuntu machine.
See also
SSHFS