デスクトップ SSH クライアント · Windows / Linux / macOS

接続・ターミナル・ファイル
をひとつのウィンドウに


LIULI Shell はクロスプラットフォームの SSH クライアントです。
接続管理、インタラクティブなターミナル、SFTP ファイル転送、稼働状態のモニタリング、設定同期を 1 つのデスクトップアプリに統合しました。複数のサーバーを同時に管理する開発者や運用担当者に適しています。

インストーラー版 / ポータブル版 クロスプラットフォームのクラウド同期 FinalShell のバックアップをインポート可能 8 種類の UI テーマ
LIULI Shell のメイン画面:左側にサーバーとモニタリング、中央にターミナルとファイル、右側にサーバー情報とプロセス
セッションマルチタブ SSH と切断後の再接続
ファイルすばやく読み込める SFTP の閲覧・編集
モニタリングリソース、ネットワーク、プロセス
同期公式クラウドサービス / カスタム WebDAV
01 — ダウンロード

用途に合ったインストール方法を選択

Windows 10 / 11 はインストーラー版とポータブル版を用意しています。Linux と macOS はソースからビルドします。インストーラー版とポータブル版の機能は同じです。

インストーラー版とポータブル版

インストーラー版はセットアップウィザードとショートカットを作成します。ポータブル版は解凍するだけで使え、USB メモリや一時的な環境に適しています。

Windows 10 / 11 x64 · Setup.exe / Portable.exe
抽出コード YKXY(リンクに含まれているため入力不要)
夸克网盘を開く ↗
GitHub

GitHub Releases

海外のネットワークからのアクセスに適しており、リリースの添付ファイルとリポジトリのコミットは同期して更新されます。

ソースリポジトリ:github.com/LIULIWANJIA/Liulishell
GitHub Releases へ ↗
Gitee

Gitee Releases

中国国内のネットワークからのアクセスに適しており、ポータブル版の添付ファイルを提供します。リポジトリとリリースは同期しています。

ソースリポジトリ:gitee.com/liuliwanjiaweb/liuli-shell
Gitee Releases へ ↗
ソースからビルド

Linux / macOS

対象システムに依存関係をインストールしてパッケージ化します。deb、AppImage、tar.gz、および macOS の dmg と zip に対応しています。

ビルドコマンドを表示
設定はデフォルトで次の場所に保存されます: %APPDATA%\LIULI Shell。アップグレードや再インストールでも削除されません。別のパソコンに移行する場合は、クラウド同期によるバックアップ、または設定で設定ファイルをエクスポートして移行できます。
02 — クイックビルド

ソースからインストーラーを生成

Linux と macOS ではローカルでのビルドが必要です。以下のコマンドは 1 行ずつ実行してください。まとめて貼り付けないでください。スクリプトはディストリビューションを識別し、依存関係をインストールして、パッケージの種類を確認します。

build.sh — quick start copy & run
Quick Build

Linux / macOS のビルドコマンド

まずソースの取得元(Gitee または GitHub のいずれか一方)を選び、ディレクトリに移動してビルドスクリプトを実行します。
Gitee のデフォルトのクローン先は liuli-shell、GitHub のデフォルトディレクトリは Liulishellです。以下では統一して liuli-shellにクローンし、以降のコマンドもこれに合わせます。

Git が必要です。ステップ 0 で Git をインストールし、ステップ 1 ではソースを 1 つだけ残し、ステップ 2 でビルドスクリプトを実行します。クローンが完了してからビルドコマンドを実行してください。

# 0) Git が必要です。インストール済みなら自動的にスキップ(他のディストリビューションでは dnf / pacman に置き換え)
command -v git >/dev/null || sudo apt-get update && sudo apt-get install -y git

# 1) 古いディレクトリを削除してからソースをクローン(Gitee / GitHub のいずれか)
# Gitee(中国国内推奨、デフォルトディレクトリは liuli-shell)
rm -rf liuli-shell Liulishell && git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub(海外推奨、デフォルトディレクトリは Liulishell。ここでは明示的に liuli-shell を指定)
rm -rf liuli-shell Liulishell && git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell

