---
categories: ['OpenBSD','Système','Utilitaire']
date: 2022-01-19T15:33:07+02:00
description: "Monter sous OpenBSD un répertoire distant sur le système de fichier local, en SSH, grâce à l'outil SSHFS."
draft: false
include_toc: true
show_comments: false
tags: ['OpenBSD','sshfs','fuse','SSH']
title: "SshFS : Monter un répertoire à distance par connexion SSH / OpenBSD"
translationKey: 'openbsd-sshfs'
---

## Description

**[SSHFS](http://fuse.sourceforge.net/sshfs.html)** permet de monter un 
répertoire à distance dans une connexion ssh normale. 

## Installation

**{{< inside2 l="sys/openbsd/pkg" t="Installez" a="installer" >}} le 
paquet `sshfs-fuse`**.

### Depuis OpenBSD 6.0

{{<note warning>}}
Avec la version 6.0, la variable système `kern.usermount` - 
*[sysctl(3)]http://man.openbsd.org/OpenBSD-5.9/man3/sysctl.3)* - n'est 
plus gérée… d'où la nécessité d'utiliser des droits d'administration, tel
que par [doas(1)](https://man.openbsd.org/doas) !
{{</note>}}

## Utilisation

**Pour monter**, un répertoire à distance, depuis une machine faisant 
fonctionner le service SSH, sur votre station : 
```sh
$ doas sshfs -o compression=yes -o port=numero_de_port -o allow_other -o uid=$(id -u $USER) -o gid=$(id -g $USER) identifiant@hote_distant:/repertoire_cible /point_de_montage
```

Explications sur les options possibles : 

* `-o compression=yes` peut être remplacée par l'option `-C` - *option 
    peu nécessaire*
* `-o port=numero_de_port` : le numéro du port SSH à contacter sur la 
    machine distante ; si c'est le port par défaut, à savoir 22, il n'y 
    a pas besoin de spécifier l'option 'port'… cette option peut tout 
    simplement être remplacée par l'option `-p numero_de_port`
* les options `-o allow_other -o uid=$(id -u $USER) -o gid=$(id -g $USER)` 
    vous permettront d'avoir accès localement aux données montées.
* l'option `allow_other` nécessite l'ajout de l'option `user_allow_other` 
    dans le fichier `/etc/fuse.conf` 
    - *si ce dernier n'est pas créé, faites-le*…
* `identifiant` : votre identifiant sur la machine distante
* `hote_distant` : le nom FQDN ou l'adresse IP de la machine distante.
* `repertoire_cible` : le répertoire, sur la machine distante, que vous 
    souhaitez pouvoir atteindre. Selon les paramètres de configuration 
    du serveur SSH, vous ne pourrez très certainement pas monter plus 
    haut que votre partition `/home`. Si vous ne spécifiez rien, tel que 
    `id@hote:`, alors sshfs se connectera à votre répertoire `/home`.
* `point_de_montage` : l'endroit où vous désirez que le répertoire 
    distant se connecte sur votre station de travail. 

----

**Pour démonter** le point de montage : 

```sh
$ doas umount /point_de_montage
```

---

## Astuce

{{<note tip>}}
Si vous utilisez un environnement graphique, tel que Xfce, préférez 
l'usage de {{< inside2 l="sys/openbsd/gigolo" t="Gigolo" >}}, en créant 
un signet SSH… car il ne nécessite pas l'usage de doas !
{{</note>}}

---

## Documentation

Il peut vous être utile de lire localement sur votre station de travail OpenBSD, la page de manuel correspondante `man sshfs`. 

---

## Historique

J'ai écrit historiquement cette documentation sur le wiki de la communauté 
"OpenBSD Pour Tous".

---