SSHFS: Difference between revisions
no edit summary
No edit summary |
PauliusRug (talk | contribs) No edit summary |
||
| (20 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
== Introduction == | == Introduction == | ||
In computing, | In computing, '''[https://wiki.teltonika-networks.com/view/RUT950_SSHFS 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 → [[RUT950 Package Manager|Package Manager]]''' as an additional package. | '''Note:''' For Teltonika devices, SSHFS can be installed from the '''Services → [[RUT950 Package Manager|Package Manager]]''' as an additional package. | ||
== Configuration overview and prerequisites == | == 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 == | |||
[[File:Networking rutx configuration example sshfs configuration Scheme v1.png|border|class=tlt-border|530x530px]] | |||
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 [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.[[File:Networking rutx configuration example sshfs ubuntu machine bridged adapter v1.png|border|class=tlt-border|595x595px]] | |||
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. | |||
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: | |||
[[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. | |||
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: | |||
[[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. | |||
== 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:[[File:Networking rutx configuration example sshfs Rut configuration v1.png|border|class=tlt-border|777x777px]] | |||
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. <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 == | |||
[https://wiki.teltonika-networks.com/view/RUT950_SSHFS SSHFS] | |||
[[Category:Router control and monitoring]] | |||