# 2) プロジェクトに移動してビルド:ディストリビューションを識別 → システム依存関係を補完 → deb / AppImage を選択 → パッケージ化 → インストールを確認
cd liuli-shell && bash scripts/build-linux.sh

成果物は dist/に出力されます。スクリプトは次の中から選択を求めます: 1 = deb / 2 = AppImage / 3 = 両方。一方だけを作る場合は .tar.gz を使用します bash scripts/build-linux.sh tar。スクリプトは Ubuntu 24.04 以降の *t64 パッケージ名のフォールバックを自動的に処理します。CI などの非対話環境では自動インストールされないため、成果物を手動でインストールしてください。環境に問題がある場合は bash scripts/build-linux.sh check で診断できます。Electron のダウンロードが遅い場合、スクリプトは自動的にミラーを切り替えます。

依存関係が不足している場合やビルドに失敗した場合 これらを順番に 1 行ずつ実行してください。通常のビルドでは実行不要です
# 3) 依存関係のインストールに失敗した場合やビルドでエラーが出た場合は、次の順に試す
bash scripts/build-linux.sh repair
bash scripts/build-linux.sh deps
bash scripts/build-linux.sh

基本環境がインストール済みの場合は自動的にスキップされます。Homebrew のインストール中に現在のユーザーのパスワード入力が必要です。クローン後に依存関係をインストールしてパッケージ化します。Intel と Apple Silicon は必要に応じて選択できます。

# 基本環境(インストール済みなら自動的にスキップ。xcode-select はダイアログを表示するので、インストール完了まで待つ)
xcode-select --install 2>/dev/null || true
command -v brew >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Homebrew を新規インストールしたら現在のターミナルの PATH に追加(Intel は /usr/local/bin/brew)
if [ -x /opt/homebrew/bin/brew ]; then eval "$(/opt/homebrew/bin/brew shellenv)"; elif [ -x /usr/local/bin/brew ]; then eval "$(/usr/local/bin/brew shellenv)"; fi
# Node ≥ 18 が必要。未導入またはバージョンが古い場合は 20 をインストールしてから確認
node -v 2>/dev/null | grep -qE '^v(1[89]|[2-9][0-9])' || brew install node@20
brew link --overwrite --force node@20 >/dev/null 2>&1 || true
node -v && npm -v

# 古いディレクトリを削除してからソースをクローン(Gitee / GitHub のいずれか)
rm -rf liuli-shell Liulishell
# Gitee(中国国内推奨、デフォルトディレクトリは liuli-shell)
git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub(海外推奨、デフォルトディレクトリは Liulishell。ここでは明示的に liuli-shell を指定)
git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell
cd liuli-shell npm ci || npm install # 失敗時は自動的に npm install にフォールバック npm run vendor # 中国国内で Electron のダウンロードが遅い場合は、次の 2 行のコメントを解除(任意) # export ELECTRON_MIRROR=https://registry.npmmirror.com/-/binary/electron/ # export ELECTRON_BUILDER_BINARIES_MIRROR=https://registry.npmmirror.com/-/binary/electron-builder-binaries/ npm run dist:mac # x64 + arm64 をまとめて出力 npx electron-builder --mac dmg zip --arm64 # Apple Silicon のみ

成果物は dist/(.dmg / .zip)。npm run vendor xterm のリソースを次の場所にコピーします: src/renderer/vendor。パッケージ化の前に必ず実行してください。Intel と Apple Silicon の成果物は混在できません。署名のないアプリが Gatekeeper にブロックされた場合は、右クリックで「開く」を選んで許可します。

中国国内のネットワークでは Gitee を推奨します。Electron のダウンロードが遅い場合はミラー変数を設定してください。

03 — データ移行

FinalShell バックアップのインポート対応

