维护多台 Linux 服务器时,初始化环境、检查安全状态和切换 SSH 会话往往需要反复执行相似操作。ServerHarbor 将这些任务放进同一个终端菜单,每台服务器都能独立运行,无需部署专用控制端。
- 新机初始化:按需安装基础工具和 Docker,查看系统资源与网络信息。
- 日常维护:检查登录与访问日志、校验文件变化,并连接其他节点执行命令。
- 系统开荒:选择基础软件包、安装 Docker,或调用网络调优脚本。
- 安全巡检:统计失败登录、扫描可疑 nginx 请求、查看防火墙状态并给出安全评分。
- 文件完整性:配置监控路径,创建命名 SHA-256 基线,支持单个或全部基线校验。
- 节点管理:维护 SSH 节点、查看连通状态、双向登记节点信息,并在选中节点上远程执行命令。
- 命令行任务:直接运行节点探测、安全巡检和资源阈值检查,便于接入定时任务。
- 中英界面:在线运行和安装时可选择中文或英文。
- 运行系统:Linux 与 Bash;软件包安装适配 apt-get、dnf 和 yum。
- 下载工具:使用在线或安装入口前准备好 curl 和 tar,并确保能访问 GitHub 与 raw.githubusercontent.com。
- 操作权限:安装、更新、卸载和基础软件安装需要 root 权限;读取受限日志和文件也需要相应权限。
- 节点连接:使用节点功能需要支持
StrictHostKeyChecking=accept-new的 OpenSSH 客户端,以及 ping 和 nc;目标服务器需开放 SSH,密码认证还需要 sshpass。 - 源码运行:选择克隆仓库的方式时需要 Git。
curl -q -fsSL "https://raw.githubusercontent.com/hyrchen/ServerHarbor/main/install.sh?$(date +%s)" | sudo bash安装器会在执行任何包安装、目录创建或文件写入之前,先展示计划动作并请求确认。
安装与更新默认只依赖 bash、curl 和 tar。
安装完成后可直接执行:
shrbash <(curl -q -fsSL "https://raw.githubusercontent.com/hyrchen/ServerHarbor/main/run.sh?$(date +%s)")在线运行入口会先展示将执行的动作,再请求确认;确认前不会创建临时目录、下载源码包或尝试安装依赖。
主菜单选择 1,再选择基础软件、Docker、网络调优或生成报告。
基础软件安装支持按编号切换、a 全选、n 全不选、y 确认。apt 模式默认启用系统更新与升级,可按 u 关闭。网络调优入口分别调用 bbrv3-lite 和 vps-tcp-tune,执行前会展示来源与命令并请求确认。
主菜单选择 2,按任务选择登录统计、Web 请求扫描、防火墙状态或安全评分。
文件校验建议依次执行 7 管理监控路径、5 生成完整性基线、6 校验完整性基线。可为不同用途创建独立基线,并选择单个或全部校验。
主菜单选择 3:
- 节点列表:添加节点后,可按序号修改或删除。
- 建立互信:将本机信息登记到选中节点,并检查双向网络连通性;两端的 SSH 登录凭据需分别准备。
- 远程执行:在选中节点上运行在线版、安装 ServerHarbor、启动已安装版本,或输入自定义命令。
建议使用 SSH 密钥认证。密码认证会将密码明文写入配置文件,分享配置或提交问题前应删除凭据。
在源码目录执行;安装版可将 bash menu.sh 替换为 shr:
bash menu.sh --cron-probe
bash menu.sh --cron-security > security-report.txt
bash menu.sh --cron-alerts三个参数依次用于节点探测、安全报告和资源阈值检查。--cron-alerts 超过阈值时输出告警并返回退出码 1,无告警时返回 0。参数执行一次即退出,定时调度需自行配置。
通过 run.sh 启动时,主菜单选择 4 会重新下载 main 分支源码并启动;安装版选择 4 通过安装器更新。源码运行请在仓库目录通过 Git 更新。
安装版选择主菜单 5 卸载,也可执行:
sudo bash /opt/serverharbor/app/uninstall.sh卸载时输入 k 保留数据、y 连同数据一起删除,默认取消。
| 运行方式 | 默认数据目录 | 配置文件 |
|---|---|---|
| 在线运行 | ~/.config/serverharbor |
数据目录下的 serverharbor.conf |
| 安装运行 | /opt/serverharbor/data |
数据目录下的 serverharbor.conf |
在线运行优先使用 SERVERHARBOR_HOME;未指定时,数据目录遵循 XDG_CONFIG_HOME。源码直启会根据安装标记选择运行模式,快速开始中的命令显式使用在线模式。
数据目录下,logs/serverharbor.log 保存操作日志,state/integrity-名称.sha256 保存文件基线。报告主要输出到终端,需要留档时按上方示例重定向保存;reports/ 目录由程序创建。
在线版与安装版数据分别保存。安装版可通过 系统开荒 → 数据迁移 合并数据,迁移前应备份配置与基线。
运行后可在配置文件中设置以下参数,节点区段建议通过菜单维护:
NG_LANG="zh"
NG_ALERT_CPU_THRESHOLD=80
NG_ALERT_MEM_THRESHOLD=80
NG_ALERT_DISK_THRESHOLD=90
NG_WATCH_PATHS="/etc /var/www /root"NG_LANG 支持 zh 和 en,阈值单位为百分比,监控路径用空格分隔。路径解析按空格拆分,请使用不含空格的路径。
- 日志扫描:登录统计读取
/var/log/auth.log或/var/log/secure,Web 扫描读取/var/log/nginx/access.log,结果取决于现有日志内容。 - 安全评分:按 SSH 配置、防火墙工具和登录失败等规则提供检查线索,需结合服务器实际配置判断。
- 文件基线:校验已记录文件的哈希;新增文件需重新生成基线后纳入检查。
- 节点状态:先检查 ping,再用 nc 检查 SSH 端口;禁用 ICMP 或缺少探测工具时,显示的状态可能与实际 SSH 可用性不同。
- Bash:交互式菜单、命令行入口与系统运维逻辑。
- OpenSSH:远程登录、节点登记与远程命令执行。
- GNU 工具:使用 awk、sed、grep 和 sha256sum 处理日志、配置与文件校验。
- curl 与 tar:下载并解压在线运行和安装所需的源码。
ServerHarbor/
├── .github/ISSUE_TEMPLATE/ # 问题反馈模板
├── menu.sh # 主菜单与 CLI 入口
├── common.sh # 配置、日志与共享函数
├── bootstrap.sh # 系统开荒与第三方调优入口
├── security.sh # 安全巡检与文件完整性
├── nodes.sh # 节点管理与远程执行
├── run.sh # 在线运行入口
├── install.sh # 安装与更新
├── uninstall.sh # 卸载入口
├── SECURITY.md # 安全报告策略
└── LICENSE # GPL-3.0 许可证
- 开发平台:Linux。
- 脚本运行时:Bash。
for script in *.sh; do
bash -n "$script" || exit
doneSERVERHARBOR_RUNTIME=online bash menu.sh如果发现安全问题,请不要公开披露细节。请优先参考仓库中的 SECURITY.md 提交安全报告。
本项目基于 GPL-3.0 开源。