Command Palette

Search for a command to run…

ZarynZaryn
はじめかた·1 min read

インストール

zev は単一のプログラムで、ほかに何もインストールする必要はありません。Linux、macOS、Windows で、Intel/AMD(x86-64)と ARM(Apple シリコン、Graviton、Snapdragon)の両方に対応しています。 ## クイックインストール **Linux と macOS** ```bash curl -fsSL https://zaryn.xyz/install.sh | sh ``` Debian、Ubuntu、Fedora、RHEL、openSUSE、Arch では、Zaryn の署名付きパッケージリポジトリを追加して `zev` パッケージをインストールします。以降はシステムの通常のアップデートで zev も最新に保たれます。macOS やその他の Linux では、署名付きの `zev` バイナリを `/usr/local/bin` にインストールします。 **Windows**(PowerShell) ```powershell irm https://zaryn.xyz/install.ps1 | iex ``` `zev.exe` を現在のユーザー用に `%LOCALAPPDATA%\Programs\zev` へインストールし、`PATH` に追加します。管理者権限は不要です。プライベートネットワーク用に、WireGuard の署名付きネットワークドライバー `wintun.dll` も `zev.exe` の隣に配置されます。 確認します: ```bash zev --version ``` ## パッケージマネージャーで 自分で設定したい場合の手順です。インストーラーが行う手順と同じです。 **Debian、Ubuntu**(apt) ```bash sudo curl -fsSLo /usr/share/keyrings/zaryn.gpg https://zaryn.xyz/dl/zaryn.gpg echo "deb [signed-by=/usr/share/keyrings/zaryn.gpg] https://zaryn.xyz/dl/apt stable main" | sudo tee /etc/apt/sources.list.d/zaryn.list sudo apt update && sudo apt install zev ``` **Fedora、RHEL、Rocky、Alma**(dnf) ```bash sudo rpm --import https://zaryn.xyz/dl/zaryn.asc sudo curl -fsSLo /etc/yum.repos.d/zaryn.repo https://zaryn.xyz/dl/rpm/zaryn.repo sudo dnf install zev ``` **openSUSE**(zypper) ```bash sudo rpm --import https://zaryn.xyz/dl/zaryn.asc sudo zypper addrepo https://zaryn.xyz/dl/rpm/zaryn.repo sudo zypper install zev ``` **Arch Linux**(pacman) ```bash curl -fsSL https://zaryn.xyz/dl/zaryn.gpg | sudo pacman-key --add - sudo pacman-key --lsign-key 7C2B21CBA73569E5C83C6A945F2C0C446C4997EB printf '\n[zaryn]\nServer = https://zaryn.xyz/dl/arch/$arch\n' | sudo tee -a /etc/pacman.conf sudo pacman -Sy zev ``` **Windows**(Scoop) ```powershell scoop install https://zaryn.xyz/dl/scoop/zev.json ``` **任意のシステムで手動インストール。** 各リリースは `https://zaryn.xyz/dl/zev/<バージョン>/` にあります。バイナリ(`zev-x86_64-linux`、`zev-aarch64-macos`、`zev-x86_64-windows.exe` など)、アーカイブ、パッケージ、`SHA256SUMS` が含まれます。Linux バイナリは完全な静的リンクなので、Alpine を含むどのディストリビューションでも動きます。 ## アップデート - **パッケージリポジトリからインストールした場合:** zev はシステムのほかの部分と一緒に更新されます(`apt upgrade`、`dnf upgrade`、`zypper update`、`pacman -Syu`、`scoop update`)。 - **バイナリとしてインストールした場合:** `zev self update` を実行します。確認だけなら `zev self update --check` です。 `zev self update` がリリースをインストールするのは、次の条件をすべて満たす場合だけです: - zev 本体に組み込まれた zev のリリース鍵で署名されている; - 署名がそのファイル名とバージョンを正確に指している; - 現在のバージョンより新しい(`--to` でバージョンを指定した場合を除く); - 新しいバイナリが起動する。 zev がパッケージマネージャーから入っている場合、`zev self update` はそれに手を触れず、使うべきコマンドを案内します。 ## ダウンロードの検証 リリースは [minisign](https://jedisct1.github.io/minisign/) で署名されています。Zig が自身のリリースに使っているのと同じ方式です。zev のリリース鍵は次のとおりです: ``` RWQgi1EYwzJgSHlVF5QFI0E4ZaDNfUqL2u9im7SP34VVRCaR60jIUISL ``` ファイルを自分で検証するには: ```bash minisign -Vm zev-x86_64-linux -P RWQgi1EYwzJgSHlVF5QFI0E4ZaDNfUqL2u9im7SP34VVRCaR60jIUISL ``` パッケージリポジトリは、フィンガープリント `7C2B 21CB A735 69E5 C83C 6A94 5F2C 0C44 6C49 97EB` の OpenPGP 鍵(「Zaryn Packages」)で署名されています。パッケージマネージャーはすべてのパッケージをこの鍵で検証し、`install.sh` は鍵を信頼する前に鍵そのものを確認します。 ## アンインストール ```bash zev self uninstall ``` zev がパッケージマネージャーから入っている場合は、代わりに使うコマンド(例: `sudo apt remove zev`)を案内します。リポジトリと `~/.zev` の設定は残ります。プライベートネットワークから抜けるには、先に `zev net down --forget` を実行してください。 ## ソースコードとビルド zev のソースは Zaryn 上の公開リポジトリ [zaryn/zev](https://zaryn.xyz/zaryn/zev) にあります。そこで閲覧するか、zev 自身で取得してください。ビルドに必要なのは Zig コンパイラ(0.17 開発版系列)だけで、zstd はソースに同梱されています。 ```bash curl -fsSL https://zaryn.xyz/install.sh | sh # zev, to fetch its own source zev clone zaryn/zev cd zev zig build -Doptimize=ReleaseSafe ``` バイナリは `zig-out/bin/zev` に作られます。`zig build check-ports` を使うと、どのマシンからでも zev を全配布プラットフォーム向けにビルドできます。 ### サーバー(任意、セルフホスト用) ```bash cd zev-api zig build ``` `zev-api` は、データベース接続やサーバー識別用の鍵ペアなどの設定を環境変数から読み込みます。鍵ペアがなければ初回起動時に生成されます。自前のサーバーが必要なのは、ホスト型のサーバーを使わない場合だけです。