FLYOS-FAST よくある質問とトラブルシューティング

このページでは、FLYOS-FASTのシステム制限、設定パス、更新方法、および一般的な障害について集中的に説明します。各機能の完全な操作手順はリンクから対応するドキュメントにジャンプし、FAQでの重複メンテナンスを避けます。

推奨される調査手順

1. ウェブページまたはターミナルに表示される完全なエラーメッセージを記録し、最後の行だけを切り取らないでください。
2. 問題が発生する前に変更した設定、プラグイン、またはシステムオプションを確認します。
3. ディスク容量、サービス状態、および対応するログを確認します。
4. サービスや上位機を再起動する場合は、プリンタが印刷、加熱、または動作を実行していないことを先に確認します。

システムとアカウント

なぜ root ユーザーのみ使用できるのですか？

FLYOS-FASTは印刷制御デバイス向けに設計された軽量システムであり、シングルユーザー管理方式を採用しています。root が唯一の対話型管理アカウントです。システムは他のユーザーの作成や切り替えをサポートしていません。

なぜ apt や dpkg を使用できないのですか？

FLYOS-FASTは従来のLinuxディストリビューションのパッケージ管理環境を提供しないため、以下のコマンドでソフトウェアをインストールまたは更新することはできません：

apt update
apt install
dpkg -i

他のLinuxシステムからソフトウェアパッケージやシステムライブラリをコピーしないでください。追加の依存関係はプラグインのインストールチュートリアルで明確に提供されるべきです。一般的な依存関係が不足している場合は、テクニカルサポートにフィードバックしてください。

なぜシステムディレクトリが読み取り専用と表示されるのですか？

コアシステムは読み取り専用ファイルシステムを使用し、完全なイメージまたはOTAによって一括更新されます。ルートディレクトリを再マウントしてシステムファイルを直接変更しようとしないでください。更新の失敗や再起動後の変更の消失を引き起こす可能性があります。

ユーザー設定、プラグイン、印刷データは永続化ディレクトリに保存してください。

ファイルと設定

一般的なファイルはどこに保存されますか？

内容	Klipperモードのパス	説明
プリンタ設定	/usr/share/printer_data/config/	printer.cfg、Moonraker、カメラ設定を含む
G-codeファイル	/usr/share/printer_data/gcodes/	ウェブアップロードとUSBメモリ印刷のファイル入り口
実行ログ	/usr/share/printer_data/logs/	Klipper、Moonraker、画面、カメラのログ
プラグインとソースコード	/data/	カスタムプラグインはここに統一して配置してください
Klipperソースコード	/data/klipper/	システムにプリインストールされたKlipperディレクトリ
コンパイル成果物	/data/klipper/out/	ファームウェアコンパイル完了後の出力ディレクトリ

RRFモードのデータディレクトリは /opt/dsf/ です。KlipperとRRFの設定パスを混在させないでください。

どのディレクトリが永続保存されますか？

システムは /etc、/data、/root、および現在の印刷モードのデータディレクトリを保存します。これらのディレクトリが保持される場合でも、OTAまたは再書き込みの前にプリンタ設定を個別にバックアップしてください。

FLYOS-FASTのシステム設定を変更するにはどうすればよいですか？

システムモデル、ネットワーク、画面、サービスのオン/オフは FlyOS-Conf/config.txt で一括管理されます。システム起動後も、ウェブページ内の .flyos-config/sys-config.conf から変更できます。

設定方法と有効範囲：FLYOS-FASTシステム設定ガイドを確認

設定を変更したのに反映されないのはなぜですか？

異なる設定には異なる反映操作が必要です：

変更内容	反映操作
printer.cfg とKlipper設定スニペット	ウェブページで 保存して再起動 を実行
moonraker.conf	Moonrakerを再起動
config.txt または sys-config.conf	上位機全体を再起動
プラグインのソースコードまたはシンボリックリンク	プラグインのチュートリアルに従って対応サービスを再起動

再起動後も反映されない場合は、ファイルが保存されていること、設定項目が重複定義されていないことを確認し、対応するサービスのログを確認してください。

システム更新とファームウェア