FinalShell がエクスポートした JSON ファイル、または設定フォルダー全体をインポートできます。インポート時には接続情報を読み取り、グループ階層を再構築し、書き込み前に統計を表示します。

  • 2 種類の取得元複数の JSON を一度に選択することも、設定フォルダー全体を選択することもできます。
  • 階層の復元元のディレクトリ構造に従って最大 3 階層のグループを作成し、それより深いディレクトリは対応する 1 階層目のグループに自動的にまとめます。
  • パスワードの扱い復号後、本ソフトウェアの暗号化方式で再保存します。復号できない項目は空欄にし、明確に通知します。
  • 安全な書き込みインポート前に作成されるグループと接続の数をプレビューし、重複項目は自動的にスキップします。失敗しても既存の設定には影響しません。
FinalShell 設定のインポート · LIULI Shell

FinalShell 設定のインポート

ファイルをドラッグするだけで、複数の JSON または設定フォルダー全体を選択できます。

JSON ファイルまたはフォルダーをドロップ 下のボタンから選択することもできます
JSON ファイルを選択 フォルダーを選択
予定: 2 個の新しい 1 階層目グループ 3 個の新しい 2 階層目グループ 1 個の新しい 3 階層目グループ 合計 14 個のサーバー設定
自動:FinalShell インポート(JSON を直接指定)

フォルダーは階層に従って自動的にグループを作成します(最大 3 階層)。3 階層より深いフォルダー内の JSON は、保存先グループに関係なく対応する 1 階層目のグループにまとめます。

インポートを開始 インポート完了:14 件追加、重複 2 件をスキップ · 新規グループ:1 階層目 2 / 2 階層目 3 / 3 階層目 1
1取得元を選択 1 つまたは複数の FinalShell JSON を選択するか、設定フォルダー全体を選択します。
2計画を確認 作成されるグループ階層と接続数を自動的に集計し、確認してから書き込みます。
3インポートを完了 重複を除いて書き込み、一覧を更新します。新しいグループはデフォルトで折りたたまれ、現在の作業を妨げません。
04 — コミュニティとフィードバック

サポートとリリース情報の入手

利用上の質問、機能の提案、バージョンの最新情報はグループで共有されます。よく使うプラットフォームに参加してください。

QQ グループ · 中国国内

QQ グループ

中国国内のユーザーは QQ グループで問題の報告や設定、利用経験の共有ができます。

1127112572
QQ グループに参加 ↗
Telegram · 海外

TG グループ

海外のユーザーは Telegram グループで同じ通知とディスカッションを得られます。

t.me/liulishell
TG グループを開く ↗
05 — 主要機能

日常の運用をカバーする 9 つのモジュール

サーバーへの接続からファイル転送、状態確認、設定の移行まで、主な操作はクライアント内で完結します。以下で各モジュールの内容を説明します。

01
▤

サーバー管理

グループでサーバーを整理し、複数選択、ドラッグでの移動、設定のコピーに対応します。削除した接続は 30 日間のゴミ箱に入り、いつでも復元できます。

02
❯_

ターミナルセッション

各タブは独立した SSH セッションで、コマンド履歴、クイック入力、切断後の再接続、タブのドラッグによる並べ替えに対応します。プロキシ接続にはステータス表示が付きます。

03
▥

ファイル管理

SFTP のディレクトリツリーとファイル一覧が連動し、ターミナルでディレクトリを切り替えると自動的に追従します。アップロード、ダウンロード、権限の変更、内蔵テキストエディタに対応します。

04
◎

リアルタイムモニタリング

CPU、メモリ、Swap、ディスク、ネットワーク、プロセスを継続的に収集します。グラフのレンジは自動的に調整され、異常な負荷をその場で特定できます。

05
⇅

転送センター

ダウンロードタスクは独立したウィンドウで管理し、一時停止、キャンセル、クリアが可能です。進捗、速度、タスクの状態をリアルタイムに表示します。

06
☁

クラウド同期

公式クラウドサービスとカスタム WebDAV に対応し、サーバー設定、グループ、お気に入りを暗号化して同期し、複数デバイス間で双方向にマージします。手動での同期やバックアップも可能です。

