SetFN
SetFNDocs2026年10月27日

トラブルシューティングガイド

SetFNのインストール中や使用中に、問題が発生することがあります。 このドキュメントでは、よく報告される症状ごとに、原因と解決方法をまとめています。 下の一覧から、発生している症状を探して確認してください。

インストール関連

Q: インストール中にポートの競合エラーが発生しますか？

SetFNが使用するポートを、ほかのプログラムがすでに使用している場合に発生します。

  1. 該当するポートを使用しているプログラムを確認します。
  2. 競合しているプログラムを終了するか、SetFNのポート設定を変更します。
  3. インストールをもう一度実行します。

Q: インストールは完了したのに、サービスが起動しませんか？

自動起動（systemd）を設定している場合は、サービスの状態とログを確認します。

  1. systemctl status setfn-spacebuilderで実行状態を確認します。
  2. 停止している場合は、sudo systemctl start setfn-spacebuilderで起動します。
  3. 起動しない場合は、journalctl -u setfn-spacebuilder -n 100 --no-pagerでエラーメッセージを確認します。
  4. サービスファイルのUserとExecStartの値が、実際のユーザー名と実行ファイルのパスに一致していることを確認します。

自動起動を設定していない場合は、ターミナルで実行ファイルをもう一度実行します。詳しくは、Linuxにインストールするを参照してください。

Q: Dockerでインストールできますか？

公式のDockerイメージは、まだ提供されていません。任意のイメージ名でdocker pullやdocker runを実行しないでください。

  1. 現在は、Linuxにインストールするの方法でインストールします。
  2. Dockerの対応状況は、Dockerでインストールするで確認します。

接続関連

Q: ブラウザーからSetFNに接続できませんか？

ネットワーク設定またはサービスの状態に問題がある可能性があります。

  1. SetFNサービスが正常に実行されていることを確認します。
  2. 接続アドレス（IP、ポート）が正しいことを確認します。
  3. ファイアウォールで該当するポートが許可されていることを確認します。
  4. 同じネットワーク上のほかのデバイスから接続を試します。

Q: ログインできませんか？

  1. IDとパスワードが正しいことを確認します。
  2. Caps Lockがオンになっていないことを確認します。
  3. パスワードを忘れた場合は、パスワードの再設定機能を利用します。
  4. 管理者によってアカウントが無効化されている可能性があるため、管理者に問い合わせます。

Q: 外部から接続できませんか？

外部アクセスの設定が正しく構成されているかどうかを確認する必要があります。

  1. まず、同じネットワークから内部ネットワークのアドレスで接続できることを確認します。
  2. Cloudflare Tunnelなどの外部接続が実行中であることを確認します。
  3. ドメインが正しく接続されていることを確認します。
  4. ブロック管理のアクティブ遮断リストで、接続しようとしているIPがブロックされていないことを確認します。

Q: 特定のユーザーだけ接続できませんか？

  1. ログインの失敗が繰り返されると、IPが自動的にブロックされることがあります。ブロック管理のアクティブ遮断リストで、該当するユーザーのIPを確認します。
  2. ユーザーアカウントの権限と状態が正常であることを確認します。

Q: 管理者もログインできませんか？

管理者アカウントまでブロックされた場合や、パスワードが分からず管理者ページに入れない場合は、SpaceBuilderがインストールされているコンピューターのターミナルで、コマンドを使って復旧します。

  1. ログインのブロックは、unblockコマンドで解除します。
  2. 管理者のパスワードは、user passwordコマンドで変更します。
  3. IPアクセス制限のために管理者ページに接続できない場合は、ipコマンドで許可リストを修正します。

詳しい方法は、コマンドでサーバーを管理するを参照してください。

ファイル関連

Q: ファイルのアップロードに失敗しますか？

  1. アップロード先のフォルダに書き込み権限があることを確認します。
  2. サーバーのディスクの空き容量を確認します。
  3. ファイルサイズが設定された上限を超えていないことを確認します。
  4. ネットワーク接続が安定していることを確認します。

Q: ファイルのダウンロード速度が遅いですか？

  1. サーバーとクライアントが同じ内部ネットワークにあることを確認します。
  2. ネットワーク帯域が十分であることを確認します。
  3. サーバーのCPUとメモリの使用率が高くなりすぎていないことを確認します。
  4. 同時接続者が多い場合は、サーバーのスペックのアップグレードを検討します。

Q: ファイルが一覧に表示されませんか？

  1. 現在のユーザーのレベルとチームで、該当するフォルダにアクセスできることを確認します。
  2. フォルダのフィルタが適用されて、ファイルが非表示になっていないことを確認します。
  3. ブラウザーのキャッシュを消去して、再読み込みします。

パフォーマンス関連

Q: SetFN全体の動作が遅くなりましたか？

サーバーのリソースが不足している可能性があります。

  1. サーバーのCPUとメモリの使用率を確認します。
  2. ディスク容量が十分であることを確認します（空き容量が10%未満になると、パフォーマンスが低下することがあります）。
  3. システム管理のバックグラウンドサービスで、AIやインデックス作成などの処理がリソースを過度に使用していないことを確認します。
  4. サーバーの再起動を試します。

Q: 検索が遅い、または結果が表示されませんか？

  1. 検索インデックスが正常に構築されていることを確認します。
  2. ファイル数が非常に多い場合は、検索範囲を特定のフォルダに絞って試します。
  3. サーバーの再起動後は、インデックスが再構築されるまで時間がかかることがあります。

その他

Q: ブラウザーの互換性に問題がありますか？

SetFNでは、最新のWebブラウザーを推奨しています。次の点を確認してください。

  1. Chrome、Edge、Firefox、Safariの最新バージョンを使用していることを確認します。
  2. Internet Explorerには対応していないため、ほかのブラウザーを使用してください。
  3. ブラウザーのキャッシュとCookieを削除してから、もう一度試します。

Q: 上記の方法で解決しませんか？

  1. サーバーログでエラーメッセージを確認します。自動起動で実行している場合は、journalctl -u setfn-spacebuilder -n 100 --no-pagerを使用します。
  2. システム管理のデバイス情報で、OSとディスクの状態を確認します。
  3. SetFNの公式テクニカルサポートチームに、エラーメッセージと環境情報を添えて問い合わせます。

関連ドキュメント