skip to content
2026-07-10技術系

AlterLinuxの進捗とこれから


お久しぶりです。色々な事情により長らくブログを更新できずにいました。最近の私の個人的な近況とAlterLinuxについて報告しようと思います。

私の近況

現在、私は群馬大学のB4として千田研究室に所属しています。高校生の時から院進するつもりであり、現在はその進路で悩んでいるまっ只中です。どの大学院に進学しようとしているのかは現時点では書きませんが、あまりうまくいっておらず苦戦中という感じです。

研究内容は主にTEE(Trusted Execution Environment)と呼ばれるPETs(Privacy-Enhancing Technologies)の一種で、私が以前より取り組みたかったOSカーネルやさらにそれより下のファームウェアやμ-Archに触れることができて非常に楽しいテーマです。

最近ではAcompanyというTEEを主力としたベンチャーのインターン生としてカーネルモジュールの開発を行ったりしています。SCIS 2026では人生で初めての論文の発表を行うなど学業を楽しんでいます。

同時に、CATENASという前橋の地方創生を行おうとしているベンチャーで、自社サービスのSaaS開発にも貢献しています。最近はLLMの発展が目覚ましいので手でコードをポチポチする機会がめっきり減ってしまいました。

Alter Linuxの進捗

さて、本題のAlter Linuxのお話です。大学受験のために開発を休止してからというもの気がつけば大学卒業というタイミングにまでなってしまい、大変申し訳なく思っています。一応言い訳をしますと、何もしていなかったわけではなく、コツコツと再開の準備を進めておりました。

また、Fascodeのホームページやインフラ等のその他のコードについてもLLMを駆使しながら最新の状態へと更新・リプレースできるように準備を進めている状況です。

今回、ここ数ヶ月の実装によりようやく再開の目処がたったのでその報告をしようと思います。まず、これまでの実装や課題について詳細に説明し、それらを解決するために作成しているものについて紹介していきます。

Alter Linuxのこれまでの問題点

Alter LinuxのPoCの開発を行ったのは確か中学3年生あたりだったと記憶しています。そこから高校3年頃まで開発をしていましたが、これらは非常に大きな課題を抱えていました。主に以下がその内容です。

  • Gitの知識がないままハードフォークして構築されたソースコード
  • 自動化されていないリリース作業
  • 自宅のオンプレミスサーバーでの運用
  • コンピュータサイエンスやセキュリティの基礎知識の欠落による非効率で不完全な実装

これらをそのまま運用し続けるのは不可能でした。この数年間、私はこれらの問題に対する低コストで持続的な開発・運用の手法を考えプライベートの時間にちびちびと実装を行ってきました。

これらの問題について1つずつ詳しく説明します。

ハードフォークによって構築されたコード

2022年頃まで開発をしていたAlterISO 3.1のソースコードがこちらです。このコードはarchiso v43のrelengプロファイルのコードをもとに構築されています。そして、このコードを現在のacrhiso v88に持ち込むのは不可能でした。

そもそも当時のarchiso v43は非常にお粗末なものでした。一切のLinterやFormatterは導入されておらず、x86_64アーキテクチャや多くのファイルパスがハードコードされており、移植性は皆無な代物でした。

このv43までのコードが如何に不完全なものであるかを説明するには現在のarchisoのアーキテクチャを知る必要があります。現在のarchisoはmkarchisoコマンドによって構成されており、インストールするパッケージや設定ファイルはprofileと呼ばれています。 profileはパッケージの一覧やブートローダーの設定ファイルが記載されたテキストファイルの集合体で、mkarchisoコマンドは引数で渡されたprofileをパースすることで設定を読み込み、最終的な成果物(イメージファイルもしくはtarball)を構築します。全てのメタデータはprofiledef.shで定義されており、ここでアーキテクチャやブートローダーを指定します。 これはビルド作業における各外部コマンドの呼び出しと、最終的な成果物に要求される仕様を完全に独立して管理するための合理的な仕様で、ユーザーはmkarchisoコマンドを一切改変することなくprofileを書き換えるだけで、パッケージや設定を好きに設定したイメージファイルを生成できます。

一方で、archiso v43では全く異なった構造をしています。一番の違いはプロファイルという厳密な概念が存在しないことです。relengとbaselineという2つのイメージファイルの設定をプロファイルと呼称していましたが、これは現代のprofiledef.shで定義されたものではなく、mkarchisoによってパースされるものでもありませんでした。 mkarchisoコマンドは存在しているもののそれは全く異なる使い方をされていました。各プロファイルはbuild.shと呼ばれる独自のスクリプトを持っており、このスクリプトがビルドの主体となります。build.shは内部的にmkarchisoを呼び出します。当時のmkarchisoはユーザーが呼び出すビルドの主体ではなく、各build.shが呼び出す共通処理を肩代わりするだけのユーティリティ的な立ち位置でした。

