Krun - 运维自动化脚本工具集

______
___  /____________  ________
__  //_/_  ___/  / / /_  __ \
_  ,<  _  /   / /_/ /_  / / /
/_/|_| /_/    \__,_/ /_/ /_/
       Ops Script Runner

项目简介

Krun 是一个面向运维工程师的脚本工具集，提供 Shell 与 PowerShell 两类运维脚本，覆盖系统初始化、安全加固、服务部署、性能优化以及 Windows 装机配置等场景。支持 CentOS/RHEL、Debian/Ubuntu、macOS、Windows，可通过 curl / irm | iex 直接执行。

目录结构

krun/
├── cmd/krun/                # Go CLI
├── lib/
│   ├── fs.go                # go:embed sh + ps1
│   ├── sh/*.sh              # Linux/mac 脚本（权威，打进二进制）
│   └── ps1/*.ps1            # Windows 脚本（权威，打进二进制）
├── deploy.sh / deploy.ps1 # 从 GitHub Release 安装/覆盖更新/卸载 CLI
└── .goreleaser.yaml         # 多平台发布

项目架构

只维护两套脚本：lib/sh（Linux/mac）与 lib/ps1（Windows）。CLI 为 Go 二进制（go:embed 内嵌全部 sh/ps1）。Release 只分发 CLI；运行时不拉脚本。

flowchart TB
    subgraph Entry["入口"]
        CLI["bin/krun list / name"]
        CURL["curl lib/sh/... | bash"]
        IRM["irm lib/ps1/... | iex"]
    end

    subgraph Runner["运行层"]
        KRUN["krun (Go + embed scripts)"]
        BASH["bash"]
        PSH["pwsh / powershell"]
    end

    subgraph Lib["脚本层"]
        SH["lib/sh/*.sh"]
        PS["lib/ps1/*.ps1"]
    end

    CLI --> KRUN
    KRUN --> BASH --> SH
    KRUN --> PSH --> PS
    CURL --> BASH
    IRM --> PSH

调用流程

方式 A：krun CLI

sequenceDiagram
    actor U as 用户
    participant K as bin/krun
    participant S as lib/sh|ps1

    U->>K: krun install_docker
    K->>S: 从 embed 解析并执行
    S-->>U: 完成

方式 B：远程一管道（无需装 CLI）

sequenceDiagram
    actor U as 用户
    participant R as GitHub raw
    participant I as bash / powershell

    U->>R: curl lib/sh/xxx.sh 或 irm lib/ps1/xxx.ps1
    R->>I: bash / iex
    I-->>U: 完成

Windows 远程（config_remote）

flowchart LR
    A["Admin 运行 config_remote.ps1"] --> B["开 RDP 注册表 + NLA"]
    B --> C["Ensure TermService / UmRdpService"]
    C --> D["Restart-Service TermService"]
    D --> E{"防火墙任一 profile 开?"}
    E -->|是| F["加 RDP/WinRM 规则"]
    E -->|否| G["跳过防火墙规则"]
    A --> H["Enable-PSRemoting + WinRM"]
    H --> E

开发者新增脚本

flowchart LR
    A["复制现有 sh/ps1"] --> B["lib/sh|ps1"]
    B --> C["rake build"]
    C --> D["krun list 可见"]

核心特性

🚀 一键安装: 90+ 运维脚本，按语言分目录管理（sh / ps1）
🔧 系统配置: 完善的系统初始化和安全加固脚本
🌐 多平台支持: CentOS/RHEL 7-9、Debian/Ubuntu、macOS、Windows
📦 模块化设计: 每个脚本独立运行，可单独使用或组合使用
🔒 安全可靠: MIT 许可证，所有脚本开源可审查
🎯 远程执行: 支持 curl 直接执行，无需克隆仓库
🐚 Shell 脚本: lib/sh/*.sh（embed + bash）
💠 PowerShell 脚本: lib/ps1/*.ps1（embed + pwsh/powershell）
🐹 Go CLI: 多平台二进制；脚本全部 go:embed，运行不拉网

主要功能

系统配置

系统基线配置: 安全加固、内核参数优化、SSH配置
软件源配置: CentOS 7/Rocky Linux 软件源配置
基础软件安装: 常用运维工具包安装
系统性能优化: 内核参数、网络、存储性能调优

服务部署

容器服务: Docker 安装配置
开发环境: Python、Node.js、Go、Ruby 环境安装
数据库: MySQL、PostgreSQL、Redis、MongoDB 部署
Web服务: Nginx、Apache 配置

Windows 装机与远程

软件安装: winget、Chrome、Bandizip、Snipaste、OBS、Caddy、VS Code（lib/ps1/install_*.ps1）
系统配置: 东八区 NTP、关闭防火墙、RDP + WinRM 远程服务
批量安装: install_windows_all.ps1（读 manifest ps1 列表）

运维工具

监控工具: Node Exporter、系统监控脚本
日志管理: 日志轮转、清理脚本
备份工具: 数据备份、配置备份脚本
网络工具: 网络诊断、性能测试工具

快捷复制命令清单：docs/COMMANDS.md。

快速开始

方式一：安装 Krun 工具（推荐）

# Linux / macOS — 安装或覆盖更新
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash
source ~/.bashrc  # 或 source ~/.zshrc

# 钉版本（可选）
# KRUN_VERSION=v2.2.0 curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash

# 卸载
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash -s -- --uninstall

# Windows — 安装或覆盖更新
irm https://raw.githubusercontent.com/kevin197011/krun/main/deploy.ps1 | iex
# 新开终端后可用 krun（已写入 User PATH）

# 钉版本（可选）
# $env:KRUN_VERSION='v2.2.0'; irm https://raw.githubusercontent.com/kevin197011/krun/main/deploy.ps1 | iex

# 卸载
$env:KRUN_ACTION='uninstall'; irm https://raw.githubusercontent.com/kevin197011/krun/main/deploy.ps1 | iex

krun list
krun install_docker.sh
krun init_system.sh

安装说明：

支持 macOS 和 Linux（CentOS/RHEL、Debian/Ubuntu）
自动检测 OS/Arch，下载对应 krun_<ver>_<os>_<arch>.tar.gz（或 deb/rpm）
默认装到 ~/.krun/bin（root 且可写则 /usr/local/bin）；重复执行会覆盖更新已有二进制并清理其它残留路径
Linux/mac 脚本用 lib/sh；Windows 用 lib/ps1
本地开发：go build -o bin/krun ./cmd/krun 或 rake build
本地开发时 krun 优先读仓库内文件，再回退 GitHub raw

方式二：直接执行脚本

# Docker 安装
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/lib/sh/install_docker.sh | sudo bash
F3CF


# FFmpeg 安装
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/lib/sh/install_ffmpeg.sh | sudo bash

# Rocky Linux 仓库配置
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/lib/sh/config_rocky_repo.sh | sudo bash

# 系统初始化与性能优化
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/lib/sh/init_system.sh | sudo bash

方式三：本地使用

# 克隆仓库
git clone https://github.com/kevin197011/krun.git
cd krun

# 方式 3.1: 部署 / 覆盖更新 / 卸载 krun CLI
./deploy.sh                 # 安装或覆盖更新
./deploy.sh --uninstall     # 卸载
source ~/.bashrc  # 或 source ~/.zshrc
krun list

# 方式 3.2: 直接执行脚本
./lib/sh/install_docker.sh
./lib/sh/init_system.sh

# 方式 3.3: 使用本地 krun 工具
./bin/krun install_git.sh

脚本列表

以嵌入清单为准（约 96：sh 84 + ps1 12）。命名统一 snake_case：

krun list
# 或
krun list

主要分类：

类别	示例
系统初始化	`init_system.sh`, `config_system_baseline.sh`, `disable_firewall_selinux.sh`
软件源/磁盘	`config_rocky_repo.sh`, `config_disk_data.sh`, `disk_cleanup.sh`
安装类	`install_docker.sh`, `install_nginx.sh`, `install_golang.sh`, `install_nexttrace.sh`
运维工具	`deploy_node_exporter.sh`, `crane_copy.sh`, `check_ip_quality.sh`
开发环境	`install_asdf.sh`, `install_oh_my_zsh.sh`, `install_rbenv.sh`
Windows	`install_chrome.ps1`, `config_remote.ps1`, `disable_firewall.ps1`

lib/sh/：Linux/mac bash 权威实现
lib/ps1/：Windows PowerShell 权威实现

Windows（PowerShell）

原独立仓 windows-utils 能力已并入本仓 lib/ps1/（原仓废弃，请只使用 krun）。需求权威：docs/REQUIREMENTS.md。

脚本	说明
`install_winget.ps1`	安装/升级 winget
`install_chrome.ps1`	Google Chrome
`install_bandizip.ps1`	Bandizip
`install_snipaste.ps1`	Snipaste（便携）
`install_obs.ps1`	OBS Studio
`install_caddy.ps1`	Caddy
`install_vscode.ps1`	VS Code System Installer
`install_cursor.ps1`	Cursor User Installer（官方 API 拉最新；`-Force` 覆盖升级）
`install_windows_all.ps1`	批量跑嵌入的 `install_*.ps1`
`config_timezone_utc8_ntp.ps1`	东八区 + NTP
`disable_firewall.ps1`	关闭全部防火墙配置文件
`config_remote.ps1`	全自动 RDP + WinRM；开 RDP 后重启 TermService；防火墙开着才加规则，全关则跳过

# 单脚本（远程）
irm https://raw.githubusercontent.com/kevin197011/krun/main/lib/ps1/install_chrome.ps1 | iex

# 强制重装
$env:FORCE_INSTALL='true'; irm https://raw.githubusercontent.com/kevin197011/krun/main/lib/ps1/install_vscode.ps1 | iex

# 批量安装
irm https://raw.githubusercontent.com/kevin197011/krun/main/lib/ps1/install_windows_all.ps1 | iex

# 远程服务 + 关防火墙（按需）
irm https://raw.githubusercontent.com/kevin197011/krun/main/lib/ps1/config_remote.ps1 | iex
irm https://raw.githubusercontent.com/kevin197011/krun/main/lib/ps1/disable_firewall.ps1 | iex

本机已装 krun 且有 pwsh/powershell：krun install_chrome.ps1 / krun config_remote.ps1。

支持平台

CentOS/RHEL: 7, 8, 9
Rocky Linux: 8, 9
AlmaLinux: 8, 9
Debian: 10, 11, 12
Ubuntu: 18.04, 20.04, 22.04, 24.04
macOS: 10.15+ (部分脚本)
Windows: 10/11 / Server（lib/ps1，需 PowerShell；部分需管理员）

使用示例

新服务器初始化

# 1. 部署 krun CLI
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash
source ~/.bashrc

# 2. 系统基础配置
krun disable_firewall_selinux.sh
krun config_system_baseline.sh
krun config_ssh.sh
krun init_system.sh

# 3. 安装常用软件
krun install_docker.sh
krun install_git.sh
krun install_vim.sh

# 4. 配置开发环境
krun install_python3.sh
krun install_golang.sh
krun install_oh_my_zsh.sh

Rocky Linux 9 修复 IPv6 源问题

# 修复 Rocky Linux 9 的 IPv6 源导致的包管理器问题
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/lib/sh/config_rocky_repo.sh | sudo bash

Kubernetes 环境搭建

krun install_docker.sh
krun install_kind.sh
krun install_helm.sh
krun install_k9s.sh

自动挂载数据盘

# 自动格式化并挂载数据盘到 /data
data_disk="/dev/sdb" mount_point="/data" sudo bash lib/sh/config_disk_data.sh

注意事项

权限要求: 大部分脚本需要 root 或 sudo 权限执行
备份重要: 脚本会自动备份原始配置文件到 .bak 或 backup/ 目录
网络要求: 需要稳定的网络连接下载软件包
测试环境: 建议先在测试环境验证脚本功能
安全审查: 执行前请审查脚本内容，确保符合安全要求
平台兼容: 部分脚本仅支持特定平台，请查看脚本说明

开发者指南

创建新脚本

运维脚本只在 lib/sh（bash）与 lib/ps1（PowerShell）。新增：复制同目录现有脚本改名，再 rake build（嵌入进 CLI）与 rake docs:commands（刷新 docs/COMMANDS.md）。

# Shell：lib/sh/<action>_<name>.sh
# PowerShell：lib/ps1/<action>_<name>.ps1
rake build
rake docs:commands

贡献指南

欢迎提交 Issue 和 Pull Request 来改进项目：

Fork 本仓库
创建功能分支 (git checkout -b feature/new-script)
按照标准格式编写脚本
测试脚本在不同平台的兼容性
提交更改 (git commit -am 'Add new script')
推送到分支 (git push origin feature/new-script)
创建 Pull Request

常见问题

Q: curl / irm 执行脚本失败？

每个运维脚本在 lib/sh 或 lib/ps1。请确认：

URL 指向 lib/sh/<name>.sh 或 lib/ps1/<name>.ps1
Linux/mac 多数需 sudo bash；Windows 用 irm … | iex（管理员按脚本要求）
网络可访问 raw.githubusercontent.com

Q: 如何更新 krun 工具？

再跑一次部署脚本即可（覆盖更新已有二进制，优先原路径，并清理其它残留）：

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash

# Windows
irm https://raw.githubusercontent.com/kevin197011/krun/main/deploy.ps1 | iex

钉某一版：设 KRUN_VERSION=vX.Y.Z（PowerShell：$env:KRUN_VERSION='vX.Y.Z'）后再执行。

Q: 如何查看所有可用脚本？

# 使用 krun 工具查看脚本列表
krun list

# 或直接查看 lib 目录
ls -l lib/sh/*.sh lib/ps1/*.ps1

Q: 脚本执行失败怎么办？

检查是否有 root/sudo 权限
检查网络连接是否正常
查看错误日志，定位具体问题
提交 Issue 描述问题和环境信息

Q: 如何卸载 krun？

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/kevin197011/krun/main/deploy.sh | bash -s -- --uninstall
# 或本地：./deploy.sh --uninstall

# Windows
$env:KRUN_ACTION='uninstall'; irm https://raw.githubusercontent.com/kevin197011/krun/main/deploy.ps1 | iex
# 或本地：.\deploy.ps1 -Uninstall

Q: 安装脚本会自动安装依赖吗？

deploy.sh / deploy.ps1 只拉 GitHub Release 里的 krun 二进制并写 PATH；不装 Python 等运行时依赖。脚本本身需要 curl/tar（Windows 用 PowerShell）。

发布

ruby push.rb          # 或 rake push：提交 + 推送 + 自动打 v* tag（默认 patch+1）
KRUN_BUMP=minor ruby push.rb
SKIP_TAG=1 ruby push.rb   # 只提交不打 tag

打 v* tag 后 GitHub Actions（GoReleaser）发多平台二进制；deploy.sh / deploy.ps1 拉 latest。

许可证

本项目采用 MIT 许可证，详情请查看 LICENSE 文件。

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/krun		cmd/krun
docs		docs
lib		lib
.gitignore		.gitignore
.goreleaser.yaml		.goreleaser.yaml
Gemfile		Gemfile
LICENSE		LICENSE
README.md		README.md
Rakefile		Rakefile
deploy.ps1		deploy.ps1
deploy.sh		deploy.sh
go.mod		go.mod
go.sum		go.sum
push.rb		push.rb

Latest commit

History

Folders and files

Repository files navigation