Davfs2のソースを表示

{{Lowercase title}}
[[Category:ファイルシステム]]
[[Category:WebDAV]]
[[en:Davfs2]]
{{Related articles start}}
{{Related|WebDAV}}
{{Related articles end}}
[http://savannah.nongnu.org/projects/davfs2 davfs2] は [[WebDAV]] サーバーをディスクドライブとしてマウントできるようにする Linux ファイルシステムドライバーです。WebDAV は HTTP/1.1 を拡張してウェブリソースをリモートで共同で作成するプロトコルで、RFC 4918 で定義されています。

== インストール ==

{{Pkg|davfs2}} パッケージを[[インストール]]してください。

== WebDAV のマウント ==

=== 設定とマウントオプション ===

システム全体の設定ファイルは {{ic|/etc/davfs2/davfs2.conf}} に、ユーザー個別の設定ファイルは {{ic|~/.davfs2/davfs2.conf}} になります。後者は通常のユーザーで実行されたときにシステム全体の設定よりも優先して読み込まれます。WebDAV やキャッシュ、デバッグ関連のオプションが存在します。利用可能なオプションと構文は {{man|5|davfs2.conf}} を参照してください。

必要であればマウントオプションを使って設定ファイルのパスを定義したりファイルアクセスに関するオプションを設定できます。以下のコマンドでオプションのリストを確認できます:
 $ mount.davfs -h

{{man|8|mount.davfs}} にも説明とオプションが載っています。

=== コマンドラインを使う ===
WebDAV をマウントするときは直接 {{ic|mount.davfs}} を使わずに {{ic|mount}} を使用します:

 # mount -t davfs http(s)://addres:<port>/path /mount/point

=== systemd を使う ===
[[systemd#マウント|systemd]] でマウントするには:

{{hc|/etc/systemd/system/mnt-webdav-service.mount|<nowiki>
[Unit]
Description=Mount WebDAV Service
After=network-online.target
Wants=network-online.target

[Mount]
What=http(s)://address:<port>/path
Where=/mnt/webdav/service
Options=uid=1000,file_mode=0664,dir_mode=2775,grpid
Type=davfs
TimeoutSec=15

[Install]
WantedBy=multi-user.target
</nowiki>}}

systemd の automount ユニットを作成することでタイムアウトを設定できます:
{{hc|/etc/systemd/system/mnt-webdav-service.automount|<nowiki>
[Unit]
Description=Mount WebDAV Service
After=network-online.target
Wants=network-online.target

[Automount]
Where=/mnt/dav
TimeoutIdleSec=300

[Install]
WantedBy=remote-fs.target
</nowiki>}}

systemd のマウントユニットを使用する方法について詳しくは [[Fstab#systemd による自動マウント]]を参照してください。

=== fstab を使う ===

webdav をファイルシステムにマウントする方法を定義するには、以下の形式で [[fstab]] のエントリを追加します:

{{hc|/etc/fstab|2=<nowiki>https:</nowiki>//''webdav.example/path'' /mnt/''webdav'' davfs rw,user,uid=''username'',noauto 0 0}}

''username'' はマウントするファイルシステムの所有者に置き換えてください。数字の ID かユーザー ID で指定できますが、マウントユーザーと別の uid をマウントできるのは ''root'' だけです。

== ヒントとテクニック ==

=== 接続情報の保存 ===

''secrets'' ファイルを作成することで WebDAV サービスの接続情報を保存できます (通常ユーザーの場合は {{ic|~/.davfs2/secrets}}、''root'' の場合は {{ic|/etc/davfs2/secrets}} を使用):

{{hc|/etc/davfs2/secrets|
2=<nowiki>https:</nowiki>//''webdav.example/path'' ''davusername'' ''davpassword''}}

''secrets'' ファイルの[[パーミッション]]は適切に設定してください。例えば ''root'' でマウントする場合:
 # chmod 600 /etc/davfs2/secrets
 # chown root:root /etc/davfs2/secrets

通常ユーザーでマウントする場合:
 $ chmod 600 ~/.davfs2/secrets

== トラブルシューティング ==

=== ファイルの作成やコピーができない ===

ファイルを作成したりコピーできない場合やフリーズが発生するようなときは、[[davfs2#WebDAV のマウント|設定ファイル]] を編集して {{ic|use_locks 0}} オプションを使ってください。パラメータのデフォルトは {{ic|1}} で、書き込みを行うときにサーバー上のファイルをロックします。

=== シークレットファイルのパスワード ===

{{ic|\}} や {{ic|"}} などのパスワード内の特殊文字に注意してください。{{ic|\}} でエスケープしてください。

=== ネットワークはオンラインですが、ドメインの検索に失敗する ===

{{ic|network-online.target}} に到達しても WebDAV サーバーのドメインが見つからない場合があります。名前の検索が手動で成功するまで待つことができます。

まず、[[davfs2# fstab を使う|fstab]] を設定する必要があります。次に、15秒間 ping でサーバーに到達できるかどうかをテストし、成功した場合のみマウントを試行します。

{{hc|/etc/systemd/system/mnt-webdav-service.service|2=
[Unit]
Description=Mount WebDAV Service
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
ExecStart=bash -c 'for i in {1..15}; do if ping -c 1 ''mywebdav.server.url''; then mount ''/path/to/mountpoint''; break; else sleep 1; fi; done'
ExecStop=umount ''/path/to/mountpoint''
RemainAfterExit=true

[Install]
WantedBy=default.target
}}

これは、[[ユーザーユニット]] として使用することをお勧めします。

=== WebDAV リソースのマウント時のエラー '/etc/fstab のマウントオプションが異なる' ===

これは次の場合に発生します。:<br>
1) webdav リソースとそのマウントポイントが /etc/fstab に設定されている<br>
2) マウントポイントが ''mount'' コマンドに引数として渡されています (マウントポイントが /etc/fstab のものと同じであっても)<br>
修正: /etc/fstab で指定された値が使用されるように、マウント時にマウントポイントを渡さないようにします。
例えば:
 $ mount -t davfs https://mywebdav mymountpoint # incorrect
 different mount options in /etc/fstab
 $ mount -t davfs https://mywebdav # correct
 $

== 参照 ==

*http://ajclarkson.co.uk/blog/auto-mount-webdav-raspberry-pi/