この2つの違いというのはプロファイルの保持しているファイルを見れば一目瞭然です。こちらが最新のrelengで、これが当時のrelengです。

そして、v43のmkarchisoの使い方がこちらです。

usage mkarchiso [options] command <command options>
 general options:
    (省略)
 commands:
   init
      Make base layout and install base group
   install
      Install all specified packages (-p)
   run
      run command specified by -r
   prepare
      build all images
   pkglist
      make a pkglist.txt of packages installed on airootfs
   iso <image name>
      build an iso image from the working dir

今のmkarchisoの使い方は以下です。

usage: mkarchiso [options] <profile_dir>
  options:
    (省略)
  profile_dir:        Directory of the archiso profile to build

そして、AlterISO 3.1はこのarchiso v43に付属していたrelengプロファイルを好き勝手に改造することで実現しています。主な変更点は以下のとおりです。

  • ShellCheckの通過
  • channelと呼ばれる現在のarchiso v88のプロファイルに似た概念の導入
  • 複数アーキテクチャの対応
  • 32bit EFIの対応
  • その他デスクトップOSをビルドするための起動プロセスの改変

これらを全てシェルスクリプトで実装した結果、コードベースは肥大化しました。さらにv43のrelengをまるまるコピーして新たなリポジトリを作成してしまったせいでgit mergeによる自動マージ作業を行えず(そもそもソースコードの構造が全く違う)v43からv46あたりまでは手作業で1行ずつマージしていた記憶があります。

archisoが現在のproriledef.shによる定義に移行した大規模な改修のタイミングで追従する変更が多すぎて力尽きたのを覚えています。1cc7375からe9f209eにかけて更新が入ったのがわかります。 当時多くのデスクトップ環境や日本語/英語の設定ファイルを保持していたAlterISO 3.1はこの大規模な変更に追従できず、更新が終了しました。そこからしばらくの間はarchisoに追従するための様々な試行錯誤を繰り返しては放棄するという作業を繰り返していました。

AlterISO 4.0ではこれまで構築した独自仕様の設定ファイルをarchiso v47に変換しつつ、上流のarchisoに不足している機能をarchisoをフォークして機能追加を行ったarchiso-alterに行わせるという手法を取りました。 しかしこれも独自仕様の多さとシェルスクリプトという言語の限界によって最後まで実装しきることなく放棄してしまいました。これを書いていたのが2023年頃、私が大学1年の頃でした。

次に作成したAlterISO (バージョン名無し)はarchisoへの追従を諦め、全てをGo言語で自前で実装し直すというものでした。結局、これはMBR環境でブート可能なイメージをビルドできる程度までしか完成しませんでした。 archisoというシェルスクリプトで書かれたフラットな構造のものを、うまくGo言語の構造に落とし込むことができず、結局外部コマンドを呼び出すだけで全くGo言語を活用できない汚いコードベースとなってしまいました。これを書いたのが大学2年のときです。

自動化されていないリリース作業 / 自宅のオンプレミスサーバーでの運用

AlterISO 3.1は環境に非常に強く依存した実装となっており、またそのアーキテクチャはCIによる自動ビルドを考慮したものではありませんでした。そのため、リリース時には毎回私が手作業でビルドを行い、SFTPサーバにアップロードしていた記憶があります。

また、この手作業によるビルドはイメージファイルにとどまらず独自に作成した各種パッケージでも同様でした。当時のAlterISO 3.1はAUR上のパッケージのビルドのためにyayに依存しており、yay本体をバイナリリポジトリからダウンロードする必要がありました。

archlinuxcnやchaotic-aurのようなサードパーティリポジトリの存在をよく知らなかった当時の私は、実家で動いていた富士通のスリムデスクトップ上のファイルサーバに、自分の手元のマシンで愚直にmakepkgしたyayを手作業で配置していました。そして上流に更新があるとまた手作業でパッケージを置き換えるというとんでもないことをしていました。

ある程度の自動化をする小さなスクリプトは書いていましたが、それでも更新の自動化はできておらず定期的に私がビルド用スクリプトを叩くという非常に不毛な作業をしていました。さらに、お金のない中学生の私はVPSやEC2のようなマシンを借りることもできず安定したホスティング環境がありませんでした。

根本的な課題の解決

AlterISO 5.0 + Injectable機構

