Termux-Tutorials on Ivon's Blog

Termux proot-distro使用方法：AndroidスマートフォンにLinuxディストリビューションを入れる

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Mon, 01 Jun 2026 02:00:00 +0800

この記事では、proot-distroでLinuxディストリビューションをインストールする方法を説明する。

Termuxはターミナルエミュレーターとして、Root権限なしでproot-distroツールを使い、スマートフォン上にLinuxディストリビューションをインストールできる。

たとえばUbuntu、Arch Linux、Alpine Linux、Fedora、Debian、openSUSEなどをインストールできる。

Sony Xperia 10 VでDebianを実行

proot-distroでインストールしたLinuxディストリビューションはテキストインターフェイスのみで、グラフィカルインターフェイスは自分で設定する必要がある。

面倒だと感じる場合は、記事末尾に載せた自動化スクリプトを参照してほしい。

1. proot & proot-distroとは
#

PCのGNU/Linuxシステムでは、chrootコマンドを使って隔離されたLinux環境を作れる。これはcgroups以前からある、最初期のコンテナ概念だ。chrootコマンドで中へ切り替えると、まるで別のシステムに入ったように見える。たとえばUbuntuでdebootstrapを使ってDebian環境を作り、そのDebian環境を動かす、といった使い方だ。

chrootは仮想マシンでもエミュレーターでもない。chrootコンテナ内部はホストとLinuxカーネルを共有し、多くのシステムリソースも共有するためだ。

2. proot-distroコマンドの使い方
#

Termuxを開き、proot-distroパッケージをインストールする。

pkg install proot-distro

次のコマンドで、オンラインにどのディストリビューションがあるか確認する。

proot-distro install

現在利用可能なディストリビューションには、Alpine Linux、Arch Linux、Debian、Fedora、openSUSE、Ubuntu、および独立したTermux環境であるtermux-dockerなどがあります。その他のLinuxディストリビューションはDocker Hub で入手できます。
Debianをインストールすると仮定して、次を実行する。最新のDebian Stableをインストールするには、以下のコマンドを実行してください。一部のディストリビューションでは、完全な名前を入力しなくてもOCI Registryを自動的に検出できます。ただし、「not found」と表示される場合は、完全な名前を入力する必要があります。

proot-distro install debian

ダウンロード後、システムへログインする：

proot-distro login debian

ログイン後はrootアカウントになる。apt updateを入力すれば、パッケージをインストールできるようになる。使い終わったらexitを入力してシステムから出る。
Proot-distroのグラフィカル環境と音声サーバーを続けて設定しする場合は、Termux Proot Debianを参考に後続設定を行う。
同じLinuxディストリビューションの複数のインスタンスを実行する必要がある場合は、--name の後に異なる名前を指定します。例:

proot-distro install debian --name debian-1
proot-distro install debian --name debian-2

prootシステムを削除するコマンド：

proot-distro remove debian

ダウンロード済みrootfsキャッシュを削除する：

proot-distro clear-cache

3. proot-distroコマンド引数
#

Github説明を参考に、proot-distro login debianコマンドの後ろで次の引数を使える。

--：ログイン後にコマンドを実行する。たとえば下の--の後ろの内容は、prootへログインしてsshdを実行するものであり、proot-distroの引数ではない。

proot-distro login debian -- /usr/bin/sshd

--user：ログインするユーザー

--redirect-ports：低い番号のポートをリダイレクトする。prootの関係で、SSH daemonのように低い番号の22番ポートを使うプログラムでは問題が起きる。このオプションを使うと、SSHのポートは2022（つまりデフォルトポート＋2000）へリダイレクトされる。

--isolated：/sdcard、/data/data/com.termuxをproot内部へマウントしない。

proot-distroはデフォルトで、スマートフォンの内部ストレージをprootシステムの/sdcardディレクトリへbind mountする。つまり、proot Linuxシステム内でrm -rfを実行すると、スマートフォン側のファイルもまとめて削除できてしまう。

さらにTermuxは自身のPATHもproot内部へマウントする。たとえばPythonコマンドを実行するとき、Termux側のバージョンが実行される可能性がある。このオプションを使えば、Pythonコマンド実行時にproot Linux内部のPythonを実行するよう保証できる。

--termux-home：Termuxのホームディレクトリをproot Linux内部のホームディレクトリへマウントする。そのため、proot-distro内のユーザーのホームディレクトリはTermuxホームディレクトリと共有され、プログラムが生成したファイルはproot-distroの外へ出る。

--shared-tmp：Termuxのtmpディレクトリをproot Linux内部のtmpへマウントする。

--bind path:path：追加でマウントするパス。形式は<外部パス>:<Proot Linux内部パス>。

--no-link2symlink：PRoot link2symlink拡張モジュールを無効化し、prootのハードリンクエミュレーション機能をオフにする。SELinuxがpermissiveまたは無効になっている場合のみ使用できる。

--no-sysvipc：PRootのSystem V IPCエミュレーションを無効化する。クラッシュが発生した場合にのみ使う。

--no-kill-on-exit：ログアウト時にすべてのプロセスを終了しない。

4. proot-distroをバックアップする方法
#

Termux Backup commandsではproot-distroはバックアップされないため、別途バックアップが必要だ。

次のコマンドで、prootシステムを圧縮ファイルとしてスマートフォン内部ストレージへバックアップする。たとえばdebianのファイルをバックアップする場合：

proot-distro backup --output storage/shared/debianbackup.tar.gz debian

次のコマンドでprootシステムを復元する：

proot-distro restore debianbackup.tar.gz

付録：スクリプトでProot Distroを自動インストールする
#

Githubには、Linux＋グラフィカルインターフェイスのインストールをまとめて処理してくれる簡易スクリプトが多くある。通常はコピーして貼り付けるだけでよい。

ただし、それらの一部はproot-distroではなく、prootコマンドで直接インストールしている。そのため、そのディストリビューションは本記事で説明したproot-distroでは削除できない可能性がある。

Termux：Arch Linuxデスクトップ環境をゼロから構築＋ワンタップ起動スクリプト

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Sun, 31 May 2026 17:00:00 +0800

この記事では、Androidスマホ上でTermuxのproot-distroパッケージを使い、デスクトップ環境付きのArch Linux ARMを手動で設定する方法を説明します。音楽や動画の再生、デスクトップLinux向けアプリの利用もできます。

Arch Linuxはシンプルさを重視するLinuxディストリビューションで、ユーザーが必要に応じてシステムを組み上げる方針なので、インストール作業ではコマンドを手入力します。Arch Linux ARMは、本家Arch Linux（x86アーキテクチャ中心）の派生版です。x86版にある一部パッケージはARM側で見つからない場合がありますが、AURは同じように利用できます。

この記事ではArch Linuxを手動でインストールする方法を紹介します。手動設定が面倒な場合は、ワンタップインストール用スクリプトの安裝Termux Proot-distroを使ってください。

1. 事前準備
#

Arch Linuxを動かすには、スマホに最低4GB RAM、グラフィカル環境では最低6GB RAMが必要です。足りないとシステムがクラッシュしやすくなります。

ストレージ容量は10GB用意してください。

私の端末：小米Poco F1, Lineage OS 20 (Android 13)

先にこちらを読んでください：Termux基礎教學
続いてTermux X11をインストールします
ハードウェアアクセラレーションを設定します。Termux以virglrenderer達成GPU 3D硬體加速