07
⇄

設定の移行

FinalShell の JSON バックアップまたは設定ディレクトリ全体を読み取り、元の階層でグループを再構築します。インポート前にプレビューし、重複項目は自動的にスキップします。

08
◐

外観と操作

ライトとダークのテーマを 8 種類内蔵し、フォント、サイズ、画面の拡大率、マウス操作、ショートカットを調整でき、自動的に保存されます。

09
⌁

ネットワークプロキシ

接続ごとまたはグローバルに HTTP / SOCKS5 プロキシを設定できます。デフォルトプロキシと直接接続へのフォールバックに対応し、社内ネットワークや制限されたネットワークに適しています。

06 — スニペット

よく使うコマンドをワンクリックで

頻繁に使うコマンドをセクションごとに整理し、ターミナルで長いコマンドを何度も入力する手間を減らします。変更が必要なときはコマンドエディタで編集できます。

Snippets & Command Editor

セクションごとに整理し、繰り返しの入力をなくす

よく使うもの、Docker、ネットワークなどのセクションを分けて管理します。ボタンには名前だけを表示して画面をすっきり保ち、セクションとコマンドはどちらもドラッグで並べ替えできます。

  • 実行方法シングルクリックで直接実行するか、コマンド欄に入力してから確認するように設定できます。
  • コマンドエディタ複数行のスクリプトは右側で編集し、Ctrl + Enter で現在のセッションに送信します。
  • 履歴とセッションコマンド履歴と現在のセッションを切り替え、前回の入力をすばやく呼び出します。
スニペットSNIPPETS
よく使うDockerネットワーク+
ディスクを確認メモリを確認プロセスを確認画面をクリア
コマンドエディタ Ctrl + Enter
1docker compose pull
2docker compose up -d
3docker compose ps
07 — リアルタイムモニタリング

リソース、ネットワーク、プロセスを 1 画面で把握

接続後に稼働状態を自動的に収集します。異常な負荷はまずクライアント内で特定し、その後ターミナルで対応するか判断します。

サーバーモニタリングLIVE · 2s
CPU64%
メモリ62%
Swap14%
下り1.36 Mbps
上り0.21 Mbps
プロセスプレビュー CPU 順
nginx12.5%340 MB
worker-112.0%17.6 MB
worker-211.7%20.1 MB
worker-311.4%22.7 MB
Monitor & Processes

サーバーにログインせずに状態を確認

左側にリソースの概要、右側にネットワーク速度とプロセスの使用状況を表示します。更新間隔と速度の単位は設定で調整できます。

  • リソース概要CPU、メモリ、Swap、ディスクパーティションの使用率を表示し、グラフのレンジは自動的に調整されます。
  • ネットワーク速度リアルタイムの下り / 上りと累計トラフィックを同じ画面で確認でき、単位を切り替えられます。
  • プロセスプレビューCPU またはメモリで並べ替え、負荷の高いプロセスをすばやく特定できます。
08 — データとセキュリティ

設定はローカルに保存され、変更はバックアップされます

接続の認証情報、設定のバックアップ、削除からの復元はすべてクライアント内で完結し、外部サービスや手作業への依存を減らします。

Local Data & Security

パスワードは暗号化して保存、誤削除も復元可能

接続の認証情報は暗号化された文字列のみを保存し、画面に平文を表示しません。設定の書き込み前に自動的にバックアップし、誤って削除したサーバーとグループはゴミ箱に入ります。

  • 認証情報の保護パスワードと鍵は本機の鍵で暗号化し、設定のエクスポート時にさらにパスワードを設定できます。
  • 自動バックアップ書き込み前にバックアップを作成し、設定ファイルに異常があった場合は直近の状態に復元できます。
  • ゴミ箱削除したサーバーとグループは 30 日間保持され、いつでも復元できます。