archisoのフォークという課題を最終的に解決したのが現在の実装であるAterISO 5.0です。これはarchisoとAlterLinuxという全く祖先の異なる2つのリポジトリを強引にマージした上で、archisoのソースコードにalteriso/ディレクトリ以下にのみ独自コードを格納するというものです。 マージの際のコンフリクトを最小限に抑えた上で拡張性を最大限に確保するというこれまでの反省を踏まえた上で考えたのが、私が勝手にInjectable機構と読んでいるものです。これはLinuxカーネルのkprobeに近いインターフェースによってmkarchisoコマンドの挙動を動的に改変するものです。

先程このリポジトリではalteriso/ディレクトリ以下にのみ独自コードを格納すると説明しましたが、数少ない例外がmkarchisoの_run_once関数です。archisoでは全ての各ビルドプロセスの関数はこの_run_once関数経由で呼び出されます。この関数の本来の機能は名前の通り、関数が複数回実行されるのを防ぐためのロック機構でしかありません。 しかし、Injectable機構ではこれを大きく改変し、このように関数の挙動を自由に書き換えています。ここで、現代のarchisoのプロファイルにはメタデータの定義のためにprofiledef.shが用いられていることを思い出してください。 公式のarchisoではこれを単に変数定義のためのファイルとして利用していますが、その読み込みの仕方はシンプルなsourceです。つまり、このprofiledef.shには言語仕様的には関数を定義することもできるのです。 Injectable機構はこの仕様を悪用し、_run_onceが呼び出された際にはpre_<関数名>やpost_<関数名>という関数もセットで実行するように改変することでarchiso本体の関数に手を加えないまま任意の処理を任意のタイミングで実行することを可能にしています。

しかし、純粋なInjectable機構だけで全ての独自機能を実装したのでは以前のAlterISO 4.0のときのように言語仕様による煩雑さの増大は解決できませんし、何よりプロファイル開発者がmkarchiso内部まで把握しなければならないという、archiso v47が解決したbuild.shの廃止による関心事の分離という問題を再度復活させただけになります。 これを解決するのがGo言語によるarchisoプロファイルの生成です。Go言語のテンプレート構文を用いてメタプログラミング的な手法をとることで、独自仕様をGo言語の世界で記述し、ビルドプロセスはarchiso上流のコードに任せるという設計を実現しました。これは4.0での失敗とGo言語への完全移植でのいいとこ取りを狙った設計です。

これらは現在非常にうまく動いており、独自仕様のプロファイルをうまくarchiso用に変換しビルドできています。profiledef,shはこのように動的に生成され、loaderによって独自仕様の橋渡しが行われます。

この機構によってarchiso上流のマージを機械的に行うと同時に関心の強い領域の挙動だけを自由に改変することが可能になりました。

Kamisato Project

以前の記事で紹介しましたが、現在の私はArch Linuxのpacmanリポジトリを安価に運用できる既存の方法を知りません。pacmanリポジトリは言ってしまえばhttp(s)でバイナリファイルを配布するだけの簡単なものですが、パッケージビルドやアップデートの自動化等、考えるべきことはたくさんあります。

更に、バイナリファイルはそれなりのサイズなのでCDNを活用する……と考え始めると本当にきりがないです。ということで全部自作しました。

Ayaka

Ayato

デプロイ例

Kamisatoは以前の記事で宣伝した、pacmanパッケージリポジトリの管理を全部行う最強のオレオレサーバーです。Cloudflare R2とCloudflare KVをデータ保存先とし、GitHub Actionsでパッケージの自動更新とビルドを行います。デプロイ先にはGoogle Cloud RunのようなコンテナをデプロイできるCaaSを想定ています。

このクラウドもりもりの最強構成がalterlinux-repoです。クラウドの費用は全部私のお小遣いから支払われています。ちょっと苦しいですが、Cloudflareは無料枠に収まっているので、そんなに高くはないです。

一方でhayao-pacman-repoは少し違う形態でデプロイしています。さくらインターネットのVPSにKamisato Projectのうちの1つであるバックエンドサーバーのAyatoをコンテナで常駐させています。こちらは単体VPSで完結するため仕組みがシンプルである一方で、CDNやCaaSを活用した構成と比較するとスケーラビリティに欠けています。

数年前の私であればこのような大規模なアプリケーションはその開発だけで私のリソースを全部奪ってしまうようなものでしたが、LLMのおかげでこういったものも開発コストを気にせず作成できるようになりました。コードを書くという楽しさが奪われたと感じる一方で、こういうものを個人で作れるというのは別の楽しさが有ります。

今後の課題

Arch Linux 32のi686対応

バイナリの配布場所