2. Proot Arch Linux基本システムをインストールする
#

Termuxを実行中に通知欄を下へスワイプし、ACQUIRE WAKELOCKを押してバックグラウンドで動き続けるようにします。

まずproot-distro、PulseAudio、vimをインストールします

pkg update
pkg install proot-distro pulseaudio vim

Arch Linuxをインストールします

proot-distro install archlinux/archlinux：latest

ダウンロード後、以下のコマンドでArch Linuxにログインします。--userパラメータは指定したアカウントでログインすることを表し、ここではrootです。--shared-tmpはTermuxのtmpディレクトリをproot内部にマウントし、Xサーバーのリソースを共有します。

proot-distro login archlinux --user root --shared-tmp

システムパッケージを更新します。yを入力して更新を確認します。

pacman -Syu

Prootシステムを終了するには、exitを入力してログアウトします。

3. Arch Linuxパッケージリポジトリのミラーを変更する
#

これは任意の手順です。Arch Linux ARM公式サイトでミラーを探すと、ダウンロードを高速化できます。

例として台湾国内のミラーを使います。viで/etc/pacman.d/mirrorlistを編集します。

vi /etc/pacman.d/mirrorlist

台湾サーバーServer = http://tw2.mirror.archlinuxarm.orgのコメントアウトを外します。
変更後、もう一度システムを更新します

pacman -Syu

4. 一般ユーザーを追加する
#

rootパスワードを変更します

passwd

一般ユーザーuserを追加し、wheelグループに追加してからパスワードを変更します

pacman -S sudo vim
useradd -m -g users -G wheel,audio,video,storage -s /bin/bash user
passwd user

一般ユーザーアカウントに管理者権限を付与します。/etc/sudoersを編集します

vim /etc/sudoers

# `root ALL=(ALL) ALL`の次の行に以下を追加します:

user ALL=(ALL) ALL

続いてuserアカウントでログインします。以後はrootではなく、一般ユーザーアカウントでシステムにログインします。

su user
cd

5. デスクトップ環境とよく使うツールをインストールする
#

Firefox、中国語フォント、SSHをインストールします

sudo pacman -S vim firefox networkmanager xorg xorg-server pulseaudio noto-fonts-cjk git openssh fakeroot base-devel

AUR Helperとしてyayをインストールします。ビルドに少し時間がかかります

sudo pacman -S --needed git base-devel && git clone https://aur.archlinux.org/yay.git && cd yay && makepkg -si

vimで/etc/makepkg.confを編集し、MAKEFLAGS="-j2"のコメントアウトを外します。さらに-jの後ろの数字をスマホのCPUコア数の2倍に変更すると、AURパッケージのビルドを高速化できます。
次にデスクトップ環境をインストールします。現在TermuxではGNOMEデスクトップを起動できず、KDEはややリソースを食いすぎます。ここでは軽量で実用的なXFCE4を入れます。

sudo pacman -S xfce4 xfce4-goodies lightdm

6. タイムゾーン、中国語、入力メソッドを設定する
#

Termux X11はスマホのキーボードから直接文字入力できますが、外付けキーボードを使う場合は中国語入力メソッドのインストールが必要です。

systemdがないため、シンボリックリンクでタイムゾーンを台湾・台北に設定します

sudo ln -sf /usr/share/zoneinfo/Asia/Taipei /etc/localtime

vimで/etc/hostnameと/etc/hostsを編集し、ホスト名を付けてlocalhostを置き換えます
vimで/etc/locale.genファイルを編集し、zh_TW.UTF-8のコメントアウトを外します。
その後、ロケール設定ファイルを生成します

sudo locale-gen
sudo echo "LANG=zh_TW.UTF-8" >> /etc/locale.conf

それでも中国語が表示されない場合は、~/.profileに以下のパラメータを追加します。

LANG=zh_TW.UTF-8
LC_CTYPE=zh_TW.UTF-8
LC_NUMERIC=zh_TW.UTF-8
LC_TIME=zh_TW.UTF-8
LC_COLLATE=zh_TW.UTF-8
LC_MONETARY=zh_TW.UTF-8
LC_MESSAGES=zh_TW.UTF-8
LC_PAPER=zh_TW.UTF-8
LC_NAME=zh_TW.UTF-8
LC_ADDRESS=zh_TW.UTF-8
LC_TELEPHONE=zh_TW.UTF-8
LC_MEASUREMENT=zh_TW.UTF-8
LC_IDENTIFICATION=zh_TW.UTF-8
LC_ALL=

Fcitx5と新酷音をインストールします

sudo pacman -S fcitx5-config-qt fcitx5-chewing fcitx5-qt fcitx5-gtk fcitx5-chinese-addons

vimで~/.profileを編集し、以下を追加します。

fcitx5 &
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx
SDL_IM_MODULE=fcitx
GLFW_IM_MODULE=ibus

次回Prootへログインしたら、アプリケーション一覧からFcitx5を起動します。右上のシステムトレイにあるキーボードアイコンを右クリックし、新酷音入力メソッドを追加します。

7. 手動でデスクトップ環境に入る方法
#

この節は仕組みを理解するためのものです。知る必要がなければ次の節へ進んでください。

インストール完了後、Termuxを終了してアプリを再起動します。

以後Arch Linuxへログインする手順は以下の通りです。

Termuxを再起動します。Termux X11を開き、バックグラウンドで開いたままにします。
次にTermuxへ戻り、PulseAudio、Termux X11、virgl serverを起動します

pulseaudio --start --exit-idle-time=-1
pacmd load-module module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1

export DISPLAY=:0
termux-x11 :0 &

virgl_test_server_android &

Arch Linuxにログインします。ここでは一般アカウントuserでログインする点に注意してください

proot-distro login archlinux --user user --shared-tmp

PulseAudio、Fcitx5、XFCE4デスクトップ環境を順に起動します

export DISPLAY=:0
PULSE_SERVER=tcp:127.0.0.1
fcitx5 &
dbus-launch --exit-with-session startxfce4 &

Termux X11の画面に切り替えると、デスクトップ環境が表示されるはずです。Termux X11のフローティングウィンドウをタップし、権限を取り消すと全画面になります。

8. ワンタップ起動用デスクトップ環境スクリプトを設定する
#

Termux＋Termux X11＋virglserverの起動手順をワンタップで実行し、デスクトップ環境を自動起動します。

Termux Widgetをインストールします
システム設定を開き、Termuxに「他のアプリの上に重ねて表示」を許可します
Termuxを開き直し、以下のコマンドでショートカットを作成します（proot-distro内ではありません）

mkdir .shortcuts
vim .shortcuts/startproot_arch.sh

以下の内容を入力します

#!/bin/bash

# 古いプロセスをすべて終了
killall -9 termux-x11 pulseaudio virgl_test_server_android termux-wake-lock

# Termux X11を起動
am start --user 0 -n com.termux.x11/com.termux.x11.MainActivity
XDG_RUNTIME_DIR=${TMPDIR}
termux-x11 :0 -ac &
sleep 3

# PulseAudioを起動
pulseaudio --start --exit-idle-time=-1
pacmd load-module module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1

# GPUアクセラレーション用virglserverを起動
virgl_test_server_android &

