sshfsコマンドでリモートサーバーをローカルにマウントする方法｜インストールから自動マウントまで

この記事のポイント

・sshfsコマンドでリモートのディレクトリをローカルに透過マウントできる
・インストールはfuse3パッケージ1本で完了、root権限なしで使える
・/etc/fstabやsystemd.mountで起動時自動マウントも設定可能
・アンマウントはfusermount3 -u、Connection reset by peerはSSHキー再確認

# EPELリポジトリを有効化（未設定の場合）
$ sudo dnf install -y epel-release

# sshfsをインストール
$ sudo dnf install -y fuse-sshfs

# バージョン確認
$ sshfs --version
SSHFS version 3.7.3
FUSE library version 3.16.2
using FUSE kernel module interface version 7.38

# sshfsをインストール（sshfsパッケージにfuse3が含まれる）
$ sudo apt install -y sshfs

# バージョン確認
$ sshfs --version
SSHFS version 3.7.3

# 自分自身をfuseグループに追加（RHELで必要な場合）
$ sudo usermod -aG fuse $(whoami)

# グループ変更を反映（一度ログアウト・ログインするか、newgrpで即時反映）
$ newgrp fuse

# マウントポイントを作成
$ mkdir -p ~/remote-server

# ディレクトリが作成されたことを確認
$ ls -la ~/
drwxr-xr-x.  2 tomohiro tomohiro    6  5月 31 10:00 remote-server

# 書式: sshfs [ユーザー名]@[ホスト]:[リモートパス] [ローカルマウントポイント]
$ sshfs tomohiro@192.168.1.100:/var/www/html ~/remote-server

# 接続確認（実サーバーの出力例）
$ ls ~/remote-server
index.php  config.php  public  storage  vendor

# dfコマンドでマウントされていることを確認
$ df -h ~/remote-server
Filesystem                          Size  Used Avail Use% Mounted on
tomohiro@192.168.1.100:/var/www/html   50G  18G   30G  38% /home/tomohiro/remote-server

# 秘密鍵を指定してマウント
$ sshfs -o IdentityFile=~/.ssh/id_rsa tomohiro@192.168.1.100:/var/www/html ~/remote-server

# ~/.ssh/configに設定済みのHost名で指定することも可能
$ sshfs webserver01:/var/www/html ~/remote-server

# 長時間作業向けの推奨設定
$ sshfs -o reconnect,ServerAliveInterval=15,ServerAliveCountMax=3   tomohiro@192.168.1.100:/var/www/html ~/remote-server

# 非標準ポートへの接続
$ sshfs -o port=2222 tomohiro@192.168.1.100:/home/deploy ~/remote-server

# アンマウント（Linux標準のumountと異なるコマンドを使う）
$ fusermount3 -u ~/remote-server

# アンマウント確認
$ df -h ~/remote-server
df: /home/tomohiro/remote-server: mountpoint not found

# sudoが使える環境ではumountも使用可能
$ sudo umount ~/remote-server

# 強制アンマウント（Transport endpoint is not connected の場合）
$ fusermount3 -uz ~/remote-server

# /etc/fstab に追記（rootで編集）
# 書式: [ユーザー]@[ホスト]:[リモートパス] [ローカルパス] fuse.sshfs [オプション] 0 0
tomohiro@192.168.1.100:/var/www/html /mnt/remote-server fuse.sshfs IdentityFile=/home/tomohiro/.ssh/id_rsa,_netdev,allow_other,reconnect,ServerAliveInterval=15 0 0

# fstabが正しいか確認してマウント
$ sudo mount -a

# マウント確認
$ mount | grep fuse.sshfs
tomohiro@192.168.1.100:/var/www/html on /mnt/remote-server type fuse.sshfs (rw,nosuid,nodev,relatime,user_id=1000,group_id=1000,allow_other)

# リモートサーバー側の/etc/ssh/sshd_configを確認
$ grep -i sftp /etc/ssh/sshd_config
Subsystem sftp /usr/lib/openssh/sftp-server  # この行が必要

# sshd_configにSFTP設定がない場合は追記して再起動
$ sudo systemctl restart sshd

# fuseカーネルモジュールをロード
$ sudo modprobe fuse

# 永続化（起動時に自動ロード）
$ echo fuse | sudo tee /etc/modules-load.d/fuse.conf

# 自分のUID/GIDを確認
$ id
uid=1000(tomohiro) gid=1000(tomohiro) groups=1000(tomohiro),10(wheel)

# UID/GIDを指定してマウント
$ sshfs -o uid=1000,gid=1000 tomohiro@192.168.1.100:/var/www/html ~/remote-server