文档导航
安装与更新
从官网下载榕树桌面端、完成安装、被系统拦下时怎么放行，以及自动更新与强制更新的说明。
最后更新 2026年9月24日
一句话
这一页讲怎么把榕树装到电脑上、被系统拦下时怎么放行、以后怎么升级。给第一次安装榕树、或升级时被系统提示拦住的用户看。
在哪打开
安装不在应用里操作，请到官网下载页 https://www.banyan.run/download 取安装包。下载页按平台给出安装包，macOS 还会区分 Apple 芯片与 Intel。
装好之后的两个入口：升级提示出现在窗口底部居中的更新横幅上；「检查更新」按钮在 左侧导航底部 → 设置 → 关于 里。
主要动作
- 下载安装包：打开官网下载页，按系统选 Windows / macOS / Linux 版本，页面会按当前系统给出建议的包。系统要求为 macOS 12 或更高版本、Windows 10 或更高版本、64 位 Linux（AppImage / deb）。
- 安装：macOS 打开 .dmg，把「榕树」拖进「应用程序」；Windows 运行下载的 .exe 完成安装；Linux 的 AppImage 赋予可执行权限后直接运行（chmod +x），deb 用系统包管理器安装。
- 被系统拦下时放行：macOS 到 系统设置 → 隐私与安全性 点「仍要打开」，再双击确认一次；Windows 被 SmartScreen 拦下时点「更多信息」→「仍要运行」。原因是本版本未做 Apple 公证、也未做 Windows 代码签名。
- 首次启动接受协议：滚动读完协议后勾选「我已阅读并同意以上条款」，点「开始使用」进入主界面。
- 自动更新：发现新版本后自动下载，完成后横幅提示「重启后即可完成安装」，点「重启安装」即可。自动下载默认开启，可在 设置 → 关于 关掉。
- 强制更新：当本机版本低于运营设定的最低支持版本时，横幅不可关闭，也不出现「跳过此版本」。
字段 / 状态说明
| 名称 | 含义 | 什么时候用 |
|---|---|---|
| 发现新版本 {version} | 更新源里出现了比本机更新的版本 | 后台或手动检查后出现 |
| 正在下载新版本 {version} | 正在下载安装包，旁边显示百分比 | 自动下载开启时 |
| 新版本 {version} 已下载 | 安装包已就绪，重启即可安装 | 点「重启安装」前 |
| 稍后 | 收起横幅，本次不装 | 不想现在重启时 |
| 跳过此版本 | 记住该版本不再提示 | 想留在当前版本；强制更新时该按钮不出现 |
| 前往官网下载 | 打开官网下载页 | macOS 版未做 Apple 公证、自动更新装不上时 |
| 手动下载 | 打开运营配置的安装包地址 | 强制升级但自动更新通道还没就绪时 |
与其它功能的关系
官网下载页的版本号与安装包地址来自同一份远程配置，运营改配置后下载页自动跟着变，不需要重新发官网。客户端里的更新策略——是否检查更新、更新源在哪、是否强制升级——同样取自这份配置。官网与客户端因此显示同一份发版信息。
限制与注意
- macOS 版目前不做自动更新：产物未做 Apple 公证，自动下载能完成但安装一定失败，所以只提示新版本并引导去官网重装。这是有意取舍，不是故障。
- 关掉「自动更新」不影响强制升级：被判为低于最低支持版本时仍会下载。
- 「跳过此版本」在强制更新下不生效。
- 应用窗口最小 900×600，窗口更小时内容会挤，属正常现象。
常见问题
Q：macOS 提示「已损坏」或「无法验证开发者」，是安装包有问题吗？ A：不是。本版本未做 Apple 公证，系统因此会拦。到 系统设置 → 隐私与安全性 点「仍要打开」，再双击确认一次即可。
Q：Windows 的 SmartScreen 警告要点哪里？ A：点「更多信息」→「仍要运行」。本版本未做 Windows 代码签名，所以会有这个提示。
Q：点了「检查更新」像没反应？ A：按钮在检查期间显示「检查中…」，结束时会有提示：已是最新版本、更新检查当前已由服务端关闭、或检查失败。单次检查 20 秒超时，超时按失败上报。