# proot Arch Linuxにログインし、PulseAudio、Fcitx5、デスクトップ環境を起動
proot-distro login archlinux --user user --shared-tmp -- bash -c "export DISPLAY=:0 PULSE_SERVER=tcp:127.0.0.1; dbus-launch --exit-with-session startxfce4"

実行権限を付与します

chmod +x .shortcuts/startproot_arch.sh

スマホのホーム画面でウィジェットを追加し、Termux Widgetを選択すると、先ほど作成したショートカットが一覧に表示されます。
ボタンをタップすると、Termuxが自動で開いてデスクトップへログインします。

参考資料
#

TermuxでpKVMを使いQEMU仮想マシンを高速化する

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Tue, 23 Dec 2025 11:00:00 +0800

私はTermuxでQEMUを動かしてLinux仮想マシンをインストールするで、Androidスマホ上でTermuxを使って仮想マシンを動かす問題について書きました。結論は、とにかく遅いです。

KVMがない場合は、すべてソフトウェアエミュレーションに頼ることになります。その結果、20年前のWindows XPシステムくらいしか動かせず、現代的なOSは到底まともに動きません。

Google Tensorプロセッサを搭載したスマホでは、Android 15以降にpKVMが導入されました。これはAVFフレームワークの下層でサポートされている技術です。

現時点では、Android 16の実験的なDebian Linux Terminalを除き、一般のAPPはpKVMへアクセスできません。pKVMを有効化するにはRoot権限が必要です。

1. パッケージをインストールする
#

KVMアクセラレーションがあるなら、同じアーキテクチャの仮想マシンを実行するべきです。Termux開発者によると、このqemu-system-aarch64-headlessパッケージを使うことで、pKVMで高速化された仮想マシンを利用できます。

以下のパッケージをインストールします。ARMアーキテクチャのマシンでは、UEFIを有効にするのがよいです。

pkg install qemu-system-aarch64-headless qemu-utils qemu-common ovmf sudo

グラフィカル環境にはVirt Managerがなく、Libvirtサービスもおそらく動かないので、AVNCを使って仮想マシンの画面へアクセスするしかありません。

2. TermuxでLinux仮想マシンを作成する
#

Ubuntu ARMのISOをダウンロードし、Termuxのホームディレクトリに置きます
KVMが存在することを確認します

sudo ls /dev/kvm

仮想ディスクを作成します

qemu-img create -f qcow2 ubuntu.qcow2 32G

UEFIを保存するファイルを作成します

truncate -s 64m varstore.img

truncate -s 64m efi.img

dd if=$PREFIX/share/qemu/edk2-aarch64-code.fd of=efi.img conv=notrunc

起動スクリプトを追加します

touch startubuntu.sh

chmod +x  startubuntu.sh

vim startubuntu.sh

内容は以下のとおりです

qemu-system-aarch64 -M virt \
-enable-kvm  \
-drive if=pflash,format=raw,file="efi.img",readonly \
-drive if=pflash,format=raw,file="varstore.img" \
-smp cpus=2 \
-m 1024 \
-cpu host \
-nographic \
-netdev user,id=n1,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 \
-drive file=ubuntu.qcow2 \
-boot d \
-vnc :0 \
-cdrom ubuntu-24.04.3-live-server-arm64.iso

実行時にはsudoを付けます。

sudo ./startubuntu.sh

うまくいけば、AVNCでlocalhost:59000を開いて仮想マシンの画面を見られます。

奇妙なことに、KVMを有効にしなければ起動できますが、有効にするとqemu-system-aarch64: Failed to put registers after init: Invalid argumentエラーに遭遇します。

chrootに切り替えて、その中でKVMを動かせば、成功率が上がるかもしれません。

参考資料
#

Androidに新しく追加されたDebian Linux Terminalは、必ずしもTermuxキラーにはならない

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Fri, 12 Dec 2025 11:00:00 +0800

Android 16のLinuxターミナルは、必ずしもTermuxキラーにはならない。

Termuxは、オープンソースソフトウェア愛好者たちが開発しているAndroidターミナルAPPで、独自のパッケージリポジトリを持っている。

Pixelスマホ上のDebian Terminalを触ってみて、現時点ではこの結論に至った。これはAVFフレームワークを使ってDebian環境を実行し、ChromeOS crosvmに似た技術を使っている。Androidから隔離された、環境としては完全な仮想マシンで、SystemdやDockerを実行できる。

ただし、起動には少し時間がかかる。さらに仮想マシンとホストの隔離により、性能低下も発生する。

GPUアクセラレーションの実現は可能かもしれないが、効率はTermuxより大きく高くなるわけではないだろう。LinuxのWaylandウィンドウをAndroidコンポジタ上に表示する問題も処理しなければならない。

単にCLIプログラムを動かしたいだけなら、Termuxのほうがシンプルで効率がよい。仮想化という層がないからだ。すべてのパッケージはARM64向けにコンパイルされており、急にSSHリモート接続を開きたい場合も、Termuxの起動が最速だ。

TermuxのGPUアクセラレーションにはTurnipとVriGLも使える。

より根本的な違いは、両者の技術アーキテクチャがまったく異なることにある。TermuxはあくまでAndroidネイティブアプリで、userspaceのプログラム環境を作り、ARM64のELFバイナリを直接実行しているだけであり、本当の意味での仮想化は一切ない。ほぼネイティブに近い性能でファイルシステムへアクセスでき、Androidシステムが提供するリソースも直接利用できる。そのため起動時間が速く、I/Oレイテンシが低く、CLIツールを起動する体験が非常によい。

一方、Android 16 Linuxターミナルは別の道を取っている。現在の設計を見る限り、完全なpKVM仮想化 + VirtIOインターフェースを使う方式だ。そのため、起動のたびに実際にはLinux仮想マシンをブートしており、I/OはすべてVirtIOを通る。GPUのグラフィック処理では guest → host → Android SurfaceFlinger という長いデータ経路を扱う必要がある。仮想マシンがホスト側のハードウェアインターフェース（camera、USB、GPU）を使いたい場合も、追加の変換層が必要になるか、そもそもアクセスが禁止される。この完全な隔離はもちろん安全だが、その代償として「タップしてすぐ開き、数秒でshellに入る」体験は期待しにくい。

性能面では、Python scripts、SSH、git、中小規模コードのコンパイルなど、CLIプログラムを動かすだけなら、おそらくTermuxのほうが速い。Androidカーネルと直接やり取りしており、仮想化 overhead がないからだ。GPUアクセラレーションも同様で、TermuxはTurnip/VirGLを通じてAndroidのOpenGLとVulkanアクセラレーションを利用する。かなりhackyではあるが、少なくとも動くし、仮想化層を迂回するぶんレイテンシも低い。

安全性の面では、Linux仮想マシンの客観的な優位性は明らかだ。Termuxがどれだけサンドボックスで隔離されていても、本質的にはAndroid APP層で動いており、攻撃面は一般的なAPPと大きく変わらない。一方AVFはハードウェアレベルの隔離で、さらにpKVMにより仮想マシンのDMA権限、メモリ可視性、利用可能な peripheral を制限できる。これは企業、タブレット、教育市場にはかなり役立つはずだ。

このLinuxターミナルは、どちらかといえばAndroidタブレットをChromeOS化していくための布石だと思う。AVFの技術により、ARMプロセッサ上の仮想化へ統一されたインターフェースを提供できる。

AndroidスマホでPythonを書く：Termux Python開発環境の構築

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Sat, 12 Apr 2025 17:00:00 +0800

