Skip to content

About

面向 Linux 多服务器场景的轻量级 Shell 运维工具集,把新机开荒、安全卫士与节点管理整合到一个交互式菜单里

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ServerHarbor

面向 Linux 多服务器场景的轻量级 Shell 运维工具集,把新机开荒、安全卫士与节点管理整合到一个交互式菜单里

Shell Bash

Tag License


✨ 为什么做这个脚本

维护多台 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。

安装完成后可直接执行:

shr

💻 在线运行

bash <(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
done

▶️ 交互运行

SERVERHARBOR_RUNTIME=online bash menu.sh

🔐 安全报告

如果发现安全问题,请不要公开披露细节。请优先参考仓库中的 SECURITY.md 提交安全报告。

📄 许可证

本项目基于 GPL-3.0 开源。

Built with ❤️ by Sunny

About

面向 Linux 多服务器场景的轻量级 Shell 运维工具集,把新机开荒、安全卫士与节点管理整合到一个交互式菜单里

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages