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.0curl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/install.shcurl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/SHA256SUMSsha256sum -c SHA256SUMS # macOS: shasum -a 256 -c SHA256SUMSless install.sh # optional: read itMERIDIAN_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-vpnmeridian updateMeridian 会在交互式命令前定期检查 PyPI，并在有新版本时打印通知。它从不自动安装更新。meridian update 通过安装它的任何包管理器升级，并确认活跃的 meridian 命令报告新版本。设置 MERIDIAN_DISABLE_UPDATE_CHECK=1 在自动化中关闭后台检查。
更新 CLI 对您的服务器上的任何东西都无改变。如果服务器正常工作，没有急迫性；阅读 release notes，然后在准备好时运行相同的 meridian deploy 命令（或 meridian apply）来应用新版本。
从 3.x 升级
Section titled “从 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。
- 用 Meridian 4 部署一个新服务器：
meridian deploy NEW_IP - 为您的用户提供他们的新连接页面（为每个人运行
meridian client add NAME） - 一旦每个人都切换了，用
meridian teardown OLD_IP卸载旧服务器 — Meridian 4 的卸载也会移除 3x-ui
- 用 Meridian 4 部署一个新服务器：
Meridian 4 把自己的状态保存在 ~/.config/meridian/，从不读取或改变 ~/.meridian/ 中的 3.x 状态，因此两个版本可以共存于同一台机器；只找到 3.x 状态的集群命令会改为解释这些选项。
- Python 3.11+（uv 为您安装和管理）
- 对您的服务器的 SSH 访问，以 root 身份或拥有无密码 sudo 的用户身份。最好使用密钥登录；如果服务器只接受密码，
meridian deploy和meridian setup会提示为 Meridian 创建密钥，并用该密码一次性安装它（见仅密码登录的服务器）
终端 QR 码由捆绑的 segno 包渲染；不需要系统依赖。
meridian --version