Androidスマートフォンアプリ「Termux」でPythonプログラムを書く方法と、Ivon個人の経験を少し共有します。

AndroidスマートフォンでPythonを書くためのアプリは、使いにくいものが少なくありません。純pythonで書かれたパッケージしかインストールできず、wheelに出くわすと止まってしまいます。おそらく目的は、本格的なPython開発環境を作ることではなく、Duolingoのように初心者が練習する場に近いのでしょう。

その中で、Termuxだけは進化を続けています。pip installは今でも通常のLinux環境と100%同じようには動きませんが、Termux専用にコンパイルされたパッケージは増えています。Termuxが提供するPythonパッケージを使えば、簡単な Pythonプログラムを動かし、スマートフォン内のファイルを処理できます。Root権限は不要です。

たとえば、pipでPillowをインストールし、写真のEXIF情報を一括処理する小さなプログラムを書くことができます。スマートフォンのDCIMフォルダ内の全写真を読み込み、EXIF情報に基づいて写真上に日付を印字し、別のフォルダへ出力します。（このプログラムは実際に使えます。ソースコードはこちら）

また、Pythonで書かれたterm-imageを使い、スマートフォン内の画像をターミナルに表示することもできます。

1. テキストだけか、グラフィカル画面か？
#

Termuxは標準ではテキスト画面のターミナルエミュレータです。Pythonプログラムを実行するにはコマンドを入力します。Termux X11を使えばグラフィカル画面も動かせますが、本当に必要でしょうか？

テキスト中心のPythonプログラムは、数値計算、星印の出力、ファイルの一括処理、ファイルのダウンロードなど、プレーンテキストの内容だけを出力します。テキスト画面でプログラムを書くには、VimまたはEmacsで編集する方法を覚える必要があります。これはテキストエディタの操作を練習するよい機会です。

グラフィカル画面なら、ウィンドウ表示やグラフ描画が必要なPythonプログラムを動かせます。グラフィカル画面でコードを書く選択肢は多く、VS CodeやJupyter Notebookもありますが、スマートフォンのリソースをより多く消費します。

グラフィカル画面は必須ではありません。小さなプログラムを書くだけなら、IDEを使う必要はなく、Vimで十分です。

この記事ではテキスト環境を中心に、グラフィカル環境を次点として扱います。

2. TermuxでPythonを動かすか、proot-distroで動かすか？
#

PythonはTermuxで直接動かすことも、proot-distroでDebian環境を作成してからその中で動かすこともできます。

この2つは何が違うのでしょうか。TermuxのPythonパッケージはTermux環境向けにコンパイルされたもので、ネイティブ性能で動作します。ただしTermuxは標準的なLinux環境ではないため、一部のPythonパッケージは使えないことがあります。

一方proot-distroはLinuxシステムに近い環境なので、その中でPythonをインストールすると互換性がよくなります。またDebianのパッケージリポジトリには既製のPythonパッケージが多く、pip wheelに依存しなくて済みます。ただしproot-distroの実行性能は遅くなります。

この記事ではTermux環境を中心にします。

3. TermuxにPythonをインストールする方法
#

Termuxをインストールします。
Pythonとpipをインストールします。Python-venvモジュールも含まれます。

pkg install python3 python-pip

Pythonのバージョンを確認します。執筆時点では3.12のはずです。

python3 --version

Pythonパッケージの実行ファイルの完全なパスは$PREFIX/usr/bin/python3です。

pip installしたパッケージは$PREFIX/lib/python3.xにインストールされます。

Termux Wikiの情報によると、Termuxはローリングリリースなので、pkg upgradeで更新するとPythonも必ず一緒にアップグレードされます。Pythonが次のメジャーバージョンへ上がった後は、pip installしたパッケージを手動で再インストールする必要があります。

4. Pythonバージョンを切り替える
#

Termuxはローリングリリース方式のため、最新バージョンのPythonパッケージだけを提供します。パスは$PREFIX/usr/bin/python3です。pip installでインストールしたパッケージも、上記Pythonのバージョンに対応します。

ではPythonバージョンをどう切り替えるのでしょうか。Pythonバージョン管理ツール「uv」にはTermuxパッケージがありますが、機能は正常ではありません。Anacondaをインストールするつもりなら、Termuxへ直接入れるのは難しく、proot-distro内に入れる必要があります。Termux proot-distroにAnacondaをインストールを参照してください。

残る方法は、TUR Repoが提供する古いPythonを使うことです。Termuxのメインリポジトリでは古いPythonを提供できないため、TUR Repoがその不足を補います。

たとえば現在のバージョンがPython 3.12で、古いPython 3.9が必要なら、TUR Repoからインストールします。

pkg install tur-repo

pkg search python3

pkg install python3.9

インストール後は、次のパスで実行してください：$PREFIX/usr/bin/python3.9

たとえばpython3 main.pyはpython3.9 main.pyになります。

特定バージョンのPythonパッケージをインストールするには、python3.9 -m pip install <套件名稱>を使います。

異なるバージョンの仮想環境を作成する場合は、python3.9 venv -m venvを使います。

5. pip installのコツ
#

通常、Pythonの外部モジュールを使うには、pip installでパッケージをインストールしてから、Pythonプログラム内でモジュールをimportします。

Pythonパッケージをインストールするとき、Termuxのリポジトリにパッケージ化されたもの（通常はpython-*で始まる）があるなら、pkg installでTermuxリポジトリからインストールします。それで無理ならpip installを使います。

Termux環境はPCのLinux環境と完全には同じではないため、pip installではwheelのコンパイルが必要なパッケージで失敗することがあります。そのためTermux開発者がパッケージ化した版を使うのがおすすめです。

たとえばPillowパッケージはTermuxのリポジトリからインストールできます。

pkg install python-pillow

古いバージョンのPillowが必要な場合だけ、pip installでのインストールを検討します。

pip install pillow==9.5.0

6. VimとPythonプラグインをインストール
#

テキストエディタVimを、Python編集に適した環境にします。

Vimをインストールします。

pkg install vim

Vimの基本操作はネットで検索してください。Termuxは画面上に多くのショートカットキーを表示しており、Vimでの入力操作には十分です。

Vim本体には非常に基本的なコードハイライト機能しかなく、Pythonプログラムの編集には少し物足りないかもしれません。そのためプラグインを入れて機能を補強します。

Vimのプラグインは非常に多いです。どれを入れるべきでしょうか。Real Pythonの VIM and Python – A Match Made in Heaven という記事は、とても詳しく説明していると思います。記事内で触れられているVundleパッケージマネージャーも、Termux環境にインストールできます。

ただしYouCompleteMeの自動補完システムを使うには、いくつかpatchを当てる必要があります。How to install YouCompleteMe on Termux by micjabbourを参照してください。

7. 基本的なPythonコマンドライン実行方法
#

簡単なPythonプログラムを書き、コマンドで実行して結果を出力する方法を紹介します。

Pythonプログラムがファイルへ書き込む必要がある場合、Termuxのパスの書き方を理解する必要があります。Termuxファイル管理を参照してください。

プロジェクトディレクトリを作成し、使用するPythonプログラムを同じディレクトリにまとめることをおすすめします。

mkdir project1

cd project1

（任意）ここでPython仮想環境を作成し、システムパッケージから隔離します。

python3 -m venv venv

source ./venv/bin/activate