データとセキュリティLOCAL
✓
認証情報を暗号化して保存パスワードと鍵は暗号化された文字列のみを保存し、画面に平文を表示しません。
✓
書き込み前に自動バックアップ設定ファイルが壊れた場合は直近のバックアップに復元できます。
✓
30 日間のゴミ箱誤って削除したサーバーとグループをいつでも復元できます。
✓
暗号化エクスポート / インポート別のパソコンへの移行時に、パスワード付きで設定ファイルをエクスポートできます。
09 — 画面構成

メイン画面は左・中央・右の 3 カラム

3 つのカラムの幅はドラッグで調整でき、必要に応じて非表示にできます。上部はセッションタブとウィンドウ操作、下部のステータスバーは現在の接続数を表示します。

左 サーバーとモニタリング。グループ一覧、検索、接続状態、および CPU、メモリ、Swap、ディスクの概要。
中央 作業エリア。SSH ターミナル、コマンド入力、ファイルマネージャー、スニペットパネル。
右 接続の詳細。サーバー情報、ネットワーク速度、プロセス一覧、コマンドエディタ。
右カラムを閉じたターミナル作業エリア
ターミナル作業エリア右カラムを閉じてターミナルを広く表示
ソフトウェア設定センター
設定センターテーマ、フォント、拡大率、データのオプション
スニペットパネル
スニペットセクションごとに整理し、そのまま実行
多言語

8 言語のインターフェースと公式サイト

クライアントのインターフェースと本サイトは、簡体字中国語、繁体字中国語、英語、ロシア語、フランス語、ドイツ語、日本語、韓国語に対応しています。言語を切り替えるとページの URL と hreflang の表記も連動して変わり、どの言語も同じ機能とスクリーンショットに対応しています。

简体中文Chinese (Simplified) · zh-CN
繁體中文Chinese (Traditional) · zh-Hant
EnglishEnglish · en
日本語Japanese · ja
한국어Korean · ko
РусскийRussian · ru
FrançaisFrench · fr
DeutschGerman · de
10 — 設定とテーマ

自分の作業スタイルに合わせて調整

設定項目は用途ごとにグループ化され、変更はすぐに反映され自動保存されます。以下はよく使う 6 つのグループです。

LIULI Shell · 設定センター
LIULI Shell 設定センター
左側のメニューは用途ごとにグループ化され、右側は現在のカテゴリの項目です。下部からデフォルト設定に戻せます。

外観とテーマ

  • 8 種類の配色で、ターミナルの背景と ANSI カラーパレットが連動して切り替わります
  • 3 カラムの幅と下部の高さはドラッグで調整でき、記憶されます
  • 不要なパネルは個別に非表示にできます

フォントと拡大率

  • 日本語・英語のフォント、サイズ、行間を個別に設定
  • 画面の拡大率 100 / 125 / 150 / 200%
  • 拡大率の変更には確認が必要です。Ctrl+Shift+0 でリセットできます

マウスとショートカット

  • 中ボタンと右ボタンのターミナルでの動作を調整できます
  • グローバルショートカットは変更でき、競合時にはすぐに通知されます
  • スニペットはドラッグで並べ替えできます

スニペット

  • よく使うコマンドをセクションごとに整理
  • 操作エリアは先頭の行に固定され、セクションが収まらない場合は自動的に行が増えます
  • シングルクリックまたはダブルクリックでの実行に対応

同期とプロキシ

  • WebDAV のアドレス、アカウント、認証情報を個別に保存
  • 設定、グループ、お気に入りを双方向にマージ
  • HTTP / SOCKS5 プロキシに対応し、デフォルトプロキシを指定可能

データとセキュリティ

  • 設定の書き込み前に自動バックアップし、異常時には復元可能
  • パスワードと鍵は暗号化された文字列のみを保存し、画面に平文を表示しない
  • データの消去には再確認とカウントダウンが必要
Themes

8 種類のテーマ配色

ライト 6 種類、ダーク 2 種類。切り替えると画面、ターミナルの背景、ANSI 配色が連動して変わります。

