メインコンテンツにスキップ

Klipper Cloud リモートプロキシ

Klipper Cloud リモートプロキシは、ネットワークに接続された FLYOS-FAST デバイスを Klipper Cloud に接続し、クラウドプラットフォームでの現在のホストマシンのバインドとリモートアクセスを可能にします。FLYOS-FAST v1.4.0 テスト版イメージは、初回起動時にローカル資格情報を生成しますが、リモートアクセスはデフォルトでオフになっており、ユーザーが明示的に有効化する必要があります。

テスト機能とリモートアクセスのリスク

この機能は現在、FLYOS-FAST v1.4.0 テスト版イメージでのみ確認されています。有効化すると、デバイスはリモートサービスに積極的に接続します。リモートアクセスが不要な場合は、オフのままにしてください。

デバイス ID、ローカル資格情報、プロキシ設定、およびこれらを含むログは、フォーラム、チャットグループ、その他の公開場所に公開しないでください。

リモート操作の安全性

リモートで移動、加熱、または G-code を実行する前に、プリンターの現場環境が安全であることを確認し、即座に電源を切るか緊急停止できる手段を確保する必要があります。ネットワーク遅延、接続切断、または状態の同期ずれは操作結果に影響を与える可能性があるため、無人で異常に対処できない状況でのリモートでの印刷開始は推奨されません。

機能説明​

  • リモートプロキシを有効にすると、Klipper Cloud プラットフォームの指示に従って現在のホストマシンをバインドできます。
  • リモートプロキシを無効にすると、クラウドへのリモート接続のみが停止され、Fluidd、Mainsail、Moonraker、SSH のローカルネットワークアクセスには影響しません。
  • バックグラウンドに agent プロセスが存在しても、リモートアクセスが有効になっていることを意味するわけではありません。エージェントプロセスがユーザーの承認を待機している可能性もあります。
  • デバイス ID は現在のホストマシンを識別するために使用され、マザーボードの USB ID、CAN UUID、またはプリンター設定内の MCU ID ではありません。

完全な有効化手順​

1. リモートサービスを有効化​

SSH で以下を実行します:

/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote

コマンド実行後にエラーがなければ、プロキシがクラウドに接続するのを待ちます。有効化コマンドを連続して繰り返し実行しないでください。

2. デバイス ID を確認​

クラウドサービスが有効で、ホストマシンがインターネットにアクセスできることを確認してから、以下を実行します:

/data/klipper-cloud-agent/klipper-cloud-agent --device-id

コマンドがデバイス ID を正常に返したら、Klipper Cloud プラットフォームの指示に従ってデバイスをバインドします。コピーする際はデバイス ID 自体のみを選択し、ターミナルのスクリーンショット全体を他の人に送信しないでください。

Loading...
画像説明

上の画像はターミナル操作のイメージであり、デバイス ID は隠されています。ご自身のデバイスが実際に返す内容を基準にしてください。

3. クラウドプラットフォームのバインドを完了​

クラウドプラットフォームの URL

Klipper Cloud デバイス管理

Klipper Cloud デバイス管理 を開き、自分のアカウントでログインします。初めて使用する場合は、ページ内の利用须知、サービス契約、プライバシールールを先にお読みください。

Loading...

ログイン後、左側の マイデバイス エリアでデバイス追加ボックスを見つけます:

  1. --device-id が返した完全なデバイス ID を KD-… デバイス ID を入力 に入力します。
  2. 追加 をクリックします。
  3. デバイスが左側のリストに表示され、ステータスが オンライン と表示されるのを待ちます。
  4. デバイスをクリックすると、ページ内でリモートデバイス管理インターフェースを開けます。独立したウィンドウが必要な場合は、右上隅の 新しいウィンドウで開く をクリックします。
Loading...
ヒント

デバイス管理ページのスクリーンショットに含まれるアカウント、デバイス名、デバイス ID、リモート印刷インターフェースはすべて隠されています。実際の情報を含むページのスクリーンショットを公開しないでください。

バインド後、併せて以下を確認する必要があります:

  1. クラウドプラットフォームに表示されるデバイスが現在のホストマシンと一致していること。
  2. リモートページが現在のプリンターの状態を読み取れること。
  3. ローカルネットワーク内の Fluidd または Mainsail が引き続き正常にアクセスできること。

他人が提供したデバイス ID を使用したり、信頼できないアカウントに自分のデバイスをバインドしたりしないでください。

リモートサービスを無効化​

リモートアクセスが不要になったら、以下を実行します:

/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote
Loading...

無効化後も、ローカルの Fluidd、Mainsail、Moonraker、SSH のローカルネットワークアクセスは影響を受けません。デバイスの譲渡、修理、再インストールを予定している場合は、Klipper Cloud プラットフォームでもデバイスのバインドを解除してください。無効化コマンドを実行するだけでは、クラウドプラットフォームのアカウントとの関係は解除されません。

クラウドプラットフォームのバインドを解除​

デバイスの譲渡、修理、または使用を中止する場合は、デバイス側のリモートサービスを無効化し、プラットフォームのバインドも解除する必要があります:

  1. まず SSH で --disable-remote を実行します。
  2. コンピューターでは左側のデバイスを右クリックします。スマートフォンやタッチデバイスでは、そのデバイスを長押しします。
  3. 削除/バインド解除 を選択します。
  4. ページの指示に従って、現在のデバイス名を入力して確認します。
Loading...

バインド解除により、現在のアカウントとそのデバイスの関係が削除されます。デバイス側に保存された設定、印刷ファイル、およびローカルネットワークアクセスは削除されません。

コマンド早見表​

操作コマンド使用条件
エージェントプログラムの確認test -x /data/klipper-cloud-agent/klipper-cloud-agent && echo "klipper-cloud-agent がインストールされています"SSH ログイン後に実行
リモートサービスの有効化/data/klipper-cloud-agent/klipper-cloud-agent --enable-remoteホストマシンがネットワークに接続されていること
デバイス ID の確認/data/klipper-cloud-agent/klipper-cloud-agent --device-idリモートサービスが有効でネットワークが正常であること
リモートサービスの無効化/data/klipper-cloud-agent/klipper-cloud-agent --disable-remoteクラウドアクセスが不要になった場合に実行
Loading...