Pythonプログラムファイルを作成します。

touch main.py

Vimでそのファイルを編集します。

vim main.py

簡単なHello Worldコードを入力します。

print("Hello World!")

プログラムを実行します。結果が出力されるはずです。

python3 main.py

8. グラフィカルIDEでPythonを書く
#

ここでの操作にはキーボードとマウスを推奨します。

グラフィカルIDEでプログラムを書けば、コマンド入力の手間を省けます。

グラフィカルIDEといえば、多くの人はVS Codeを思い浮かべるでしょう。残念ながら、Termuxにはcode-serverパッケージしかなく、デスクトップ版VS Codeはありません。

Termuxはcode-serverパッケージを提供しており、スマートフォンのブラウザでWeb版VS Codeを動かせます。ただ、どうせグラフィカル画面を使うなら、Termux X11で完全なXサーバーを動かすほうがよいと思います。そうすればVS Codeを開けるだけでなく、PythonプログラムがPyQTでウィンドウを描画することもできます。

Termuxにはデスクトップ版VS Codeが収録されていないため、proot-distro内にVS Codeをインストールしてからグラフィカル画面を起動するのがおすすめです。

9. proot-distro内でPythonを使う際の注意
#

proot-distro loginコマンドを実行すると、Termuxは自身のPATHも一緒にマウントします。そのためpythonコマンドを実行したとき、コンテナ内の版ではなくTermux側の版が実行されることがあります。

どう確認するのでしょうか。which pythonとwhich python3でPythonのパスを確認します。/usr/bin/python3でなければ、Termux側の版を実行しています。

この問題を解決するには、proot-distro内の~/.bashrcに次の内容を追加します。

alias python=/usr/bin/python3
alias python3=/usr/bin/python3
alias pip=/usr/bin/pip
alias pip3=/usr/bin/pip3

TermuxのXFCEデスクトップでproot-distro内のX11 GUIアプリを起動する

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Fri, 11 Apr 2025 01:00:00 +0800

Allow apps in proot-distro to draw windows on XFCE desktop in Termux. Integrate X11 GUI apps in proot-distro with Termux host desktop environment.

デフォルトでは、TermuxのネイティブパッケージでXFCEデスクトップ環境を動かし、X11のネットワーク透過性を使って、proot-distro内のX11プログラムのウィンドウをXFCEデスクトップ上に表示させます。

この画像はTermuxとproot-distro環境が同時に動作している様子を示しています。XFCEデスクトップはTermuxで直接動作し、LibreOfficeはproot-distro内から起動しています

ここでネイティブのXFCEプログラムを動かす側を、ひとまずTermuxホストと呼ぶことにします。proot-distroは自然にコンテナ側です。この流れは以下のようになります。

この使い方は、LinuxデスクトップのコンテナツールDistroboxに少し似ています。Docker内のX11 GUIプログラムをホストのデスクトップに表示できる、というものです。

proot-distro内から直接XFCEを起動すればいいのでは、なぜTermuxのXFCEパッケージを使うのか、と思うかもしれません。

理由は速度です。proot内のプロセスはptraceでエミュレートされるため、Termux向けにネイティブコンパイルされたプログラムよりもそもそも遅くなります。今ではTermuxのパッケージも増えており、Chromiumブラウザまであります（TUR Repoに収録）。そのため今後は、proot-distroでデスクトップ環境を動かして主客転倒させる必要は徐々に減るでしょう。よく使うプログラムの大半をTermuxネイティブ版で実行できるなら、proot-distroを常用する必要はありません。必要な時だけproot-distroを起動し、Debianリポジトリにしかないプログラムを動かせばよいのです。

1. Termuxにデスクトップ環境をインストールする
#

TermuxにXFCE4デスクトップをインストールするを参照してください。グラフィック表示の方法は、Termux X11でもVNCでも構いません。

ここではさらに、XクライアントがXサーバーへ接続する権限を制御するためのパッケージを追加します。

pkg install xorg-xhost

Termuxのデスクトップ環境を起動できるかテストします。

また、XFCEのファイルマネージャーを開き、storage/sharedディレクトリを開けば、Android内部ストレージのファイルを読み込めます。

2. proot-distroを設定する
#

私はproot Debianをインストールしました。

一般ユーザーを追加し、proot-distro内で日本語化を設定することをおすすめします。

Termuxにはlocalesパッケージがなく、日本語のロケールを設定できません。

proot-distro内には、たとえばLibreOfficeのようなGUIプログラムもインストールしておきます。

sudo apt install libreoffice

3. Termuxデスクトップからproot-distro内のプログラムを起動する
#

まずxhostを実行し、proot-distro内のプログラムがTermuxデスクトップのXサーバーにウィンドウを描画できるよう許可します。prootのプロセスはTermux userによって起動されるため、whoamiコマンドで現在のユーザー名を渡し、このユーザーの接続を許可します。

xhost +SI:localuser:$(whoami)

proot-distroにログインします。Xサーバーリソースを共有するため、必ず--shared-tmpを使います。さらに--termux-homeを付けてTermuxのホームディレクトリもマウントします（proot内のプログラムにファイルを散らかされたくない場合は、マウントしなくても構いません）。

proot-distro login debian --user user --shared-tmp --termux-home

DISPLAY環境変数を指定します。値はTermux Xサーバーのアドレスで、通常は:0です。その後、LibreOfficeなどのプログラムを実行します。

export DISPLAY=:0

libreoffice

するとLibreOfficeのウィンドウが起動します。
Termuxデスクトップ上のファイルは、LibreOfficeのウィンドウへ直接ドラッグして開けます。

ただしLibreOfficeからファイル選択ダイアログを開く場合、デフォルトではproot-distro内のディレクトリしか見えません。上でTermuxのホームディレクトリをマウントしているため、proot-distro内のユーザーのホームディレクトリ/homeはTermuxのホームディレクトリと共有された状態になります。

また、/sdcardからAndroid内部ストレージのディレクトリを読み込むこともできます。

4. TermuxデスクトップにGUIショートカットを追加する
#

Desktop Entryにしておけば、手動でproot-distroにログインしてコマンドを打つ必要がなくなります。

XFCEにはDesktop Entryをすばやく作成する方法があります。デスクトップで右クリック → Create Launcher を選びます。

Command欄に以下のコマンドを入力します。Debian prootへログインし、bashでLibreOfficeを起動します。

proot-distro login debian  --shared-tmp -- bash -c "DISPLAY=:1 libreoffice"

アイコンファイルは任意のディレクトリの画像を選べますが、私は元のものを使います。Iconをクリックし、Image Filesを選び、ファイル選択ダイアログでパスに/data/data/com.termux/files/var/lib/proot-distro/installed-rootfs/debian/usr/share/icons/hicolor/を入力します。するとTermux proot-distro内のアイコンファイルを見つけられます。

保存してダブルクリックすれば、LibreOfficeが直接起動します。他のプログラムも同じ要領で設定できます。

VNCでTermuxのLinuxデスクトップへリモート接続する方法

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Thu, 10 Apr 2025 01:00:00 +0800

この記事では、VNCサーバーを設定して、TermuxのLinuxシステムデスクトップへアクセスする方法を説明します。prootまたはchrootでインストールしたLinuxシステムに適用できます。

