安装
安装主控
下载发布包，用 install.sh 安装主控或“主控 + 被控”。
1. 下载发布包
从官网 3rsoft.com.pa 下载 3R Monitor。最新版直接下载：3rsoft.com.pa/download/3r-monitor。文件名为 3rmonitor-版本号.tar.gz，例如 3rmonitor-1.1.1.tar.gz。
| 发布包中的文件 | 说明 |
|---|---|
3rmonitor-linux-amd64、-arm64、-arm、-386 | 程序本身，每种 CPU 架构一个文件 |
install.sh | 安装脚本：安装、升级和卸载 |
SHA256SUMS | 程序的校验和；install.sh 安装前会校验 |
SHA256SUMS.sig | 3R Soft 对校验和的签名。被控只会自动更新到签名里列出的程序。 |
geoip-country.mmdb | IP 国家库（DB-IP），用于访问统计 |
README.md、LICENSE、SECURITY.md、THIRD_PARTY_NOTICES.txt | 说明文档、许可协议和第三方声明 |
只有主控需要发布包。被控会从你的主控下载程序。
许可协议不允许把发布包转给他人。如果别人也想用 3R Monitor，请让他们到 3rsoft.com.pa 下载。
2. 上传到服务器并解压
从你的电脑复制发布包：
scp 3rmonitor-1.1.1.tar.gz root@主控服务器:/root/
ssh root@主控服务器
tar xzf 3rmonitor-1.1.1.tar.gz && cd 3rmonitor-1.1.1或者直接在服务器上下载：
curl -fL -o 3rmonitor.tar.gz https://3rsoft.com.pa/download/3r-monitor
tar xzf 3rmonitor.tar.gz && cd 3rmonitor-*/要下载指定版本而不是最新版，在下载链接后加 ?version=1.1.1。
3. 运行安装脚本
交互安装
sudo bash install.sh安装脚本会显示一个菜单：
| 选项 | 适用于 |
|---|---|
| 1）被控端 | 向已有主控上报的服务器。被控从面板安装更方便，见安装被控。用发布包安装时，要在命令行里给出 --master 和 --token，见手动安装。 |
| 2）主控端 | 只运行面板和检测的服务器 |
| 3）主控 + 被控（默认，推荐） | 主控服务器，它本身也会被监控 |
| 4）升级 | 用本发布包中的版本替换程序，保留配置与数据 |
| 5）卸载 | 移除 3R Monitor |
新装主控时选 3。安装脚本接着会询问：
- 面板对外地址：其他服务器访问主控用的地址，也是告警邮件里链接指向的地址。默认是
http://本机IP:8899/。如果你的服务器分布在不同网络中，请填公网 IP 或域名，不要填内网地址。 - 管理员用户名（默认
admin）和密码：至少 8 位。直接回车会自动生成一个，并在最后的汇总中显示。
无人值守安装
在命令行里给出全部参数，就不会有任何提问：
sudo bash install.sh both --admin admin --password '强密码' --public-url http://203.0.113.10:8899/如果这台服务器已经装了 Nginx 或 Apache，想用域名 + HTTPS 访问：
sudo bash install.sh both --domain monitor.example.com --https --email you@example.com如果这台服务器不需要运行被控，把 both 换成 master。
不用 install.sh、一步步安装主控，见手动安装主控。
安装选项
sudo bash install.sh --help 会按你的语言显示这些选项。
| 选项 | 作用 |
|---|---|
master · both · agent · upgrade · uninstall | 模式；不指定时打开交互菜单 |
--port 8899 | 面板端口（默认 8899） |
--listen 0.0.0.0 | 监听地址。只想通过反向代理提供面板时用 127.0.0.1。 |
--public-url URL | 面板对外地址，被控和邮件链接使用。默认 http://本机IP:端口/。 |
--admin 用户名 --password 密码 | 管理员账号。不填则交互询问，或自动生成密码。 |
--domain 域名 | 在已安装的 Nginx 或 Apache 中为该域名生成反向代理 |
--https | 配合 --domain：用 certbot 申请免费的 Let's Encrypt 证书（自动续期），面板改用 https:// |
--email 邮箱 | 接收证书到期提醒的邮箱（可选） |
--no-firewall | 不在防火墙中放行端口 |
--master URL | 被控：主控地址，与浏览器打开面板的地址相同 |
--token 密钥 | 被控：本服务器的专属密钥，在面板登记服务器后获得 |
--enroll 绑定密钥 | 被控：批量绑定，服务器自动登记（可配合 --name / --group） |
--name 名称 --group 分组 | 自动登记时的显示名称与分组（主控 + 被控模式也可用） |
--insecure | 被控：不校验主控的 HTTPS 证书（自签名证书时用） |
--master-key FP --approvers FP,… | 被控：安装时就信任主控的签名钥匙和管理员的通行密钥，用于经批准的 AI 修复。面板给出的安装命令已经包含这两项。 |
--purge | 配合 uninstall：同时删除配置和数据 |
-y / --yes | 不询问，全部使用默认值 |
--lang en|es|zh | 安装脚本的语言。默认按 MONITOR_LANG、LANGUAGE、LC_ALL、LC_MESSAGES 或 LANG 选择。 |
安装脚本做了什么
| 内容 | 位置 |
|---|---|
| 程序，以及供被控下载的程序包 | /opt/3rmonitor（/opt/3rmonitor/dist）；3rmonitor 命令在 /usr/local/bin 和 /usr/bin |
| 配置 | /etc/3rmonitor/master.conf 和 agent.conf |
| 数据（SQLite 数据库、IP 国家库） | /var/lib/3rmonitor，属于 3rmonitor 用户 |
| 守护进程 | 3rmonitor-master 和 3rmonitor-agent：开机自启，崩溃 3 秒后自动重启，卡死时由 systemd 看门狗重启。主控在严格的 systemd 隔离里运行（3rmonitor-master.service.d/hardening.conf）：只能写自己的数据目录。系统不支持时，安装脚本会去掉它并提示。 |
| 被控的用户和辅助程序 | 被控以非特权用户 3rmonitor-agent 运行；3rmonitor-helper 是一个以 root 运行的小服务，负责需要 root 的操作，并检查和执行 AI 操作 |
| 一键更新 | 3rmonitor-update.path 和 3rmonitor-update.service，一个以 root 运行的小服务，负责安装你在面板里发起的更新 |
| 防火墙 | 在 ufw 或 firewalld 中放行面板端口 |
最后会打印一份汇总：每个步骤显示 ✓ / ✗，以及面板地址、管理员账号（如果自动生成了密码，也会显示）和下一步操作。安装脚本可以随时重复运行：在已有的安装上，账号、设置和数据都会保留。
4. 登录
在浏览器中打开面板地址，用管理员账号登录。全新安装时面板是空的。接下来：
- 在其他服务器上安装被控。
- 在 设置 中检查 时区（面板和邮件中的所有时间都按它显示），配置 SMTP 发信和 告警收件人（在 告警通知 中）。见设置。
- 为你的网站和接口添加网站监控。
- 如果面板能从公网访问，启用 HTTPS。
- 可选：配置 AI 分析。
公网访问请使用 HTTPS
使用 http:// 时，浏览器会提示“不安全”，而且密码和会话 Cookie 以明文传输。在内网用 IP 打开面板没有问题；其他情况请见 HTTPS。