システムはどのように更新すべきですか？

FLYOS-FASTはシステムOTAまたは対応デバイスの正式イメージの再書き込みによって更新してください。サードパーティ製のシステムアップグレードスクリプトでコアファイルを置き換えないでください。

オンラインおよびUSBメモリ更新：OTAシステム更新ガイドを確認

システムの再書き込み：システムイメージ書き込みチュートリアルを確認

OTAはプリンタ設定を削除しますか？

通常のOTAは /data とプリンタデータディレクトリを保持しますが、以下の状況では設定が異常になる可能性があります：

• ユーザーがKlipper、Moonraker、または他のプリインストールコンポーネントを自分で置き換えた。
• カスタムファイルがOTAが提供する新しいファイルを遮蔽している。
• 更新中に電源が遮断された。
• 更新前にディスク容量が不足している、またはファイルシステムがすでに破損している。

更新前には printer_data/config のバックアップをダウンロードまたはコピーしてください。更新および再起動中は電源供給を安定させ、印刷操作を実行しないでください。

KlipperやMoonrakerだけを個別に更新できますか？

推奨しません。システム内のKlipper、Moonraker、ウェブインターフェース、画面サービスは連携して調整されているため、単一コンポーネントを個別に置き換えると、パス、拡張インターフェース、または更新メカニズムが破壊される可能性があります。システムが提供する全体更新方法を使用してください。

OTA後にMCUバージョンの不一致が発生した場合はどうすればよいですか？

OTAはFLY-C8、FLY-C5、FLY-C8P、FLY-GEMINI V3 マザーボードのUSBファームウェアの自動更新のみをサポートします。他のマザーボード、CANファームウェア、ツールボード、およびその他の外部MCUは自動更新をサポートしていないため、対応する製品チュートリアルに従って手動で書き込む必要があります。

自動更新範囲と確認方法：OTA後のMCUファームウェア更新説明を確認

ファームウェアのコンパイルが完了したらどこでファイルを見つけますか？

コンパイル成果物は以下の場所にあります：

/data/klipper/out/

実際のファイルは klipper.bin または klipper.uf2 の場合があり、MCUアーキテクチャとブートローダ設定によって決まります。

ファームウェアコンパイル説明：Klipperファームウェアコンパイルチュートリアルを確認

プラグインとPython環境

なぜ ~/klippy-env/bin/python が見つからないのですか？

FLYOS-FASTはシステムPythonを使用し、一般的な klippy-env 仮想環境を使用しません。コマンド内のPythonインタープリタとKlipperパスをシステムの実際のパスに変更してください。例えば、CAN UUIDを照会する場合は以下を使用します：

python /data/klipper/scripts/canbus_query.py can0

Pythonコマンドだけを置き換えて、誤った ~/klipper/ パスを残さないでください。

プラグインはどこにインストールすべきですか？

プラグインリポジトリは /data/ に統一して配置してください。Klipperに拡張ファイルを追加する必要がある場合は、シンボリックリンクを優先的に使用し、プラグインのチュートリアルで要求されるファイル名と依存関係を先に確認してください。プラグインのディレクトリ全体をKlipperに一括コピーしないでください。

インストールルールと既存のプラグインチュートリアル：プラグインインストール説明を確認

プラグインをインストールしても反映されない場合はどうすればよいですか？

順番に確認します：

1. ネットワークからの取得手順が完全に成功したか。

2. プラグインファイルが実際に /data/ に存在するか。

3. シンボリックリンクが正しいファイルを指しているか：

   readlink -f /data/klipper/klippy/extras/プラグインファイル.py

4. printer.cfg にプラグイン設定がロードされているか。

5. Klipperログにモジュール、依存関係、設定項目の欠落に関するエラーが表示されていないか。

エラーを回避するために安全設定を削除したり、Klipperの温度、リミット、加熱保護を無効にしたりしないでください。

ウェブとネットワーク

各ウェブページの入り口はそれぞれ何ですか？

機能	アドレス	使用条件
Fluidd または Mainsail	http://デバイスIP/	Klipperモードが正常に起動している
OTA管理ページ	http://デバイスIP:9998/	上位機のネットワークが正常
GoCam管理ページ	http://デバイスIP:8080/	GoCamが有効になっている

