<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ja">
	<id>https://wiki.archlinux.jp/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Tkna</id>
	<title>ArchWiki - 利用者の投稿記録 [ja]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.archlinux.jp/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Tkna"/>
	<link rel="alternate" type="text/html" href="https://wiki.archlinux.jp/index.php/%E7%89%B9%E5%88%A5:%E6%8A%95%E7%A8%BF%E8%A8%98%E9%8C%B2/Tkna"/>
	<updated>2026-05-25T16:01:44Z</updated>
	<subtitle>利用者の投稿記録</subtitle>
	<generator>MediaWiki 1.44.3</generator>
	<entry>
		<id>https://wiki.archlinux.jp/index.php?title=SSHFS&amp;diff=28852</id>
		<title>SSHFS</title>
		<link rel="alternate" type="text/html" href="https://wiki.archlinux.jp/index.php?title=SSHFS&amp;diff=28852"/>
		<updated>2022-12-16T01:30:07Z</updated>

		<summary type="html">&lt;p&gt;Tkna: 概要を英語版に追随&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:FUSE]]&lt;br /&gt;
[[Category:Secure Shell]]&lt;br /&gt;
[[Category:ネットワーク共有]]&lt;br /&gt;
[[en:SSHFS]]&lt;br /&gt;
[[es:SSHFS]]&lt;br /&gt;
[[it:Sshfs]]&lt;br /&gt;
[[ru:SSHFS]]&lt;br /&gt;
[[zh-hans:SSHFS]]&lt;br /&gt;
{{Related articles start}}&lt;br /&gt;
{{Related|SCP と SFTP}}&lt;br /&gt;
{{Related|SFTP chroot}}&lt;br /&gt;
{{Related|Pure-FTPd}}&lt;br /&gt;
{{Related|SSH}}&lt;br /&gt;
{{Related|sftpman}}&lt;br /&gt;
{{Related articles end}}&lt;br /&gt;
[https://github.com/libfuse/sshfs SSHFS] は、[[Secure Shell]] 接続でリモートディレクトリをマウントするための [[FUSE]] ベースのファイルシステムクライアントです。&lt;br /&gt;
&lt;br /&gt;
{{Note|このプロジェクトは開発者によってアーカイブされ、もはや開発されていません。代替手段としては、{{Pkg|rclone}}のマウント機能があります。}}&lt;br /&gt;
&lt;br /&gt;
== インストール ==&lt;br /&gt;
&lt;br /&gt;
[[公式リポジトリ]]から {{Pkg|sshfs}} を[[インストール]]してください。&lt;br /&gt;
&lt;br /&gt;
=== マウント ===&lt;br /&gt;
ディレクトリをマウントする前に、対象のディレクトリのファイルパーティションが正しく設定されているか (ユーザーがアクセスできるか) 確認してください。マウントするには、{{ic|sshfs}} を実行してリモートディレクトリをマウントします:&lt;br /&gt;
 $ sshfs &#039;&#039;[user@]host:[dir] mountpoint [options]&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
例:&lt;br /&gt;
 $ sshfs sessy@mycomputer:/remote/path /local/path -C -p 9876 -o allow_other&lt;br /&gt;
{{ic|-p 9876}} はポート番号、{{ic|-C}} は圧縮の使用、{{ic|-o allow_other}} は root 以外のユーザーの読み書きの許可です。&lt;br /&gt;
&lt;br /&gt;
{{Note|&lt;br /&gt;
* {{ic|allow_other}} オプションはデフォルトで無効になっています。有効にするには {{ic|/etc/fuse.conf}} の {{ic|user_allow_other}} 行をアンコメントして root 以外のユーザーが allow_other マウントオプションを使えるようにしてください。&lt;br /&gt;
* -p スイッチを使うのが面倒な場合、{{ic|~/.ssh/config}} でホストごとに非標準ポートを定義することもできます。詳しくは [[Secure Shell#ssh の設定に接続データを保存する]] を参照。}}&lt;br /&gt;
&lt;br /&gt;
必要であれば、SSH はパスワードを尋ねます。何度もパスワードを入力したくない場合は、[[SSH 鍵]]を読んでください。&lt;br /&gt;
&lt;br /&gt;
{{Tip|[[Google Authenticator]] を使うことで sshfs のセキュリティを向上させることができます。}}&lt;br /&gt;
&lt;br /&gt;
=== アンマウント ===&lt;br /&gt;
&lt;br /&gt;
リモートシステムをアンマウントするには:&lt;br /&gt;
 $ fusermount -u &#039;&#039;local_mount_point&#039;&#039;&lt;br /&gt;
例:&lt;br /&gt;
 $ fusermount -u /mnt/sessy&lt;br /&gt;
&lt;br /&gt;
== Chroot ==&lt;br /&gt;
&lt;br /&gt;
(特定の) ユーザーをディレクトリに閉じ込めたい場合、{{ic|/etc/ssh/sshd_config}} を編集してください:&lt;br /&gt;
&lt;br /&gt;
{{hc|/etc/ssh/sshd_config|.....&lt;br /&gt;
Match User someuser &lt;br /&gt;
       ChrootDirectory /chroot/%u&lt;br /&gt;
       ForceCommand internal-sftp #to restrict the user to sftp only&lt;br /&gt;
       AllowTcpForwarding no&lt;br /&gt;
       X11Forwarding no&lt;br /&gt;
.....}}&lt;br /&gt;
&lt;br /&gt;
{{Note|chroot ディレクトリの所有者は root である必要があります。そうでない場合、接続ができません。詳しくは man ページで {{ic|Match, ChrootDirectory}} や {{ic|ForceCommand}} を確認してください。}}&lt;br /&gt;
&lt;br /&gt;
== ヘルパー ==&lt;br /&gt;
&lt;br /&gt;
sshfs ファイルシステムを頻繁にマウントする必要がある場合、[[sftpman]] などの sshfs ヘルパーを使うと良いでしょう。&lt;br /&gt;
&lt;br /&gt;
コマンドラインと GTK のフロントエンドが入っており、マウントやアンマウントをワンクリックで行うことができるようになります。&lt;br /&gt;
&lt;br /&gt;
== 自動マウント ==&lt;br /&gt;
&lt;br /&gt;
起動時や、必要に応じて (ディレクトリのアクセス時に)、自動マウントを行うことができます。どちらにしても、セットアップは {{ic|/etc/[[fstab]]}} で行います。&lt;br /&gt;
&lt;br /&gt;
{{Note|自動マウントは root ユーザーによって行われるため、通常ユーザーの {{ic|.ssh/config}} で設定した Hosts は使えなくなります。root ユーザーで通常ユーザーの SSH 鍵を使うときは、{{ic|IdentityFile}} オプションにフルパスを指定してください。そして、ホストの署名が {{ic|.ssh/known_hosts}} ファイルに追加されるように root で一度は手動で sshfs マウントを使用します。}}&lt;br /&gt;
&lt;br /&gt;
=== 必要に応じてマウント ===&lt;br /&gt;
&lt;br /&gt;
{{ic|/etc/fstab}} エントリを使うことで systemd でオンデマンドのマウントを行えます。&lt;br /&gt;
&lt;br /&gt;
例:&lt;br /&gt;
 user@host:/remote/folder /mount/point  fuse.sshfs noauto,x-systemd.automount,_netdev,users,idmap=user,IdentityFile=/home/user/.ssh/id_rsa,allow_other,reconnect 0 0&lt;br /&gt;
ここで重要なマウントオプションは &#039;&#039;noauto,x-systemd.automount,_netdev&#039;&#039; です。&lt;br /&gt;
* &#039;&#039;noauto&#039;&#039; で起動時にマウントしないように設定します。&lt;br /&gt;
* &#039;&#039;x-systemd.automount&#039;&#039; によって必要になったときにマウントします。&lt;br /&gt;
* &#039;&#039;_netdev&#039;&#039; はブロックデバイスではなくネットワークデバイスであることを指定します (&#039;&#039;_netdev&#039;&#039; がないと &amp;quot;No such device&amp;quot; エラーが発生します)。&lt;br /&gt;
&lt;br /&gt;
{{Tip|{{AUR|autosshfs-git}}{{Broken package link|パッケージが存在しません}} は新しいマウントポイントを追加するのに {{ic|/etc/fstab}} を編集する必要がなくなり、(autosshfs が有効になった) 通常ユーザーがアクセスしようとしただけで作成されます (例: {{ic|ls ~/mnt/ssh/[user@]yourremotehost[:port]}})。{{AUR|autosshfs-git}}{{Broken package link|パッケージが存在しません}} は AutoFS を使います。{{ic|autosshfs-user}} で使用するユーザーを有効にする必要があります。}}&lt;br /&gt;
&lt;br /&gt;
=== 起動時にマウント ===&lt;br /&gt;
&lt;br /&gt;
{{ic|/etc/[[fstab]]}} で sshfs を使ってリモートのファイルシステムをマウントする例:&lt;br /&gt;
 USERNAME@HOSTNAME_OR_IP:/REMOTE/DIRECTORY  /LOCAL/MOUNTPOINT  fuse.sshfs  defaults,_netdev  0  0&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;fstab&#039;&#039; の行の例:&lt;br /&gt;
 llib@192.168.1.200:/home/llib/FAH  /media/FAH2  fuse.sshfs  defaults,_netdev  0  0&lt;br /&gt;
ユーザーの SSH 鍵を使っている場合、自動的に動作するようになります。[[SSH 鍵]]を見て下さい。&lt;br /&gt;
&lt;br /&gt;
複数のユーザーで sshfs を使いたい場合:&lt;br /&gt;
 user@domain.org:/home/user  /media/user   fuse.sshfs    defaults,allow_other,_netdev    0  0&lt;br /&gt;
&lt;br /&gt;
マウントする前にネットワークが有効になっていることを確認するために &#039;&#039;_netdev&#039;&#039; マウントオプションを設定することが重要です。&lt;br /&gt;
&lt;br /&gt;
=== ユーザーアクセスのセキュア化 ===&lt;br /&gt;
&lt;br /&gt;
{{ic|/etc/[[fstab]]}} で自動マウントする場合、ファイルシステムは基本的に root によってマウントされます。デフォルトでは、通常ユーザーとしてアクセスして他のユーザーのアクセスを制限したいときに予期しない結果を招くことがあります。&lt;br /&gt;
&lt;br /&gt;
マウントポイントの設定例:&lt;br /&gt;
&lt;br /&gt;
 USERNAME@HOSTNAME_OR_IP:/REMOTE/DIRECTORY  /LOCAL/MOUNTPOINT  fuse.sshfs noauto,x-systemd.automount,_netdev,user,idmap=user,follow_symlinks,identityfile=/home/USERNAME/.ssh/id_rsa,allow_other,default_permissions,uid=USER_ID_N,gid=USER_GID_N 0 0&lt;br /&gt;
&lt;br /&gt;
オプションの説明:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;allow_other&#039;&#039; - root 以外のユーザーが共有フォルダにアクセスすることを許可します。&lt;br /&gt;
* &#039;&#039;default_permissions&#039;&#039; - カーネルからパーミッションを確認することを許可します。リモートファイルシステムの実際のパーミッションが使われます。&#039;&#039;allow_other&#039;&#039; によって許可されたユーザー以外にも制限的なアクセスを許可します。&lt;br /&gt;
* &#039;&#039;uid&#039;&#039;, &#039;&#039;gid&#039;&#039; - ファイルの所有権を特定の値に設定します。&#039;&#039;uid&#039;&#039; にはユーザーの ID、&#039;&#039;gid&#039;&#039; にはユーザーのグループ ID を指定します。&lt;br /&gt;
&lt;br /&gt;
== オプション ==&lt;br /&gt;
&lt;br /&gt;
sshfs はローカル・リモートのユーザー ID を自動的に変換することができます。&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;idmap&#039;&#039; オプションを &#039;&#039;user&#039;&#039; に設定することで接続するユーザーの UID が変換されます:&lt;br /&gt;
&lt;br /&gt;
 # sshfs -o idmap=user sessy@mycomputer:/home/sessy /mnt/sessy -C -p 9876&lt;br /&gt;
&lt;br /&gt;
上記のコマンドはリモートのユーザー &amp;quot;sessy&amp;quot; の UID をプロセスを実行しているローカルユーザーにマッピングします (上記の例では &amp;quot;root&amp;quot;)。GID は変わりません。UID と GID 変換を細かく制御する必要がある場合、&#039;&#039;idmap=file&#039;&#039; オプションと &#039;&#039;uidfile&#039;&#039; と &#039;&#039;gidfile&#039;&#039; を見てください。&lt;br /&gt;
&lt;br /&gt;
== トラブルシューティング ==&lt;br /&gt;
&lt;br /&gt;
=== チェックリスト ===&lt;br /&gt;
&lt;br /&gt;
[[Secure_Shell#チェックリスト|SSH のチェックリスト]]を最初に読んで、以下を確認してください:&lt;br /&gt;
&lt;br /&gt;
1. SSH ログインでサーバーの {{ic|/etc/issue}} ファイルから情報を送信している場合、SSHFS が混乱してしまいます。サーバーの {{ic|/etc/issue}} ファイルは無効にしてください:&lt;br /&gt;
&lt;br /&gt;
 $ mv /etc/issue /etc/issue.orig&lt;br /&gt;
&lt;br /&gt;
2. ウェブ上の SSH 関連のトラブルシューティング記事のほとんどは Systemd を考慮していません。{{ic|/etc/fstab}} の定義が {{ic|&#039;&#039;sshfs#&#039;&#039;user@host:/mnt/server/folder ... fuse ...}} から始まる間違ったものであることはしばしばで、{{ic|user@host:/mnt/server/folder ... fuse.&#039;&#039;sshfs&#039;&#039; ... &#039;&#039;x-systemd&#039;&#039;, ...}} が正しい構文になります。&lt;br /&gt;
&lt;br /&gt;
3. サーバーのソースフォルダとコンテンツがサーバーのユーザーによって所有されていることを確認してください。&lt;br /&gt;
&lt;br /&gt;
 $ chown -R USER_S: /mnt/servers/folder&lt;br /&gt;
&lt;br /&gt;
4. サーバーのユーザー ID とクライアントのユーザー ID が異なっている可能性があります。当然ユーザー名は同一である必要があります。クライアントのユーザー ID に注意してください。SSHFS は以下のマウントオプションで UID を変換します:&lt;br /&gt;
&lt;br /&gt;
 uid=&#039;&#039;USER_C_ID&#039;&#039;,gid=&#039;&#039;GROUP_C_ID&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
5. クライアントのターゲットマウントポイント (フォルダ) がクライアントのユーザーによって所有されていることを確認してください。SSHFS のマウントオプションで指定したユーザー ID と同じである必要があります。&lt;br /&gt;
&lt;br /&gt;
 $ chown -R USER_C: /mnt/client/folder&lt;br /&gt;
&lt;br /&gt;
6. クライアントのマウントポイント (フォルダ) が空であることを確認してください。デフォルトでは SSHFS のフォルダを空でないフォルダにマウントすることはできませ。&lt;br /&gt;
&lt;br /&gt;
7. {{ic|/etc/fstab}} で SSH 公開鍵認証を使って SSH 共有を自動マウントしたい場合、以下のように設定してください:&lt;br /&gt;
&lt;br /&gt;
 &#039;&#039;USER_S&#039;&#039;@&#039;&#039;SERVER&#039;&#039;:/mnt/on/server      /nmt/on/client        fuse.sshfs      x-systemd.automount,_netdev,user,idmap=user,transform_symlinks,identityfile=/home/&#039;&#039;USER_C&#039;&#039;/.ssh/id_rsa,allow_other,default_permissions,uid=&#039;&#039;USER_C_ID&#039;&#039;,gid=&#039;&#039;GROUP_C_ID&#039;&#039;,umask=0   0 0&lt;br /&gt;
&lt;br /&gt;
設定例:&lt;br /&gt;
&lt;br /&gt;
 SERVER = Server host name (serv)&lt;br /&gt;
 USER_S = Server user name (pete)&lt;br /&gt;
 USER_C = Client user name (pete)&lt;br /&gt;
 USER_S_ID = Server user ID (1004)&lt;br /&gt;
 USER_C_ID = Client user ID (1000)&lt;br /&gt;
 GROUP_C_ID = Client user&#039;s group ID (100)&lt;br /&gt;
&lt;br /&gt;
クライアントユーザーの ID とグループ ID は以下のコマンドで確認できます:&lt;br /&gt;
&lt;br /&gt;
 $ id USERNAME&lt;br /&gt;
&lt;br /&gt;
実際に {{ic|/etc/fstab}} に設定する行は以下のようになります:&lt;br /&gt;
&lt;br /&gt;
 pete@serv:/mnt/on/server      /nmt/on/client        fuse.sshfs      x-systemd.automount,_netdev,user,idmap=user,transform_symlinks,identityfile=/home/pete/.ssh/id_rsa,allow_other,default_permissions,uid=1004,gid=1000,umask=0   0 0&lt;br /&gt;
&lt;br /&gt;
8. チェックリストに追加するべきことが他にもあるのであれば追加してください。&lt;br /&gt;
&lt;br /&gt;
=== ピアによって接続がリセットされる ===&lt;br /&gt;
&lt;br /&gt;
* ホストネームを使ってリモートマシンにアクセスしようとしている場合、ドメイン名が解決できないのが原因かもしれないので、IP アドレスを使って接続してみてください。{{ic|/etc/hosts}} を編集してサーバーの設定が正しいことを確認してください。&lt;br /&gt;
* デフォルトではないキーの名前を使っている場合、{{ic|-i .ssh/my_key}} と指定しても意味がありません。{{ic|-o IdentityFile&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;/home/user/.ssh/my_key}} のようにキーのフルパスを使う必要があります。&lt;br /&gt;
* {{ic|sshfs_debug}} オプションを追加することで問題の解決に役に立つ情報が得られます ({{ic|sshfs -o sshfs_debug user@server ...}})。&lt;br /&gt;
* 何も有用な情報が得られないときは、{{ic|debug}} オプションも追加してみてください。&lt;br /&gt;
* sshfs で DD-WRT などが動作しているルーターに接続する場合、[http://www.dd-wrt.com/wiki/index.php/SFTP_with_DD-WRT こちら] に解決方法が載っています (dropbear にパッチをあてるかわりに sshfs コマンドで {{ic|1=-osftp_server=/opt/libexec/sftp-server}} オプションを使うこともできます)。&lt;br /&gt;
* 古いフォーラムスレッド: [https://bbs.archlinux.org/viewtopic.php?id=27613 sshfs: Connection reset by peer]&lt;br /&gt;
* ユーザーを使ってサーバーにログインできることを確認してください (特に AllowUsers を使用する場合)。&lt;br /&gt;
* {{ic|/etc/ssh/sshd_config}} で {{ic|Subsystem sftp /usr/lib/ssh/sftp-server}} が有効になっていることを確認してください。&lt;br /&gt;
&lt;br /&gt;
{{Note|sshfs に複数のオプションを指定する場合、カンマで区切る必要があります。例: {{ic|sshfs -o sshfs_debug,IdentityFile&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;&amp;lt;/path/to/key&amp;gt; user@server ...}}。}}&lt;br /&gt;
&lt;br /&gt;
=== Remote host has disconnected ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;sshfs&#039;&#039; を使おうとした直後にこのメッセージが表示される場合:&lt;br /&gt;
* まず&#039;&#039;&#039;リモート&#039;&#039;&#039;マシンに &#039;&#039;sftp&#039;&#039; がインストールされていることを確認してください。インストールしていないと、動作しません。&lt;br /&gt;
{{Tip|リモートサーバーで OpenWRT を動かしている場合: {{ic|opkg install openssh-sftp-server}} でインストールできます。}}&lt;br /&gt;
* それから、リモートマシンの {{ic|/etc/ssh/sshd_config}} に記載されている {{ic|Subsystem}} のパスが正しいかどうか確認してください。パスは {{ic|find / -name sftp-server}} で確認できます。&lt;br /&gt;
&lt;br /&gt;
Arch Linux では {{ic|/etc/ssh/sshd_config}} のデフォルト値は {{ic|Subsystem sftp /usr/lib/ssh/sftp-server}} です。&lt;br /&gt;
&lt;br /&gt;
=== Thunar と FAM のリモートファイルの問題 ===  &lt;br /&gt;
&lt;br /&gt;
リモートフォルダが表示されず、ホームディレクトリに戻ってしまう場合、あるいは Thunar で他のリモートファイルにアクセスできない場合、FAM を {{AUR|gamin}} で置き換えてください。Gamin は FAM の後継です。&lt;br /&gt;
&lt;br /&gt;
=== アプリがフリーズする (例: Nautilus, Gedit) ===  &lt;br /&gt;
{{Note|下記の設定をすると最近使用したファイルのリストが作られなくなります。また、書き込みエラーが発生することがあります。}}&lt;br /&gt;
&lt;br /&gt;
アプリケーションがフリーズする (反応しなくなる) 場合、{{ic|~/recently-used.xbel}} の書き込み権限を無効化する必要があるかもしれません:&lt;br /&gt;
&lt;br /&gt;
 # chattr +i /home/USERNAME/.local/share/recently-used.xbel&lt;br /&gt;
&lt;br /&gt;
詳しくは次の [https://bugs.archlinux.org/task/40260 バグレポート] を見て下さい。&lt;br /&gt;
&lt;br /&gt;
=== sshfs をマウントされているときにシャットダウンでフリーズ ===&lt;br /&gt;
&lt;br /&gt;
sshfs を手動でマウントして、シャットダウン前にアンマウントしていなかった場合、systemd がシャットダウン時にフリーズすることがあります。この問題を解決するには、以下のファイルを (root で) 作成してください:&lt;br /&gt;
{{hc|/etc/systemd/system/killsshfs.service|&amp;lt;nowiki&amp;gt;&lt;br /&gt;
[Unit]&lt;br /&gt;
After=network.target&lt;br /&gt;
&lt;br /&gt;
[Service]&lt;br /&gt;
RemainAfterExit=yes&lt;br /&gt;
ExecStart=-/bin/true&lt;br /&gt;
ExecStop=-/usr/bin/pkill -x sshfs&lt;br /&gt;
&lt;br /&gt;
[Install]&lt;br /&gt;
WantedBy=multi-user.target&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;}}&lt;br /&gt;
そしてサービスを有効化します: {{ic|systemctl enable killsshfs.service}}&lt;br /&gt;
&lt;br /&gt;
=== fstab によるマウントの問題 ===&lt;br /&gt;
&lt;br /&gt;
詳細な出力を得たい場合、マウントオプションに以下を追加してください:&lt;br /&gt;
&lt;br /&gt;
 ssh_command=ssh\040-vv,sshfs_debug,debug&lt;br /&gt;
{{Note|上記の {{ic|\040}} は fstab でフィールドを区切るのに使うスペースを意味します。}}&lt;br /&gt;
&lt;br /&gt;
{{ic|mount -av}} を実行してデバッグ出力を確認するために、以下のオプションを削除してください:&lt;br /&gt;
 noauto,x-systemd.automount&lt;br /&gt;
&lt;br /&gt;
== 参照 ==&lt;br /&gt;
&lt;br /&gt;
* [http://wiki.gilug.org/index.php/How_to_mount_SFTP_accesses How to mount chrooted SSH filesystem], with special care with owners and permissions questions.&lt;br /&gt;
* [http://www.admin-magazine.com/HPC/Articles/Sharing-Data-with-SSHFS SSHFS – Installation and Performance] — NFS との比較と最適化ヒント。&lt;/div&gt;</summary>
		<author><name>Tkna</name></author>
	</entry>
	<entry>
		<id>https://wiki.archlinux.jp/index.php?title=Fcitx5&amp;diff=27613</id>
		<title>Fcitx5</title>
		<link rel="alternate" type="text/html" href="https://wiki.archlinux.jp/index.php?title=Fcitx5&amp;diff=27613"/>
		<updated>2022-10-05T12:00:25Z</updated>

		<summary type="html">&lt;p&gt;Tkna: /* インプットメソッドモジュールの環境変数の設定 */ 環境変数は fcitx5 ではなく fcitx とする。英語版より反映 https://wiki.archlinux.org/index.php?title=Fcitx5&amp;amp;diff=737383&amp;amp;oldid=737362&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:インプットメソッド]]&lt;br /&gt;
[[en:Fcitx5]]&lt;br /&gt;
[[zh-hans:Fcitx5]]&lt;br /&gt;
{{Related articles start}}&lt;br /&gt;
{{Related|Fcitx}}&lt;br /&gt;
{{Related|IBus}}&lt;br /&gt;
{{Related articles end}}&lt;br /&gt;
[https://fcitx-im.org/wiki/Fcitx_5 Fcitx5] は、軽量コアを備えた[[インプットメソッド]]フレームワークであり、アドオンを介して追加の言語サポートを提供します。 [[Fcitx]] の後継です。&lt;br /&gt;
&lt;br /&gt;
== インストール ==&lt;br /&gt;
&lt;br /&gt;
{{Pkg|fcitx5}} パッケージを[[インストール]]してください。&lt;br /&gt;
&lt;br /&gt;
{{Grp|fcitx5-im}} パッケージグループは、{{Pkg|fcitx5}} 本体、[[#設定ツール]] および必要な[[#インプットメソッドモジュール]]を提供します。  &lt;br /&gt;
&lt;br /&gt;
{{Note|{{Pkg|fcitx5}} は基本的なフレームワークを提供するだけで英語のサポートが提供されます。中国語や日本語などの他の言語を入力する場合は、インプットメソッドエンジンが必要です。}}&lt;br /&gt;
&lt;br /&gt;
=== 中国語 ===&lt;br /&gt;
&lt;br /&gt;
* {{Pkg|fcitx5-chewing}} は {{Pkg|libchewing}} に基づく繁体字の注音入力エンジンです。&lt;br /&gt;
* {{Pkg|fcitx5-chinese-addons}} には中国語に関連するアドオンが含まれています。fcitx4 にバンドルされている IME も含まれます。&lt;br /&gt;
* {{Pkg|fcitx5-rime}} は [[Rime IME]] プロジェクトのスキーマを基にしています。&lt;br /&gt;
&lt;br /&gt;
=== 日本語 ===&lt;br /&gt;
&lt;br /&gt;
* {{Pkg|fcitx5-anthy}} は人気の日本語入力エンジンです。ただし、開発は滞っています。&lt;br /&gt;
* {{Pkg|fcitx5-kkc}} は {{Pkg|libkkc}} がベースの日本語仮名漢字入力エンジンです。&lt;br /&gt;
* {{Pkg|fcitx5-mozc}} Google 日本語入力のオープンソース版である [[Mozc]] がベース。&lt;br /&gt;
* {{Pkg|fcitx5-skk}} は {{Pkg|libskk}} がベースの日本語仮名漢字入力エンジンです。&lt;br /&gt;
&lt;br /&gt;
=== 他の言語 ===&lt;br /&gt;
&lt;br /&gt;
* {{Pkg|fcitx5-hangul}} は {{Pkg|libhangul}} ベースの韓国語ハングル入力エンジンです。&lt;br /&gt;
* {{Pkg|fcitx5-unikey}} はベトナム文字入力エンジンです。&lt;br /&gt;
* {{Pkg|fcitx5-m17n}}, その他の多言語文字入力エンジンです。&lt;br /&gt;
&lt;br /&gt;
=== インプットメソッドモジュール ===&lt;br /&gt;
&lt;br /&gt;
より良いエクスペリエンスを得るために、以下のモジュールもインストールすると良いでしょう。モジュールをインストールしなくても大抵のアプリケーションでインプットメソッドは動作しますが、インプットメソッドがフリーズしたり、プレビューウィンドウの位置がずれたり、プレビューが表示されなかったりする可能性があります。&lt;br /&gt;
&lt;br /&gt;
* Qt プログラムには {{Pkg|fcitx5-qt}} をインストールしてください。&lt;br /&gt;
* GTK プログラムには {{Pkg|fcitx5-gtk}} をインストールしてください。&lt;br /&gt;
* Qt4 プログラムには {{AUR|fcitx5-qt4-git}} をインストールしてください。&lt;br /&gt;
* Qt5 プログラムには {{AUR|fcitx5-qt5-git}} をインストールしてください。&lt;br /&gt;
* Qt6 プログラムには {{AUR|fcitx5-qt6-git}} をインストールしてください。&lt;br /&gt;
* 日付と時刻のサポートについては {{Pkg|fcitx5-lua}} をインストールしてください。&lt;br /&gt;
&lt;br /&gt;
{{Tip|通常、{{Pkg|fcitx5-qt}} と {{Pkg|fcitx5-gtk}} をインストールすると、あらゆる状況に対応できます。}}&lt;br /&gt;
&lt;br /&gt;
== 使用方法 ==&lt;br /&gt;
=== インプットメソッドモジュールの環境変数の設定 ===&lt;br /&gt;
&lt;br /&gt;
Fcitx5を常用する場合は、環境変数を変更する必要があります。&lt;br /&gt;
&lt;br /&gt;
{{ic|/etc/environment}}を編集し、以下の行を追加します。&lt;br /&gt;
&lt;br /&gt;
 GTK_IM_MODULE=fcitx&lt;br /&gt;
 QT_IM_MODULE=fcitx&lt;br /&gt;
 XMODIFIERS=@im=fcitx&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- これらの環境変数の推奨値は &amp;quot;fcitx&amp;quot; です。上流のリンク https://fcitx-im.org/wiki/Setup_Fcitx_5 を参照してください。--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Tip|1=これらの変数を設定する他の方法については、 [[環境変数]] を参照してください。SDL2ライブラリのベンダー修正版を使用する一部のゲーム（Dota2など）では、{{ic|1=SDL_IM_MODULE=fcitx}} も追記します。}}&lt;br /&gt;
&lt;br /&gt;
=== デスクトップ環境での自動起動 ===&lt;br /&gt;
&lt;br /&gt;
デスクトップ起動時に Fcitx5 を[[自動起動]] させたい場合は、[[Fcitx#デスクトップ環境の自動起動]] を参照してください。&lt;br /&gt;
&lt;br /&gt;
{{Note|&lt;br /&gt;
* Fcitx5 の起動ファイルの場所が変更になり、現在は {{ic|/usr/share/applications/org.fcitx.Fcitx5.desktop}} になっています。&lt;br /&gt;
* [[KDE]], [[GNOME]], [[Xfce]], [[LXDE]] などの XDG 互換のデスクトップ環境を使用している場合、再ログイン後、自動起動します。&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
{{Tip|Fcitx5 が正しく動作しているかどうかを確認するには、アプリケーションを開いて {{ic|Ctrl+Space}} を押して入力方法を切り替え（設定されている場合）、いくつかの単語を入力してみてください}}&lt;br /&gt;
&lt;br /&gt;
== 設定 ==&lt;br /&gt;
=== 設定ツール ===&lt;br /&gt;
&lt;br /&gt;
{{Pkg|fcitx5}} の設定ファイルは、{{ic|~/.config/fcitx5}} にあります。テキストエディタを使用して設定ファイルを編集できますが、GUIを使った方が明らかに便利です。 {{Pkg|fcitx5-configtool}} パッケージをインストールします。&lt;br /&gt;
&lt;br /&gt;
=== XKB の設定を上書きしないようにする ===&lt;br /&gt;
&lt;br /&gt;
Fcitx5 はデフォルトで X のキーボード設定を上書きします。({{ic|setxkbmap}} コマンドや [[デスクトップ環境]] が提供するグラフィカルなツールで設定できるものです) もしそうしたくない場合は、{{ic|fcitx5-configtool}} を実行して、&#039;&#039;Addons → XCB → Allow Overriding System XKB Settings&#039;&#039; のチェックを外してください。&lt;br /&gt;
&lt;br /&gt;
=== テーマ ===&lt;br /&gt;
&lt;br /&gt;
収録されているテーマは非常に少なく、[https://github.com/search?q=fcitx5+theme&amp;amp;type=Repositories GitHub] でより多くのテーマを見つけることができます。&lt;br /&gt;
&lt;br /&gt;
* {{AUR|fcitx5-breeze}}:KDEBreeze スタイルのテーマ&lt;br /&gt;
* {{Pkg|fcitx5-nord}} :[https://github.com/tonyfettes/fcitx5-nord Nord] カラーのテーマ&lt;br /&gt;
* {{Pkg|fcitx5-material-color}}: このテーマはマイクロソフトの PinYin のような感じです。公式版は [https://github.com/hosxy/Fcitx5-Material-Color GitHub: Fcitx5-Material-Color] にあります。README.md ファイルに1行モードに設定するためのガイダンスがあります。&lt;br /&gt;
* {{AUR|fcitx5-solarized}}: [https://github.com/mingyech/fcitx5-solarized Solarized] カラーのテーマ&lt;br /&gt;
&lt;br /&gt;
{{Tip|KCM を使用している場合は、&#039;&#039;Setting -&amp;gt; Location -&amp;gt; input method -&amp;gt; Configure addons -&amp;gt; Classic user interface -&amp;gt; Theme&#039;&#039; でテーマを切り替えます。}}&lt;br /&gt;
&lt;br /&gt;
== トラブルシューティング ==&lt;br /&gt;
&lt;br /&gt;
=== 問題の診断 ===&lt;br /&gt;
​fcitx5 の使用に問題がある場合 (例. ​{{ic|Ctrl+Space}} がすべてのアプリケーションで機能しないなど。最初に試すべきことは、{{ic|fcitx5-diagnose}} を使用して診断することです。​{{ic|fcitx5-diagnose}} の出力には、最も一般的な問題の手がかりが含まれています。&lt;br /&gt;
&lt;br /&gt;
=== 最新の wps は fcitx5 を使用できません ===&lt;br /&gt;
&lt;br /&gt;
参照. [[WPS Office#Fcitx5 cannot input Chinese]]&lt;br /&gt;
&lt;br /&gt;
=== intellij IDE で error position ===&lt;br /&gt;
&lt;br /&gt;
根本的な原因は、IDE からの JBR が完全にわからないことです。この問題を解決するには、次のものが必要です。&lt;br /&gt;
&lt;br /&gt;
1. この jbr をダウンロードして抽出します: https://github.com/RikudouPatrickstar/JetBrainsRuntime-for-Linux-x64/releases&lt;br /&gt;
&lt;br /&gt;
2. IDE の JBR を適宜変更する https://intellij-support.jetbrains.com/hc/en-us/articles/206544879-Selecting-the-JDK-version-the-IDE-will-run-under&lt;br /&gt;
&lt;br /&gt;
=== 候補ボックス内で絵文字の表示がおかしい ===&lt;br /&gt;
&lt;br /&gt;
1. 絵文字のフォントがインストールされていることを確認します。 (例えば {{Pkg|noto-fonts-emoji}})&lt;br /&gt;
&lt;br /&gt;
2. システムフォントを {{ic|Noto Sans CJK JP}} にします。&lt;br /&gt;
&lt;br /&gt;
3. 次のコマンドを使用して、Fcitx5 を再起動します。&lt;br /&gt;
&lt;br /&gt;
 # kill `ps -A | grep fcitx5 | awk &#039;{print $1}&#039;` &amp;amp;&amp;amp; fcitx5&amp;amp;&lt;br /&gt;
&lt;br /&gt;
=== GTK 環境の HiDPI モードで候補ポップアップがずれる ===&lt;br /&gt;
&lt;br /&gt;
候補ポップアップの位置がカーソル位置に固定されていない場合は、{{Pkg|fcitx5-gtk}} を [[インストール]] して下さい。&lt;br /&gt;
&lt;br /&gt;
=== kitty で fcitx5 を使用できない ===&lt;br /&gt;
&lt;br /&gt;
こちらを参照 [[Kitty#IME サポートを有効にする]]&lt;br /&gt;
&lt;br /&gt;
== ヒントとテクニック ==&lt;br /&gt;
&lt;br /&gt;
=== 選択した文字の Unicode エンコーディングを表示する方法 ===&lt;br /&gt;
&lt;br /&gt;
*選択したテキストの Unicode エンコーディングをテキストエディタで表示する場合は、テキストを直接選択し、ショートカットキー{{ic|ctrl + alt + shift + u}}を使用して、選択したテキストのエンコーディングを表示します。&lt;br /&gt;
&lt;br /&gt;
*非編集領域(この Wiki など)のテキストの Unicode エンコーディングを表示する場合は、まずテキストをクリップボードにコピーしてから、編集可能な領域(検索ボックスなど)をクリックする必要があります。 次に、ショートカットキー {{ic|ctrl + alt + shift + u}} を使用して、クリップボード内のテキストのエンコーディングを表示できます。&lt;br /&gt;
&lt;br /&gt;
=== 特殊文字を入力 ===&lt;br /&gt;
&lt;br /&gt;
一般に、{{ic|≤}}、{{ic|ā}}、{{ic|á}}、{{ic|©}} などの単純な記号は、[[Xorg でのキーボード設定#コンポーズキーの設定|コンポーズキーの設定]] から入力できますが {{ic|②}}、{{ic|③}}、{{ic|④}}などの特殊記号の場合は、次のいずれかをカスタマイズします {{ic|~/.XCompose}} または、Fcitx5 の Unicode 関数を使用します。&lt;br /&gt;
&lt;br /&gt;
{{ic|①}} を例にとってみましょう。&lt;br /&gt;
&lt;br /&gt;
任意の入力ボックスにカーソルを置いて {{ic|Ctrl+Alt+Shift+U}} を押し、{{ic|circle one}} と入力すると、{{ic|①}} などの特殊文字が表示されます。&lt;br /&gt;
&lt;br /&gt;
=== 半角/全角句読点の切り替え ===&lt;br /&gt;
&lt;br /&gt;
{{Pkg|fcitx5-chinese-addons}} では、デフォルトで全角句読点が使用されますが、{{ic|Ctrl + .}} で半角と全角の句読点を切り替えることができます。&lt;/div&gt;</summary>
		<author><name>Tkna</name></author>
	</entry>
</feed>