ウォームホワイト · 深緑デフォルト · 低コントラストで目にやさしい
ミストブルー · インディゴ爽やかな寒色
ベージュ · テラコッタ温かみのある紙のような質感
グラファイト · クールグレーニュートラルで高コントラスト
ナイト · ディープインクダークな画面
ロータスピンク · ベリーパープル柔らかな暖かい紫
セラドン · パイングリーン淡く上品な青緑
ディープシー · インディゴブルー暗めのブルートーン
11 — 上級リファレンス

手動ビルドとトラブルシューティング

ビルドの流れを手動で制御する場合、ディストリビューションごとに依存関係を用意する場合、パッケージ化のエラーを調べる場合は、以下の詳細なリファレンスを展開してください。

Linux / macOS の完全ビルドガイド 各ディストリビューションの依存関係コマンド、AppImage / deb / dmg のパッケージ化、デスクトップアイコン、FUSE の扱い、よくあるエラーの対照表を含みます。 ▾

Linux x64(AppImage / .deb / tar.gz)

ディストリビューションによってシステムライブラリのパッケージ名が異なり、Ubuntu 24.04 以降は *t64に変更されました。3 種類の成果物の用途:AppImage はインストール不要、deb はパッケージ管理、tar.gz は解凍するだけで使え FUSE に依存しません。

互換性のポイント:AppImage は glibc がビルド環境より古くないシステムでのみ実行できます。20.04 ~ 26.04 で共通に使うには、最も古い Ubuntu 20.04 でビルドしてください。リポジトリ内の scripts/build-linux.sh はディストリビューションを自動的に識別し、t64 パッケージ名へのフォールバックを処理します。
依存関係を手動でインストールしたくない場合:bash scripts/build-linux.sh 1 つのコマンドで「ディストリビューションの識別 → システム依存関係の補完 → パッケージ種別の選択 → パッケージ化 → インストールの確認」を実行し、apt / dnf / pacman に対応しています。依存関係のインストールだけなら ... deps、診断だけなら ... check、環境が壊れた場合は ... repairを使用します。インストール段階:deb は apt install を実行してデスクトップアイコンを作成し、AppImage は ~/Applications/LIULI-Shell にコピーしてアプリメニューとデスクトップアイコンを生成します。

実行とインストール

chmod +x dist/LIULI-Shell-*-x86_64.AppImage
./dist/LIULI-Shell-*-x86_64.AppImage

# Debian / Ubuntu で deb をインストール
sudo apt install ./dist/LIULI-Shell-*_amd64.deb

# 解凍してすぐ使える(FUSE 不要、システムディレクトリにも書き込まない)
mkdir -p ~/Applications
tar -xzf dist/LIULI-Shell-*-x86_64.tar.gz -C ~/Applications
~/Applications/LIULI-Shell-*/liulishell

AppImage の実行時エラー dlopen(): error loading libfuse.so.2

AppImage は type-2 ランタイムを使用するため、システムの FUSE 2 が必要です。Ubuntu 22.04 以前は標準で含まれていますが、24.04 / 26.04 では手動でインストールする必要があります。FUSE をインストールしなくても一時的に展開して実行できます。

# Ubuntu 24.04 / 26.04
sudo apt install -y libfuse2t64
# Ubuntu 20.04 / 22.04、Debian 12
sudo apt install -y libfuse2

# FUSE をインストールせずに直接実行(起動はやや遅いが機能は同じ)
./LIULI-Shell-*-x86_64.AppImage --appimage-extract-and-run

# または tar.gz 版を使えば FUSE にまったく依存しない
アプリ一覧のアイコン / デスクトップアイコンを追加(AppImage)
# 1) 固定の場所に配置
mkdir -p ~/Applications
cp dist/LIULI-Shell-*-x86_64.AppImage ~/Applications/LIULI-Shell.AppImage
chmod +x ~/Applications/LIULI-Shell.AppImage