TermuxはAndroidスマートフォンでLinuxを動かせます。環境を整えた後は、デスクトップ（グラフィカル環境）への接続方法を考える必要があります。TermuxのLinuxシステムデスクトップへ接続するには、Termux X11、XSDL、VNCの3つの方法があります。

前者2つはスマートフォン上でXサーバーを動かす方法です。後者はリモートデスクトップの考え方で、スマートフォン上でVNCサーバーを動かし、仮想Xvncサーバーを起動してから、VNCクライアントで接続します。このVNCクライアントはローカルでも、別のPC上のクライアントでもかまいません。

グラフィック性能でいえば、XサーバーはVNCより優れており、3Dハードウェアアクセラレーションも実現しやすいです。

昔私がTermuxを学び始めた頃は、多くの人がVNCを使っていました。しかしTermux X11が成熟するにつれて、私はVNCを徐々に使わなくなりました。

3つとも同じスマートフォン上で動かす場合、どれもlocalhostなので遅延の問題はありません。VNCはXサーバーに比べ、実際のところ性能面の利点がほとんどありません。

VNCの強みは、別のPCからリモートアクセスできることです。SSH Xサーバーforwardingの方法と比べ、VNCは画質を下げて帯域幅を減らせますし、headlessで起動することもできます。リモートで表示するときに性能上の利点が出てきます。

そのためVNCは「PCからスマートフォンのTermuxデスクトップへ接続する」場面に向いています。小さな画面を見つめながら必死にコマンドを打つのは嫌ですよね。テキストだけのSSHアクセスに加えて、グラフィカルなVNCはよい選択肢です。

VNCとTermux X11の2つの方法は共存できます。おそらく互いに影響しません。

1. VNCクライアントを選ぶ
#

スマートフォンではAVNCまたはRealVNC Viewerをおすすめします。後者は機能が多いですが、プロプライエタリソフトウェアです。

PCではRemminaをおすすめします。

2. VNCサーバーを設定する
#

次のどちらかを選びます。

Termuxで直接VNCサーバーを動かす
#

実際にはproot-distroは不要です。Termux自体がネイティブのVNCサーバーパッケージを提供しています。ただし、proot-distro内のLinuxディストリビューションのデスクトップを開きたい場合は、この方法を使わないでください。

また、Termuxに収録されているデスクトップ環境パッケージはproot-distroほど豊富ではありません。現時点で最も完成度が高いのはXFCEです。

TermuxにXFCEデスクトップをインストールします。ただしTermux X11はインストールしません。
TigerVNCのパッケージをインストールします。執筆時点のバージョンは1.13.0です。

pkg install tigervnc

VNCサーバーのパスワードを設定します。

vncpasswd

VNCサーバー起動後に実行するプログラムを追加します。~/.vnc/xstartupを編集します。

mkdir ~/.vnc/

vim ~/.vnc/xstartup

次の内容を入力します。

#!/bin/bash
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADRESS

# PulseAudio音声サーバーを起動。音声はTermuxから出力される
pulseaudio --start --exit-idle-time=-1
pacmd load-module module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1

# デスクトップ環境を実行。ここではXFCE
exec startxfce4

xstartupに実行権限を付与します。

chmod +x ~/.vnc/xstartup

VNCサーバーの設定ファイルを定義します。~/.vnc/tigervnc.confを編集します。

vim ~/.vnc/tigervnc.conf

次の内容を入力します。

# 現在のセッションはXFCE
$session="xfce-session";
# 解像度。高いほど帯域幅を多く使う
$geometry="1920x1080";
# ビット深度。値は8/16/24/32で、数字が大きいほど画質はよいが帯域幅を消費する
$depth="32";
# 外部ネットワークから接続できるようにする
$localhost="no";

proot-distro内でVNCサーバーを動かす
#

先にDebianなどのTermux proot-distroをインストールしてください。続いてproot-distro内にデスクトップ環境をインストールします。最もリソースを食わないのはXFCEですが、KDE Plasmaを試してもかまいません。

proot-distroにログインし、現在rootではなく一般ユーザーであることを確認します。

whoami

# rootの場合は su "ユーザー名" と入力して一般ユーザーへ切り替える

TigerVNCのパッケージをインストールします。現在のバージョンは1.13.0です。

sudo apt install tigervnc-standalone-server tigervnc-xorg-extension

VNCサーバーのパスワードを設定します。

vncpasswd

VNCサーバー起動後に実行するプログラムを追加します。~/.vnc/xstartupを編集します。

mkdir ~/.vnc/

vim ~/.vnc/xstartup

次の内容を入力します。

#!/bin/bash
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADRESS

# PulseAudio音声サーバーを起動。音声はTermuxから出力される
export PULSE_SERVER=127.0.0.1 && pulseaudio --start --disable-shm=1 --exit-idle-time=-1

# デスクトップ環境を実行。ここではXFCE
exec startxfce4

xstartupに実行権限を付与します。

chmod +x ~/.vnc/xstartup

VNCサーバーの設定ファイルを定義します。~/.vnc/tigervnc.confを編集します。

vim ~/.vnc/tigervnc.conf

次の内容を入力します。

# 現在のセッションはXFCE
$session="xfce-session";
# 解像度。高いほど帯域幅を多く使う
$geometry="1920x1080";
# ビット深度。値は8/16/24/32で、数字が大きいほど画質はよいが帯域幅を消費する
$depth="32";
# 外部ネットワークから接続できるようにする
$localhost="no";

3. VNCサーバーへ接続する
#

Termuxでtigervncserverまたはvncserverコマンドを入力し、VNCサーバーを起動します。画面に出力されるポート番号を確認します。通常は1から始まります。VNCサーバーのポートは5900から数えるため、この場合のポートは5901です。

ローカル接続
#

ローカル接続するには、スマートフォンでAVNCアプリを開き、ホスト接続を追加します。アドレスにlocalhost、ポートに5901を入力します。

AVNCの操作では、左側のボタンをタップしてタッチパッドモードに切り替えるのがおすすめです。Linuxデスクトップの文字が小さすぎる場合は、解像度を下げるか、そのデスクトップ環境の設定でDPIを調整してください。

VNCサーバー接続を終了した後は、Termuxに戻ってサーバーを停止してください。そうしないと、次回起動時に新しいポートで動いてしまいます。

vncserver -kill :1

PCからリモート接続
#

まずスマートフォンとPCを同じWi-Fiネットワークに接続します。

Termuxでsudo apt install net-tools & ifconfigコマンドを実行してスマートフォンのローカルIPを取得し、Wlanの行を確認します。

次にPCのReminnaのアドレス欄をVNCに切り替え、スマートフォンIP:5901を入力して接続します。

Reminnaでは左側のボタンを押して、リモートデスクトップのサイズに合わせられます。入力方式はリモート側のものしか使えませんが、両側のクリップボードは自動で同期されます。

VNCサーバー接続を終了した後は、Termuxに戻ってサーバーを停止してください。そうしないと、次回起動時に新しいポートで動いてしまいます。

vncserver -kill :1

スマホをPCとして使う：iPad + Android Termuxでデスクトップ版Linuxソフトを動かす

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Thu, 21 Nov 2024 21:00:00 +0800

iPad is too limited, Android is too tiny. So why not combine then together?

Android + Termux Proot Debian + KasmVNC + iPadのSafariを使い、デスクトップ版ソフトを動かせるモバイル作業環境を構築します。

iPadでできないことは、Androidスマホにやらせましょう！

