安装

快速安装

curl -sSf https://getmeridian.org/install.sh | bash

此脚本：

如果没有 uv，则安装它，pipx 或 pip 作为后备方案。uv 安装程序按版本固定，并在运行前用 SHA-256 校验。
从 PyPI 安装 meridian-vpn（设置 MERIDIAN_VERSION=4.0.0 可安装某个确切版本）
必要时将工具目录加入您的 shell PATH
仅在无密码 sudo 可用时创建 /usr/local/bin/meridian

验证安装

每个 GitHub 发布版本都附带 install.sh 及其 SHA256SUMS。要在运行脚本前检查它，请从发布页下载两者并校验：

VERSION=4.0.0
curl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/install.sh
curl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/SHA256SUMS
sha256sum -c SHA256SUMS          # macOS: shasum -a 256 -c SHA256SUMS
less install.sh                  # optional: read it
MERIDIAN_VERSION=$VERSION bash install.sh

要检查 getmeridian.org 上的副本，请把 curl -sSf https://getmeridian.org/install.sh | sha256sum 的结果与该发布版本的 SHA256SUMS 对比；只要脚本在该发布之后没有变动，两者就会一致。当最新发布版本是测试版时，网站上的副本默认安装的就是该测试版，仅这一行就会使它的校验和与发布附件不同。

手动安装

使用 uv（推荐）：

uv tool install meridian-vpn

使用 pipx：

pipx install meridian-vpn

更新

meridian update

Meridian 会在交互式命令前定期检查 PyPI，并在有新版本时打印通知。它从不自动安装更新。meridian update 通过安装它的任何包管理器升级，并确认活跃的 meridian 命令报告新版本。设置 MERIDIAN_DISABLE_UPDATE_CHECK=1 在自动化中关闭后台检查。

更新 CLI 对您的服务器上的任何东西都无改变。如果服务器正常工作，没有急迫性；阅读 release notes，然后在准备好时运行相同的 meridian deploy 命令（或 meridian apply）来应用新版本。

从 3.x 升级

Meridian 4 不是就地升级。它用 Remnawave 替换 3x-ui 面板，来自 3.x 服务器的链接无法转移：每个用户需要新链接。

您的 3.x 服务器继续工作。您有两个选择：

继续用 3.x 管理它们。 重新安装 3.x CLI：
```
uv tool install 'meridian-vpn<4'
```
（或 pipx install 'meridian-vpn<4'）。Meridian 3.17.3 及更高版本在您运行 meridian update 时保持在 3.x，除非您传递 --major。
迁移到 Meridian 4。
1. 用 Meridian 4 部署一个新服务器：meridian deploy NEW_IP
2. 为您的用户提供他们的新连接页面（为每个人运行 meridian client add NAME）
3. 一旦每个人都切换了，用 meridian teardown OLD_IP 卸载旧服务器 — Meridian 4 的卸载也会移除 3x-ui

Meridian 4 把自己的状态保存在 ~/.config/meridian/，从不读取或改变 ~/.meridian/ 中的 3.x 状态，因此两个版本可以共存于同一台机器；只找到 3.x 状态的集群命令会改为解释这些选项。

本文档介绍的是 Meridian 4。仍在使用 3.x 的服务器可以参阅保留在 GitHub 上的 Meridian 3.17.3 文档。

需求

Python 3.11+（uv 为您安装和管理）
对您的服务器的 SSH 访问，以 root 身份或拥有无密码 sudo 的用户身份。最好使用密钥登录；如果服务器只接受密码，meridian deploy 和 meridian setup 会提示为 Meridian 创建密钥，并用该密码一次性安装它（见仅密码登录的服务器）

终端 QR 码由捆绑的 segno 包渲染；不需要系统依赖。

验证安装

meridian --version