Distroboxのソースを表示

[[Category:仮想化]]
[[Category:サンドボックス]]
Distrobox は、ホストとの緊密な統合を提供しながら、ホストと異なる Linux のコンテナ化されたバージョンをインストールし、あるディストリビューションで設計されたバイナリを別のディストリビューションで実行することを可能にするコンテナのラッピングレイヤーです。

Distrobox 自体はコンテナマネージャーではなく、[[Podman]] または [[Docker]] に依存してコンテナを作成します。

Distrobox のドキュメントから：

:ターミナル内の任意の Linux ディストリビューションを使用してください。ソフトウェアのバックワードおよびフォワード互換性を有効にし、好きなディストリビューションを自由に使用することができます。Distrobox は、選択した Linux ディストリビューションを使用して、podman または docker を使用してコンテナを作成します。作成されたコンテナは、ホストと緊密に統合され、ユーザーの HOME ディレクトリ、外部ストレージ、外部 USB デバイス、グラフィカルアプリ (X11/Wayland)、およびオーディオの共有が可能になります。

== セキュリティへの影響 ==

Distrobox の主な目的は、ホストからコンテナをサンドボックス化することに焦点を当てていない（プロジェクトの緊密な統合の性質上、これは不可能）ため、Distrobox 内で実行されるコンテナは、ホームフォルダーおよび他のいくつかの場所にフルアクセスします。

サンドボックス化された運用モードは現在計画段階にあり、進行状況は[https://github.com/89luca89/distrobox/issues/28 こちら]でトラッキングできます。

デフォルトで Docker はコンテナを root として実行し、rootful コンテナは'''ホストのファイルシステムに無制限のアクセスを持つ'''ため、Docker よりも Podman を使用することを推奨します。Rootless Docker は現在動作していないが、作業中です。

== インストール ==

=== ルートアクセス権を持つ場合 ===

まず、[[Podman]] または [[Docker]] の'''いずれか'''の ページに従い、Hello World コンテナをインストールして実行できることを確認してください。

[[Pacman#パッケージのインストール|パッケージをインストール]]するには、{{pkg|distrobox}} または {{aur|distrobox-git}} のいずれかを選択してください。

=== ルートアクセス権がない場合/イミュータブルなファイルシステムの場合 ===

以下の両方を実行して、[[CURL]] を使用して、ホームフォルダに Distrobox と Podman をインストールします。

{{ic|Distrobox}}
 $ curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --prefix ~/.local

{{ic|Podman}}
 $ curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/extras/install-podman | sh -s -- --prefix ~/.local

以下の場所を {{ic|$PATH}} に追加します。[[環境変数#ユーザー毎|ユーザーごとの環境変数]]を設定します：
 $HOME/.local/bin
 $HOME/.local/podman/bin

コンテナ内でグラフィカルアプリケーションの実行に問題がある場合は、{{pkg|xorg-xhost}} をインストールし、以下を {{ic|~/.bashrc}} 、{{ic|~/.profile}} 、または {{ic|~/.xinitrc}} に追加する必要があります：
 xhost +si:localuser:$USER

==== アンインストール ====

Distrobox は、ルートレスインストールのためのアンインストールスクリプトを提供しています。実行するには、以下を実行します。
 $ curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/uninstall | sh -s -- --prefix ~/.local
{{Note| このスクリプトはルートレスでインストールした場合にのみ必要です。[[Pacman]] を介してインストールした場合は、通常通り[[アンインストール]]を行ってください。}}

== Usage ==

{{Note| 
* Throughout the following section {{ic|''name''}} is a variable and can be whatever you want. In all cases replace {{ic|''name''}} with the actual name you choose
* For the full list of supported options in any sub category use {{ic|''--help''}}, for example to see all creation options use {{ic|distrobox create --help}}
* A full list of supported distros along with their image names can be found at https://distrobox.privatedns.org/compatibility/#containers-distros
* For more advanced usage techniques please see the Distrobox Documentation page at https://distrobox.privatedns.org/usage/usage}}

To create a new container run the following:
 $ distrobox create -n ''name''

To list installed containers run the following:
 $ distrobox list

To interact with an installed container run the following:
 $ distrobox enter ''name''

or you can send a command directly to a container with:
 $ distrobox enter ''name'' -- ''command-to-execute''

To stop a running container run the following:
 $ distrobox stop ''name''

To delete a container run the following:
 $ distrobox rm ''name''

To install a specific distro into a container run the following (in this example its Ubuntu):
 $ distrobox create --image ubuntu:22.04

Installations can be fully customised as follows (in this example its a container called ''test'' running Gentoo with root access):
 $ distrobox create -i docker.io/gentoo/stage3:latest -n test --root

If you need your container to have root access to the host then it is recommended that you use the {{ic|''--root''}} flag over {{ic|''sudo distrobox''}}.

== Configuration ==

It is possible to configure Distrobox in 2 ways, either with a configuration file or by using [[Environment Variables]].

=== Configuation file ===

Distrobox checks the following locations for config files, from least important to most important:

* /usr/share/distrobox/distrobox.conf
* /usr/etc/distrobox/distrobox.conf
* /etc/distrobox/distrobox.conf
* ${HOME}/.config/distrobox/distrobox.conf
* ${HOME}/.distroboxrc

An example config file is as follows:
 container_always_pull="1"
 container_generate_entry=0
 container_manager="docker"
 container_image_default="registry.opensuse.org/opensuse/toolbox:latest"
 container_name_default="test-name-1"
 container_user_custom_home="$HOME/.local/share/container-home-test"
 container_init_hook="~/.local/distrobox/a_custom_default_init_hook.sh"
 container_pre_init_hook="~/a_custom_default_pre_init_hook.sh"
 non_interactive="1"
 skip_workdir="0"

=== Environment variables ===

The following variables are available and should be set using a [[Environment variables#Per user|per user Environment Variable]]:
 DBX_CONTAINER_ALWAYS_PULL
 DBX_CONTAINER_CUSTOM_HOME
 DBX_CONTAINER_IMAGE
 DBX_CONTAINER_MANAGER
 DBX_CONTAINER_NAME
 DBX_CONTAINER_ENTRY
 DBX_NON_INTERACTIVE
 DBX_SKIP_WORKDIR

== See also ==
* [https://github.com/89luca89/distrobox/ Project Github page]
* [https://distrobox.privatedns.org/ Project documentation page]