Termux Prootを通してAndroidスマホをPCのように使い、Linuxデスクトップソフトを実行し、それをiPadから操作します。

iPadからAndroid上のLinuxコンテナへリモート接続して操作します。iPadでできないことは、Androidスマホにやらせましょう！

Joplinでノート整理

Visual Studio Codeでpygameを起動

タイトルの意味が分からない？私がやりたいのは、こういう利用シーンです。

1. 動機
#

私の現在のモバイル作業環境はAndroidスマホとiPadの組み合わせです。別々のエコシステムではありますが、LocalSendのような自由ソフトウェアのおかげで、両者は案外うまく共存しています。Androidスマホはバッテリー容量が大きいので、iPadに6時間ほどテザリングしても電池切れにはならなさそうです。

これらはすべて、iPadでデスクトップ版ソフトを動かすためです。ソフトによってはデスクトップ版は非常によくできているのに、モバイル版に移植されると一気に貧弱になります。自由ソフトウェアでもプロプライエタリソフトウェアでも同じです。

たとえばノートアプリのJoplin。iPad版JoplinはiPhone版を拡大しただけのようなもので、機能がかなり簡素です。ノートの関係グラフなど、デスクトップ版の機能がまだ多く移植されていません。ノートを扱うときにいつも手足を縛られる感じがあり、多くの作業はPCを開かないと処理できません。そこで、どうやってデスクトップ版Joplinを動かすか考え始めました。

iPadを売ってSurfaceに乗り換える？考えたことはあります。ただ、足に合わない靴に合わせるために足を削るようなことはしたくないので、AndroidスマホのTermuxを使うことにしました。Termuxならroot不要でLinuxデスクトップ環境のコンテナを動かせますし、VNC経由でiPadからアクセスできます。

以前、ScrcpyやRustdeskでAndroidを大画面へミラーリングする方法を紹介しました。しかし、私が必要としているのはAndroid画面全体ではありません。Linuxだけで十分です。VNCサーバーをヘッドレスで動かせば、AndroidのRAMが十分ある限りバックグラウンドで簡単にはkillされません。Linuxプログラムが動いている間も、Androidスマホ自体は普通に使えます。

iPadのネットワークはAndroidから共有しているため、リモートデスクトップのローカル接続の遅延は小さいです。iPadはAndroidのLinuxコンテナ用の画面になります。

選べるなら、Androidスマホの代わりにRaspberry Piを使うべきでしょう。私は以前、Raspberry PiとiPadを組み合わせる使い方について書きました。Raspberry PiはI/Oが比較的揃っており、本体サイズも持ち運びに向いています。ただ、スマホに大容量バッテリーと強力なプロセッサがあるなら、その場で活用しない手はありません。たとえば私のSony Xperia 10 Vの性能はiPad Air 6の3分の1程度ですが、テザリングしても発熱せず、バッテリー持ちも非常に長い。なら少し酷使してLinuxを動かしてみよう、というわけです。

え、それは少し本末転倒ではないか、ですって？iPadはあれほど高性能なのに、ただのリモートデスクトップクライアントとして使い、本来担当すべき重い処理を全部Android側に押し付けるのか？仕方ありません。iOSはiSH Shellを動かすだけでも重く、仮想マシンもなかなか開放されません。だからAndroidが遅くても、動かせるものはiPadより多様で、iPadよりPCらしく使えます。Androidを酷使して電池がなくなったら、今度はiPad側からType-Cで充電すればよいのです。

2. 設定手順
#

ログイン手順を簡単にするため、私はKasmVNCのWeb VNCサーバー方式を採用しました。そのためiPad側にアプリを用意する必要はなく、ブラウザだけでログインできます。

Termux Proot Debianを設定し、XFCEデスクトップをインストールする
ARM64アーキテクチャのKasmVNCパッケージをインストールする
KasmVNCサーバーを起動し、指示に従ってユーザーを追加し、XFCEを使うよう設定する

vncserver

KasmVNCサーバーを起動する

vncserver

テザリングを有効にして、ネットワークをiPadへ共有する
AndroidのローカルIPを取得する

ifconfig

iPadのSafariでhttps://手機區域IP:8444を入力し、アカウントでログインすれば接続できる

3. TermuxのLinuxにソフトウェアをインストールする
#

大半の自由ソフトウェアにはARM64版パッケージがあるので、APTでインストールすればよいです。

Joplinについては、leaguecnがビルドしたdebパッケージを使っています。ちょうど志を同じくする人がいて、その人もAndroidでデスクトップ版Joplinを動かしていました！