なぜ デバイスIP:9999 にアクセスできないのですか？

FLYOS-FASTはデフォルトで fly-tools ウェブサービスを提供しないため、9999 ポートが応答しないのは正常です。システム設定とファームウェア操作は、対応するFLYOS-FASTドキュメントとSSHコマンドを使用してください。

メインのウェブページにアクセスできない場合、どのように確認しますか？

1. コンピュータと上位機が同じローカルネットワークにいることを確認します。

2. ルーターでデバイスのアドレスを確認し、変更された古いIPにアクセスし続けないようにします。

3. SSHで現在のネットワークアドレスを確認します：

   ip -br addr

4. 起動に失敗したサービスがないか確認します：

   systemctl --failed --no-pager

5. SSHも接続できない場合は、システムが起動を完了しているかどうかを先に確認し、その後、ネットワークケーブル、Wi-Fi設定、電源供給を調査します。

SSH接続方法：SSHで上位機に接続する方法を確認

印刷、USBメモリ、カメラ

USBメモリは認識されるが、印刷を開始できない場合はどうすればよいですか？

ファイルシステム、G-code拡張子、ローカルの空き容量、ファイルエンコーディングを確認してください。一部の非UTF-8 G-codeでは「ローカルアップロードは正常だが、USBメモリからは印刷を開始できない」という状況が発生します。

USBメモリ印刷とエンコーディングの調査：USBメモリ印刷機能の使用ガイドを確認

カメラに映像が表示されない場合はどうすればよいですか？

まずカメラがUVCプロトコルをサポートしているか確認し、次にカメラサービスが有効かどうか、デバイスノードが正しいかどうか、解像度がカメラでサポートされているかどうかを確認してください。同じカメラを占有する2つのサービスを同時に起動しないでください。

カメラ接続と設定：カメラの接続と使用方法を確認

遅延撮影で画像が生成されない場合はどうすればよいですか？

まずブラウザでスナップショットアドレスに直接アクセスし、単一の画像が返されることを確認してください。カメラサービスが変更された場合は、moonraker.conf の snapshoturl も同期して修正する必要があります。

スナップショットアドレスとログ調査：遅延撮影機能を確認

Klipper でエラーが発生した場合、どこから調査を始めればよいですか？

まずWebページに表示される元のエラーを記録し、klippy.log で最初に発生した例外を確認してください。最後に表示される切断や再起動の通知は通常、後続の現象に過ぎず、根本原因ではない可能性があります。

Klipper エラー索引：Klipper のよくあるエラーを確認

ログと技術サポート

よく使うログはどこにありますか？

ログ	パス
Klipper	/usr/share/printer_data/logs/klippy.log
Moonraker	/usr/share/printer_data/logs/moonraker.log
KlipperScreen	/usr/share/printer_data/logs/klipperscreen.log
Crowsnest	/usr/share/printer_data/logs/crowsnest.log
GoCam	/usr/share/printer_data/logs/gocam.log
USB自動マウント	/var/log/flyos-auto-mount.log

最近の内容のみを確認する場合は、次を使用できます：

tail -n 100 /usr/share/printer_data/logs/klippy.log

主要サービスの状態を確認する：

systemctl status klipper moonraker --no-pager

システムリソースを確認する：

uptime
free -h
df -h

技術サポートに連絡する際、何を提供する必要がありますか？

可能な限り一度に提供してください：

• ホストコンピューターとボードの具体的なモデル。
• FLYOS-FAST のバージョン番号。
• 問題発生前に実行した操作や変更内容。
• Webページの完全なエラースクリーンショット。
• 完全な klippy.log、moonraker.log、または対応するサービスのログ。
• 問題が安定して再現できるかどうか、および再起動後もまだ存在するかどうか。

切り詰めた最後の数行のログだけを提供しないでください。実際の最初のエラーが見えない可能性があります。設定とログを送信する前に、Wi-Fiパスワード、クラウドサービスの認証情報、トークンなどの機密情報を削除してください。