コミュニティソリューション

ZimaOSでaptが利用できない理由:Buildroot、読み取り専用のシステムファイル、Dockerアプリ

An October 2024 beginner thread where apt commands failed even from root/ttydBridge. The community correctly explained that ZimaOS is an appliance OS rather than Ubuntu/Debian and does not support installing host packages with apt. Current official documentation now explicitly describes ZimaOS as Buildroot-based, mostly read-only, and container-oriented.

apt: command not found が ZimaOS で表示されても、sudo が壊れているという意味ではありません。ZimaOS は Ubuntu や Debian ではなく、これらのディストリビューションが使用する APT パッケージ管理の仕組みを備えていないということです。2024年10月の原文ユーザーは root として、また ttydBridge 経由でログインしていましたが、それでもホストパッケージを更新・インストールできませんでした。これは ZimaOS がそのように設計されていないためです。

現在の IceWhale ドキュメントでは、アーキテクチャがより明確に説明されています。ZimaOS は Buildroot ベースで、root であってもシステムフォルダーの大半は読み取り専用です。また、アプリケーションは aptyum などを使ってホスト OS にインストールするのではなく、コンテナ経由で実行することが想定されています。

問題は sudo ではありません

原文のユーザーは、sudo apt ... などのコマンドが command-not-found エラーを返したため、「sudo コマンド」が失敗していると考えていました。

sudo は権限のコンテキストを変更するだけです。OS にインストールされていないパッケージマネージャーを作り出すことはできません。

ZimaOS は Buildroot ベースです

現在の IceWhale ガイドでは、ZimaOS はアプライアンス型の Buildroot システムとして説明されています。Buildroot は、変更可能なパッケージデータベースや通常の APT リポジトリを備えた汎用ディストリビューションではなく、コンパクトな組み込み Linux イメージを生成します。

そのため、使い慣れた Linux コマンドの多くが利用できても、ZimaOS ホストで Debian/Ubuntu のパッケージ管理チュートリアルを試すと失敗することがよくあります。

システムディレクトリの大半は意図的に読み取り専用です

現在の ZimaOS CLI ガイドによると、root でログインしていても、システムフォルダーの大半は読み取り専用のままです。書き込み可能なユーザーデータやアプリケーションデータは /DATA 配下に保存します。

基本 OS を変更しようとする前に、現在の ZimaOS CLI ファイルシステムモデルを確認してください。

サーバーアプリケーションには Docker を使用する

チュートリアルに「このデーモンを apt でインストールする」と書かれている場合は、まず同じアプリケーションに保守されている Docker イメージや Compose スタックがあるか確認してください。これが ZimaOS の標準的なアプリケーションモデルであり、依存関係を不変のホストから分離できます。

これはメディアサーバー、監視ツール、データベース、VPN クライアント、自動化プラットフォーム、ドキュメントサービスなど、さまざまなホームラボアプリケーションに当てはまります。

ソフトウェアに完全な Debian/Ubuntu ホストが必要なら ZVM を使用する

アプリケーションによっては、systemd、パッケージマネージャー、カーネルモジュール、または複数の OS レベルのサービスを必要とします。その場合は、ZimaOS ホストを無理に Debian/Ubuntu のように動作させるより、Debian または Ubuntu の VM を使用する方が適しています。

VM 内では、ゲスト OS が実際に Debian/Ubuntu であるため、通常の apt パッケージ管理を利用できます。

SSH と ttydBridge にも用途があります

パッケージのインストールがサポートされていないからといって、コマンドラインが役に立たないわけではありません。SSH と Web ターミナルは、調査、ログの確認、Docker コマンド、書き込み可能なストレージ内でのファイル操作、高度なトラブルシューティングに引き続き役立ちます。

現在の IceWhale のガイダンスでは、Developer Mode を通じた SSH とブラウザターミナルの両方がサポートされています。

原文ユーザーの Jellyfin の問題は apt とは無関係でした

原文の投稿者は後に、一部の動画が Files では再生できるのに Jellyfin では再生できないと述べました。IceWhale のコミュニティからは、Docker のメディアパス設定を確認するよう案内されました。

この切り分けが正しい方法です。Jellyfin 内部の再生やライブラリの問題は、APT でホストに無関係なパッケージをインストールするのではなく、アプリのボリュームマッピング、コーデック、トランスコード、ログを確認してデバッグする必要があります。

ZimaOS の apt に関する FAQ

ZimaOS ホストに apt をインストールできますか?

ZimaOS は APT パッケージ管理を前提に設計されていません。ホストを Debian のように扱うのではなく、コンテナまたは VM を使用してください。

root アクセスがあればシステムフォルダーを書き込み可能にできますか?

いいえ。現在の ZimaOS では、root であってもシステムフォルダーの大半が意図的に読み取り専用になっています。

カスタムスクリプトや書き込み可能なファイルはどこに保存すべきですか?

/DATA 配下の書き込み可能な場所、または管理対象の別のデータストレージパスを使用してください。