# 2) アイコンを取り出す(--appimage-extract はカレントディレクトリに squashfs-root を展開)
cd /tmp && ~/Applications/LIULI-Shell.AppImage --appimage-extract '*.png' >/dev/null 2>&1
mkdir -p ~/.local/share/icons/hicolor/512x512/apps
cp /tmp/squashfs-root/*.png ~/.local/share/icons/hicolor/512x512/apps/liulishell.png 2>/dev/null \
  || cp /tmp/squashfs-root/liulishell.png ~/.local/share/icons/hicolor/512x512/apps/ 2>/dev/null

# 3) アプリ一覧の項目を書き込む($HOME は現在のユーザーディレクトリに展開)
mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/LiuliShell.desktop <<EOF
[Desktop Entry]
Type=Application
Name=LIULI Shell
Comment=クロスプラットフォームの SSH ターミナルとサーバー管理ツール
Exec=$HOME/Applications/LIULI-Shell.AppImage %U
Icon=liulishell
Terminal=false
Categories=Development;System;Network;
StartupWMClass=LiuliShell
EOF
chmod +x ~/.local/share/applications/LiuliShell.desktop
update-desktop-database ~/.local/share/applications 2>/dev/null || true

# 4) デスクトップアイコンが必要な場合は、もう一度コピーして信頼済みに設定
cp ~/.local/share/applications/LiuliShell.desktop ~/Desktop/
gio set ~/Desktop/LiuliShell.desktop metadata::trusted true 2>/dev/null || true
# 日本語環境ではデスクトップディレクトリ名が異なる場合があるため、環境に合わせて置き換える

.deb をインストールしたユーザーはこれらの手順は不要です。deb のインストール時に自動的に書き込まれ /usr/share/applications、アプリ一覧にそのまま表示されます。

macOS(dmg + zip、x64 / arm64)

動作要件:macOS 12 以降(Intel または Apple Silicon)、Xcode Command Line Tools、Homebrew、Git、Node.js 20/22 LTS。dmg は Windows / Linux 上ではビルドできません。

1. 基本ツール(xcode-select はダイアログを表示するので、インストール完了まで待ってから続行)

xcode-select --install
/bin/bash -c "$(curl -fsSL \
  https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Apple Silicon では brew を PATH に追加(Intel は /usr/local/bin/brew。再実行しても重複して追加されない)
grep -qsF 'brew shellenv' ~/.zshrc || echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

2. Node 20 と Git

brew install node@20 git
brew link --overwrite --force node@20
node -v && npm -v          # 期待される出力:v20.x

3. ソースと依存関係(古いディレクトリを先に削除し、残留ファイルによる不具合を避けます。Gitee / GitHub のいずれか。Gitee のデフォルトディレクトリは liuli-shell、GitHub のデフォルトディレクトリは Liulishellです。ここでは統一して明示的に liuli-shellにクローンします)

rm -rf liuli-shell Liulishell
# Gitee(中国国内推奨)
git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub(海外推奨。次の行のコメントを解除し、上の Gitee の行をコメントアウト)
# git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell
cd liuli-shell
npm ci || npm install      # ロックファイルとプラットフォームが一致しない場合は npm install にフォールバック
npm run vendor             # xterm リソースを src/renderer/vendor にコピー。パッケージ化の前に必須

4. パッケージ化(現在のアーキテクチャだけなら最速。両方必要な場合は dist:macを指定)

npm run dist:mac                              # x64 + arm64 をまとめて出力
npx electron-builder --mac dmg zip --arm64    # Apple Silicon のみ
npx electron-builder --mac dmg zip --x64      # Intel のみ

5. 成果物とキャッシュ:成果物は ~/liuli-shell/dist/(*.dmg、*.zip);Electron とパッケージツールのダウンロードキャッシュは ~/Library/Caches/electron/、~/Library/Caches/electron-builder/にあり、削除すると強制的に再ダウンロードできます。

6. 署名なしインストール:「アプリケーション」にドラッグした後 Gatekeeper にブロックされた場合は、右クリックで「開く」を選んで許可するか、次を実行します:

xattr -dr com.apple.quarantine "/Applications/LIULI Shell.app"
spctl --assess --type execute -vv "/Applications/LIULI Shell.app"   # ブロックされた理由を確認

外部に配布するには Apple Developer ID 証明書と notarize が必要です。次を設定します: CSC_LINK(.p12 のパスまたは base64)、CSC_KEY_PASSWORD;公証にはさらに APPLE_ID、APPLE_APP_SPECIFIC_PASSWORD、APPLE_TEAM_IDが必要で、electron-builder が署名と公証を自動的に行います。

Intel と Apple Silicon の成果物に互換性はありません。1 つのパッケージで両方のマシンに対応するには npx electron-builder --mac dmg --universalを使用します(サイズは単一アーキテクチャの約 2 倍で、ビルドも明らかに遅くなります)。

よくあるエラー対照表

エラー / 症状原因と対処
パッケージ libasound2 が見つからない Ubuntu 24.04 / Debian 13 以降でシステムライブラリが一斉に改名され *t64(例: libasound2t64、libgtk-3-0t64)。まず旧名でインストールし、失敗時は自動的にフォールバック:bash scripts/build-linux.sh deps にはこのロジックが組み込まれています。
dlopen(): error loading libfuse.so.2 AppImage の実行には FUSE 2 が必要です。24.04 以降では libfuse2t64を、22.04 以前では libfuse2をインストールします。FUSE をインストールしない場合は --appimage-extract-and-runを使うか、 .tar.gzに切り替えてください。
Electron のダウンロードがタイムアウト / downloading で止まる ミラーを設定して再試行:export ELECTRON_MIRROR=https://registry.npmmirror.com/-/binary/electron/、export ELECTRON_BUILDER_BINARIES_MIRROR=https://registry.npmmirror.com/-/binary/electron-builder-binaries/。
npm ci が失敗 / ロックファイルとプラットフォームが一致しない 次のファイルを削除し、 node_modules に切り替えてください npm install。Node のバージョンが古い(< 18)場合はインストールできないため、Node 20 を使用してください。
rpmbuild not found rpm を作るときだけ必要です。Fedora では rpm-buildを、Debian/Ubuntu では rpm と rpm2cpio 関連のパッケージをインストールするか、rpm ターゲットをスキップしてください。
Permission denied(AppImage の実行時) 実行権限がありません:chmod +x dist/LIULI-Shell-*-x86_64.AppImage。
errSecInternalComponent / 署名に失敗(macOS) keychain がロックされています:security unlock-keychain -p <パスワード> ~/Library/Keychains/login.keychain-db を実行してから再実行してください。CI ではさらに security set-key-partition-listが必要です。

共通の注意事項

  • ビルドディレクトリ:すべての成果物はデフォルトでプロジェクトルートの dist/に出力されます。Linux では LIULI-Shell-*-x86_64 / *-arm64 の .AppImage / .deb / .tar.gz(スクリプトがアーキテクチャを自動識別)、macOS では .dmg / .zip。
  • パッケージ化の前に必須:npm run vendor は xterm.js などのフロントエンドリソースを src/renderer/vendor/にコピーします。この手順がないと、パッケージ化したターミナルが空白になります。
  • ビルド環境の選択:AppImage は glibc がビルド環境より古くないシステムでのみ動作します。20.04 ~ 26.04 で共通に使うには、最も古い Ubuntu 20.04 でビルドしてください。自分専用ならローカルでのビルドが最速です。
  • クロスビルド:Linux パッケージは Linux で、macOS パッケージは macOS でビルドする必要があり、成果物に互換性はありません。Windows パッケージも同様です。対応する OS の CI(例: ubuntu-22.04、macos-14 runner)でビルドすることを推奨します。
  • リリース: dist/ にある各プラットフォーム向けのインストーラーとポータブル版を Release の添付ファイルとしてアップロードしてください(Windows の *.blockmap は差分更新専用のため、アップロードする必要はありません);ソースリポジトリには node_modules/ と dist/をコミットしないでください。