---
title: "安装"
description: "在 Mac 上安装 Removent，为首次会话做好准备。"
---

> Documentation Index
> Fetch the complete documentation index at: https://removent.pwp.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

## 系统要求

- macOS 26 Tahoe 或更新版本。
- Apple 芯片 Mac（arm64）。
- 原生连接需要另一台运行 Removent 的 Mac，两端在可达的局域网中，或已配置私有中继。
- VNC 或 RDP 连接需要已有的可达服务端，并使用受支持的身份验证方式。

## 从发布版本安装

打开 [GitHub Releases](https://github.com/backrunner/removent/releases)，选择最新已发布的 macOS arm64 DMG。可用版本与准确文件名以发布页为准。

打开 DMG，双击 **Removent.app → 安装并打开**，或将应用拖到 **Applications（应用程序）**。正式分发构建使用 Developer ID 签名与公证，本地临时签名包用于开发。

手动替换应用前，请退出主应用和菜单栏应用，并停止后台服务。安装器会拒绝替换正在运行的代码。已有安装建议使用应用内更新。

## 通过终端或 SSH 安装

[安装脚本](https://raw.githubusercontent.com/backrunner/removent/main/scripts/install.sh)可通过 GitHub 公开访问，链接对应 `main` 分支已推送的内容。脚本推送到 `main` 后，用户无需克隆仓库即可下载使用。

在目标 Mac 的终端中安装最新稳定版：

```bash
curl -fsSL https://raw.githubusercontent.com/backrunner/removent/main/scripts/install.sh | bash
```

也可以从另一台电脑通过 SSH 安装到该 Mac 用户的应用程序目录，并启用后台服务登录自启（替换 `user@mac`）：

```bash
ssh user@mac 'curl -fsSL https://raw.githubusercontent.com/backrunner/removent/main/scripts/install.sh | bash -s -- --app-dir "$HOME/Applications" --login'
```

新安装默认启动 daemon 并启用用户登录自启，之后手动关闭或停止的选择会保留。`--login` 显式启用登录自启，`--start` 只启动而不改变登录偏好，`--no-login` 仅安装并关闭登录自启。可用 `--version v0.1.4` 指定已发布版本，或用 `--verify-only` 只下载并验证。以目标 Mac 用户运行，不要给整个脚本加 sudo；安装到 `/Applications` 可能需要管理员授权，`--app-dir "$HOME/Applications"` 使用用户自己的目录。

脚本在替换前验证 SHA-256、组件签名和 Gatekeeper，并保留旧应用以便失败时回滚。升级前须退出主应用和菜单栏应用，并结束远程会话。原本运行的 daemon 会更新后重新启动；手动停止的服务保持停止，除非明确要求启动。数据、共享设置和登录偏好会保留。

启动或更新正在运行的 daemon 要求 SSH 用户已有已登录的图形会话。首次屏幕录制和辅助功能授权仍需在 Mac 的系统设置中完成；安装应用不会自动授予这些权限，也不会让已注销的桌面可供远程控制。

## 首次启动

从应用程序目录打开 Removent。如需共享这台 Mac，在菜单栏选择**设置屏幕共享权限…**。授予屏幕录制和辅助功能权限，然后重启后台服务。

接下来[配置权限](/docs/permissions)，然后[连接你的 Mac](/docs/connecting)。

## 更新

Removent 在启动后及之后定期检查更新，可在设置中关闭自动检查。检测到新版本时只会提示，安装需要由你主动发起。

更新器会验证清单中的 SHA-256 和 Ed25519 签名，再替换应用，并保留旧版本以便回滚。更新源使用 GitHub 最新稳定版，不提供预发布版本。

## 自行构建

如果发布页没有满足需求的版本，请参阅[从源码构建](/docs/building)。源码构建需要 Xcode 和 Rust 工具链。

Source: https://removent.pwp.sh/docs/zh/installation/
