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

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

推奨される調査手順

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

システムとアカウント

なぜ `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/`	Web アップロードおよび USB プリント用のファイルエントリ
実行ログ	`/usr/share/printer_data/logs/`	Klipper、Moonraker、スクリーンおよびカメラログ
プラグインおよびソースコード	`/data/`	カスタムプラグインはここに統一的に配置する必要があります
Klipper ソースコード	`/data/klipper/`	システムにプリインストールされた Klipper ディレクトリ
コンパイル成果物	`/data/klipper/out/`	ファームウェアコンパイル完了後の出力ディレクトリ

RRF モードのデータディレクトリは /opt/dsf/ であり、Klipper と RRF の設定パスを混用しないでください。

RRF 設定パスとよくあるエラー: RRF モードのトラブルシューティングを参照

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

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

FLYOS-FAST システム設定を変更するには？

システムモデル、ネットワーク、スクリーンおよびサービスのスイッチは、FlyOS-Conf/config.txt で統一的に管理されます。システム起動後も、Web ページの .flyos-config/sys-config.conf から変更できます。

設定方法と有効範囲: FLYOS-FAST システム設定ガイドを参照

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

設定によって、異なる有効化操作を実行する必要があります：

変更内容	有効化操作
`printer.cfg` および Klipper 設定フラグメント	Web ページで保存して再起動を実行
`moonraker.conf`	Moonraker を再起動
`config.txt` または `sys-config.conf`	上位機全体を再起動
プラグインのソースコードまたはシンボリックリンク	プラグインのチュートリアルに従って対応するサービスを再起動

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

RRF モード

RRF モードでDCSが繰り返し切断され、M550マシン名不一致の警告が出る場合の対処方法

RRFモードで以下の現象が発生する場合：

DWCウェブページに Connection interrupted、DCS has been stopped が繰り返し表示される。
起動ログに Error in start-up file config.g line 3: M550: Machine name must consist of the same letters and digits as configured by the Linux hostname が表示される。
DCS（Duet Control Server）が正常に起動できず、ウェブページに接続できない。

原因

RRFでは、config.g 内の M550 P"..." で設定するマシン名が、Linuxシステムのホスト名と完全に一致している必要があります（同じ英数字のみを含む）。両者が一致しない場合、DCSは起動を拒否し、クラッシュと再接続を繰り返します。

printer_name は初回起動時にのみホスト名の初期化に使用されます。その後、手動でホスト名を変更した際に config.g を同期して変更しなかった場合、または他のデバイスの config.g をコピーした場合に、このエラーが発生します。

調査と修正手順：

SSHでホストマシンに接続し、現在のLinuxホスト名を確認します：
```
hostname
```
RRF設定ファイル内の M550 の現在値を確認します：
```
cat /opt/dsf/sd/sys/config.g | grep M550
```
M550 をホスト名と一致するように変更します。例えばホスト名が fly-c5 の場合、次のように変更します：
```
M550 P"fly-c5"
```
ファイルを保存後、DWCウェブページでDCSを再起動するか、ホストマシンを直接再起動します。

名称の文字制限

M550 のマシン名は英数字のみを含むことができ、スペース、アンダースコア、中国語、その他の特殊文字を含めることはできません。ホスト名を変更する必要がある場合は、config.g 内の M550 も同期して更新し、両者を一致させてください。

RRFモードの設定ファイルはどこにありますか？

RRFのすべての設定ファイルは /opt/dsf/sd/sys/ ディレクトリにあり、主なファイルは以下の通りです：

ファイル	用途
`config.g`	メイン起動設定ファイル。`M550`（マシン名）などのコア設定を含む
`board.txt`	ボードレベル設定（ネットワーク、SPI など）
`deploy.d`	デプロイスクリプトディレクトリ

G-codeファイルは /opt/dsf/sd/gcodes/ に保存され、USBメモリから印刷するファイルもこのパスにマウントされます。Klipperの設定パス（/usr/share/printer_data/）をRRFと混用しないでください。

プラグインと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に一括コピーしないでください。

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

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

順番に確認します：

ネットワークからの取得手順が完全に成功したか。
プラグインファイルが実際に /data/ に存在するか。
シンボリックリンクが正しいファイルを指しているか：
```
readlink -f /data/klipper/klippy/extras/プラグインファイル.py
```
printer.cfg にプラグイン設定がロードされているか。
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コマンドを使用してください。

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

コンピュータと上位機が同じローカルネットワークにいることを確認します。
ルーターでデバイスのアドレスを確認し、変更された古いIPにアクセスし続けないようにします。
SSHで現在のネットワークアドレスを確認します：
```
ip -br addr
```
起動に失敗したサービスがないか確認します：
```
systemctl --failed --no-pager
```
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パスワード、クラウドサービスの認証情報、トークンなどの機密情報を削除してください。

ログと技術サポート

一般的なログはどこにありますか？

ログ	パス
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、または対応するサービスのログ。
問題が安定して再現するかどうか、および再起動後も残っているかどうか。

システムとアカウント​

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

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

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

ファイルと設定​

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

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

FLYOS-FAST システム設定を変更するには？​

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

RRF モード​

RRF モードでDCSが繰り返し切断され、M550マシン名不一致の警告が出る場合の対処方法​

RRFモードの設定ファイルはどこにありますか？​

プラグインとPython環境​

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

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

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

ウェブとネットワーク​

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

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

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

印刷、USBメモリ、カメラ​

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

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

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

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

ログと技術サポート​

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

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

ログと技術サポート​

一般的なログはどこにありますか？​

技術サポートに連絡する際に提供する必要があるものは？​

システムとアカウント

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

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

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

ファイルと設定

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

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

FLYOS-FAST システム設定を変更するには？

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

RRF モード

RRF モードでDCSが繰り返し切断され、M550マシン名不一致の警告が出る場合の対処方法

RRFモードの設定ファイルはどこにありますか？

プラグインとPython環境

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

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

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

ウェブとネットワーク

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

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

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

印刷、USBメモリ、カメラ

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

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

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

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

ログと技術サポート

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

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

ログと技術サポート

一般的なログはどこにありますか？

技術サポートに連絡する際に提供する必要があるものは？