ChromiumベースのソフトウェアをProot内で起動するときは、/usr/share/applications/*.desktopのExec==項目を編集し、--no-sandboxパラメータを追加しないと起動できません。Visual Studio Codeも同じです。

iPadOSのAssistiveTouchの白いボタンでタッチパッドをシミュレートできますが、それでもLinuxデスクトップを操作するならBluetoothキーボードを接続することをおすすめします。

KasmVNCではiOSの入力方式を使って中国語を入力できますが、あまり安定しません。そのため私はTermuxコンテナ内にFcitx5入力をインストールしています。

4. まだ解決していない問題
#

Linuxデスクトップの音声をiPadへストリーミングできません。KasmVNCだけでは実現できません。iOSにはPulseAudioサーバーがないため、音はAndroid側のTermuxから出すしかありません。ただ、外出先でむやみに音楽を流すこともないでしょうし、イヤホンを接続すれば解決です。

VNCの描画効率がよくない問題については、KasmVNCはすでに現代的な技術向けに再設計されたサーバーです。少なくともTigerVNCより品質はよいので、あまり高望みはしないことにします。

ここで検討に値する案はあります。iPadでXサーバーを動かし、X11 Forwarding経由でLinuxコンテナの画面を投影する方法です。Termux X11の使い方に似ていますが、リモートになるだけです。ただ、App Storeで唯一のX ServerアプリであるMocha X11は高いんですよね…それに試用版で試したところ、VirGL 3Dアクセラレーションに問題がありました。

Termux-servicesとTermux:Bootで自動起動サービスを管理する

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Mon, 18 Nov 2024 06:00:00 +0800

Manage auto-startup services in Termux.

ここでは2つのTermux拡張機能を紹介します。1つ目はTermux-servicesで、Termuxアプリを起動した後のサービスを管理します。2つ目はTermux:Bootで、Androidの起動後にTermuxのサービスを自動起動するよう設定します。

なぜTermux-servicesが必要なのでしょうか。

Termuxでサービスを起動・停止したい、アプリを開いた後にサービスを自動起動したい。しかしTermuxにはSystemdがありません。自動起動したいサービスを~/.bashrcや~/.profileに書き込み、停止したいときはプロセスを探してkillコマンドで止めるしかないのでしょうか。

こういう時にTermux-servicesは便利なツールになります。

Termux-servicesを使うと、一連のコマンドでサービスの実行を制御でき、自由にサービスを起動・停止できます。常駐プログラム（daemon）を必要とするソフトウェアには特に便利です。たとえばsshd、apache2、bitcoinなどはTermux-services経由で、Termuxアプリを開いた後に自動起動できます。

Termux-servicesは「runit」を使ってシステムサービスを管理します。runitは非常にシンプルなinitサービスマネージャーで、現在これを採用しているLinuxディストリビューションは少数です。runitを使うLinuxディストリビューションといえば、有名なのはArtix LinuxとVoid Linuxあたりでしょう。

まずTermux-serviceの使い方を紹介し、その後でTermux: Bootの使い方を説明します。

1. Termux-servicesの自動起動
#

Termux-servicesパッケージをインストールします。

pkg install termux-services

Termuxは一部のパッケージをインストールする際、runitのサービスファイルも一緒にインストールします。すべてのサービスファイルは$PREFIX/var/service/svにあります。
たとえばopensshパッケージをインストールすると、Termux-servicesはSSHDのサービスファイルを自動で用意します。$PREFIX/var/service/sv/sshd/runはサービス起動後に実行するコマンドを定義し、$PREFIX/var/service/sv/sshd/downはサービス停止後に実行するコマンドを定義します。
SSHDサービスを起動・停止するには、以下のコマンドを使います。

# 起動
sv up sshd

# 停止
sv down sshd

# アプリ起動後に自動起動
sv-enable sshd

# アプリ起動後の自動起動を解除
sv-disable sshd

同じ要領で、Termux起動後に他のプログラムを実行したい場合は、サービスファイルを作成します。スクリプトを書く際はrunit公式のテンプレートを参照してください。ここでは自作スクリプトを実行する例を示します。

# 内容を編集
echo "echo 'Hello world' ">> ~/run.sh
chmod +x ~/run.sh

# サービスファイルを追加
vim $PREFIX/var/service/sv/myscript/run

# 以下を記入：
bash ~/run.sh

# Termuxアプリ起動後に自動起動するよう設定
sv-enable myscript

2. Termux:Bootで起動時に自動起動
#

Termux:Bootは、Androidシステムが起動した後に、あなたが書いたスクリプトを自動で実行します。

実はTermux-serviceと組み合わせなくても使えます。Termux:BootはTermuxを呼び出して任意のコマンドを実行できます。ただ、システムサービスは集中管理した方がよいと思います。つまり構成としては、まずTermux-servicesで実行したいサービスを追加し、その後Termux:BootでTermuxを自動起動します。そうすれば、自分で書いたサービスもすべて一緒に起動します。

Termux: Boot APKをインストールします。
アイコンをタップして一度起動します。これで起動後に自動起動するようになります。
Termuxでディレクトリを作成し、起動時スクリプトを追加します。

mkdir -p ~/.termux/boot/

vim ~/.termux/boot/run.sh

以下の内容を記入し、起動後にrunitのすべての自動起動サービスを実行するよう設定します。

#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
. $PREFIX/etc/profile

Termux-Tutorials on Ivon's Blog

Termux proot-distro使用方法：AndroidスマートフォンにLinuxディストリビューションを入れる

1. proot & proot-distroとは #

2. proot-distroコマンドの使い方 #

3. proot-distroコマンド引数 #

4. proot-distroをバックアップする方法 #

付録：スクリプトでProot Distroを自動インストールする #

Termux：Arch Linuxデスクトップ環境をゼロから構築＋ワンタップ起動スクリプト

1. 事前準備 #

2. Proot Arch Linux基本システムをインストールする #

3. Arch Linuxパッケージリポジトリのミラーを変更する #

4. 一般ユーザーを追加する #

5. デスクトップ環境とよく使うツールをインストールする #

6. タイムゾーン、中国語、入力メソッドを設定する #

7. 手動でデスクトップ環境に入る方法 #

8. ワンタップ起動用デスクトップ環境スクリプトを設定する #

参考資料 #

TermuxでpKVMを使いQEMU仮想マシンを高速化する

1. パッケージをインストールする #

2. TermuxでLinux仮想マシンを作成する #

参考資料 #

Androidに新しく追加されたDebian Linux Terminalは、必ずしもTermuxキラーにはならない

AndroidスマホでPythonを書く：Termux Python開発環境の構築

1. テキストだけか、グラフィカル画面か？ #

2. TermuxでPythonを動かすか、proot-distroで動かすか？ #

3. TermuxにPythonをインストールする方法 #

4. Pythonバージョンを切り替える #

5. pip installのコツ #

6. VimとPythonプラグインをインストール #

7. 基本的なPythonコマンドライン実行方法 #

8. グラフィカルIDEでPythonを書く #

9. proot-distro内でPythonを使う際の注意 #

TermuxのXFCEデスクトップでproot-distro内のX11 GUIアプリを起動する

1. Termuxにデスクトップ環境をインストールする #

2. proot-distroを設定する #

3. Termuxデスクトップからproot-distro内のプログラムを起動する #

4. TermuxデスクトップにGUIショートカットを追加する #

VNCでTermuxのLinuxデスクトップへリモート接続する方法

1. VNCクライアントを選ぶ #

2. VNCサーバーを設定する #

Termuxで直接VNCサーバーを動かす #

proot-distro内でVNCサーバーを動かす #

3. VNCサーバーへ接続する #

ローカル接続 #

PCからリモート接続 #

関連記事 #

スマホをPCとして使う：iPad + Android Termuxでデスクトップ版Linuxソフトを動かす

1. 動機 #

2. 設定手順 #

3. TermuxのLinuxにソフトウェアをインストールする #

4. まだ解決していない問題 #

Termux-servicesとTermux:Bootで自動起動サービスを管理する

1. Termux-servicesの自動起動 #

2. Termux:Bootで起動時に自動起動 #

参考資料 #

1. proot & proot-distroとは
#

2. proot-distroコマンドの使い方
#

3. proot-distroコマンド引数
#

4. proot-distroをバックアップする方法
#

付録：スクリプトでProot Distroを自動インストールする
#

1. 事前準備
#

2. Proot Arch Linux基本システムをインストールする
#

3. Arch Linuxパッケージリポジトリのミラーを変更する
#

4. 一般ユーザーを追加する
#

5. デスクトップ環境とよく使うツールをインストールする
#

6. タイムゾーン、中国語、入力メソッドを設定する
#

7. 手動でデスクトップ環境に入る方法
#

8. ワンタップ起動用デスクトップ環境スクリプトを設定する
#

参考資料
#

1. パッケージをインストールする
#

2. TermuxでLinux仮想マシンを作成する
#

参考資料
#

1. テキストだけか、グラフィカル画面か？
#

2. TermuxでPythonを動かすか、proot-distroで動かすか？
#

3. TermuxにPythonをインストールする方法
#

4. Pythonバージョンを切り替える
#

5. pip installのコツ
#

6. VimとPythonプラグインをインストール
#

7. 基本的なPythonコマンドライン実行方法
#

8. グラフィカルIDEでPythonを書く
#

9. proot-distro内でPythonを使う際の注意
#

1. Termuxにデスクトップ環境をインストールする
#

2. proot-distroを設定する
#

3. Termuxデスクトップからproot-distro内のプログラムを起動する
#

4. TermuxデスクトップにGUIショートカットを追加する
#

1. VNCクライアントを選ぶ
#

2. VNCサーバーを設定する
#

Termuxで直接VNCサーバーを動かす
#

proot-distro内でVNCサーバーを動かす
#

3. VNCサーバーへ接続する
#

ローカル接続
#

PCからリモート接続
#

関連記事
#

1. 動機
#

2. 設定手順
#

3. TermuxのLinuxにソフトウェアをインストールする
#

4. まだ解決していない問題
#

1. Termux-servicesの自動起動
#

2. Termux:Bootで起動時に自動起動
#

参考資料
#