macOS / Linux 服务与环境一键管理脚本库 — 78 个模块,统一子命令接口,覆盖服务部署、系统初始化、开发环境、AI 工具、系统运维全场景。支持 x86_64 / ARM64 / ARMv7 三大架构,适配银河麒麟 / 统信 UOS 等国产发行版。
当前版本:VERSION(v2.5.0) · 更新日志:CHANGELOG.md · AI 接口说明:AGENTS.md
- 一行安装:无需 clone,
curl | bash即可拉起任意模块 - 78 个模块:服务 / 装机必备 / 开发环境 / AI 工具 / 系统工具,5 大分类全覆盖
- 统一接口:所有模块遵循
install / uninstall / status / help约定 - 注册表驱动:模块自带
.manifest元数据,自动发现、自动排序、自动别名 - AI / 脚本友好:
status --json、list --full、list --grouped三种机器可读输出 - 交互 + 非交互双模:终端用户用菜单,AI / CI 用参数透传
- 全局命令
uxs:装一次,任意目录可用 - Tab 补全:bash / zsh 自动补全模块名与子命令
- 预览模式
--dry-run:只打印不执行,安全审计 - 环境诊断
doctor:一键检查运行前提 - 模块脚手架
scaffold:一行命令生成新模块模板 - 安全自更新:
update自动检查 + 确认 +git pull - 国产化适配:银河麒麟 / 统信 UOS / openEuler / deepin / openKylin 的发行版与桌面环境自动识别
- 多发行版 CI:Ubuntu / macOS 实机 + 主流发行版容器 + 国产化容器矩阵验证
# 启动交互式菜单(首次自动 clone,之后自动 git pull 更新)
curl -fsSL https://raw.githubusercontent.com/zy84338719/unix_script/main/bootstrap.sh | bash
# 非交互:直接安装指定模块
curl -fsSL https://raw.githubusercontent.com/zy84338719/unix_script/main/bootstrap.sh | bash -s -- docker
curl -fsSL https://raw.githubusercontent.com/zy84338719/unix_script/main/bootstrap.sh | bash -s -- tailscale
curl -fsSL https://raw.githubusercontent.com/zy84338719/unix_script/main/bootstrap.sh | bash -s -- status --json
# 子命令透传
curl -fsSL .../bootstrap.sh | bash -s -- bun mirror
curl -fsSL .../bootstrap.sh | bash -s -- clash startgit clone https://github.com/zy84338719/unix_script.git && cd unix_script
./install.sh # 交互式主菜单
./install.sh docker # 非交互安装
./install.sh tailscale # 非交互安装
./install.sh bun mirror # 模块子命令透传
./install.sh sys-setup all # 一次性执行所有系统初始化| 命令 | 说明 |
|---|---|
./install.sh |
进入交互式主菜单 |
./install.sh <模块> |
非交互安装该模块(默认动作) |
./install.sh <模块> <子命令> |
透传子命令到模块(如 clash start) |
./install.sh status |
查看所有模块安装状态 |
| 命令 | 说明 |
|---|---|
./install.sh -h / --help |
显示帮助(含所有模块名) |
./install.sh -v / --version |
显示版本 |
./install.sh list |
列出所有模块名(空格分隔,适合脚本) |
./install.sh list --full |
TSV:模块名 + 支持的子命令 + 描述(AI / 脚本友好) |
./install.sh list --grouped |
按分类分组列出模块 |
./install.sh search <关键字> |
搜索模块(名称/别名/描述,多关键字 AND;无匹配退出 1) |
./install.sh status --json |
key:value 状态(无颜色无 emoji,AI 友好) |
| 命令 | 说明 |
|---|---|
./install.sh doctor |
环境诊断:Bash 版本 / 必要工具 / 包管理器 / 磁盘 / 网络 / sudo |
./install.sh update --check |
检查远端是否有新版本(不修改本地) |
./install.sh update |
安全检查 + 确认后 git pull 更新 |
./install.sh install <模块> --dry-run |
预览模式:只打印将执行的操作,不实际执行 |
./install.sh install <模块> --no-deps |
安装但跳过依赖自动安装 |
./install.sh export [--out 文件] |
导出已装模块+配置为 profile(默认 ~/.config/unix_script/profile.txt) |
./install.sh apply [文件] [--force|--dry-run] |
从 profile 复现安装(已装跳过;--force 重装) |
./install.sh cli install |
安装全局命令 uxs 到 ~/.tools/bin |
./install.sh cli uninstall |
卸载全局命令 uxs |
./install.sh completions [shell] |
安装 Tab 自动补全(bash / zsh / fish,缺省=当前 shell) |
./install.sh scaffold <名称> [选项] |
生成新模块脚手架 |
CLI 一次性切换到分组子命令面,旧扁平写法全部删除。命中旧写法会报错退出(退出码 2 = 用法错)并给一行迁移指引 —— 命令照样失败,不是兼容路径。
| 旧写法 | 新写法 |
|---|---|
--list |
uxs list |
--list-modules |
uxs list --full |
--list-categories |
uxs list --grouped |
--status |
uxs status |
--status-json |
uxs status --json |
--dry-run <模块> |
uxs install <模块> --dry-run |
--no-deps <模块> |
uxs install <模块> --no-deps |
check-update |
uxs update --check |
export / export-profile |
uxs export [--out 文件] |
apply / apply-profile |
uxs apply <profile> |
cli / install-cli |
uxs cli install |
uninstall-cli / remove-cli |
uxs cli uninstall |
completions |
uxs completions [shell] |
scaffold / doctor / update |
同名分组命令(uxs scaffold / uxs doctor / uxs update) |
新增:uxs info <模块>(模块明细:标签/分类/依赖/子命令/适用平台)、uxs --list-all(全量 TSV 清单,含平台不适用)。
| 命令 | 行为 |
|---|---|
uxs |
进交互式主菜单。装了 fzf 就用 fzf(分层导航:主列表 = 导航首页 10 行 —— 🔍 搜索全部模块 + 状态总览 / 卸载 / 检查更新 / 刷新缓存 + 分类入口;模块行全在二级列表 —— 选分类进该分类、选搜索进全量可搜列表(跨分类直接搜 docker),TAB 多选 + 右侧 README 预览不变),没装则用 bash 菜单(两级分类导航) |
uxs install |
不带模块名 ⇒ 进交互菜单挑模块安装 |
uxs remove |
不带模块名 ⇒ 进交互式卸载菜单 |
非交互环境(管道 / CI / 无 TTY)下这三个仍是用法错退出 2 —— 菜单没地方显示;脚本里判「用法错」的行为不变。
./install.sh scaffold my-module --category 服务 --label "我的服务"
# 在 services/ 下创建 my-module/install.sh + .manifest + README.md
# category 取值:服务 / 装机必备 / 开发环境 / AI工具 / 系统工具专为 AI agent 与自动化脚本设计,三种格式覆盖所有场景:
# 1) 模块名 + 子命令 + 描述(TSV,解析最方便;第 3 列为 DESC 描述)
$ ./install.sh list --full
node_exporter install uninstall status help Prometheus 系统指标收集器
bun install mirror unmirror uninstall status help Bun 运行时(含国内镜像加速)
clash install uninstall status start stop restart enable disable help 代理核心 + TUN 透明代理(mihomo)
# 2) 当前安装状态(key:value,无颜色无 emoji;首 3 行为框架元数据 os/arch/version)
$ ./install.sh status --json
os:darwin
arch:ARM64
version:1.15.0
node_exporter:not_installed
docker:installed:running
bun:installed:v1.3.14
tailscale:installed:connected
# 3) 按分类分组(人类可读)
$ ./install.sh list --grouped
[服务] docker nginx redis ...
[装机必备] sys-setup nvm brew ...去除颜色(管道 / 日志场景):
NO_COLOR=1 ./install.sh status # 强制无颜色
./install.sh status --json # status --json 始终无颜色AI agent 的典型工作流详见 AGENTS.md。
无参数运行 ./install.sh 进入交互菜单。根据环境自动选择模式(UXS_MENU=fzf|bash 强制指定):
fzf 模式(检测到 fzf 时自动启用)
- 输入关键字模糊搜索模块(模块名 / 名称 / 中文描述)
TAB勾选多个模块,回车批量执行默认动作(install 依赖自动先装)- 右侧预览窗格显示模块 README(fzf ≥ 0.20)
bash 分类菜单(无 fzf 时自动降级)
- 首页选分类(服务 / 装机必备 / 开发环境 / AI工具 / 系统工具,附「已装/总数」),再进模块列表
- 每行含状态图标与中文描述:
✓已安装 · 空白 未安装 ··本平台不适用 - 支持一次多选:输入
1,3,5-8(逗号/区间可混合) - 输入
/关键字过滤当前分类(匹配模块名/名称/描述),单独输入/清空过滤 b返回上级;首页:s状态总览 ·u卸载 ·c检查更新 ·f刷新状态缓存 ·q退出
菜单内的安装状态来自并行查询的跨进程缓存:默认缓存 300 秒(UXS_STATUS_CACHE_TTL 调整,0 禁用),并发度 UXS_STATUS_JOBS(默认 8)。
平台:✅ 支持 · ❌ 不适用 · ✅* 引导安装。带「别名」的模块可用别名调用,如
./install.sh pg= postgres。
| 模块 | 说明 | 别名 | Linux | macOS |
|---|---|---|---|---|
| docker | 容器引擎(Engine / Desktop) | — | ✅ | ✅* |
| nginx | Web 服务器 / 反向代理 | — | ✅ | ✅ |
| caddy | 现代 Web 服务器(自动 HTTPS) | — | ✅ | ✅ |
| redis | 内存数据库 / 缓存 | — | ✅ | ✅ |
| postgres | PostgreSQL 数据库 | postgresql, pg | ✅ | ✅ |
| prometheus | 监控系统(时间序列数据库) | — | ✅ | ✅ |
| grafana | 监控可视化面板 | — | ✅ | ✅ |
| node_exporter | Prometheus 系统指标收集器 | nodeexporter | ✅ | ✅ |
| uptime-kuma | 服务可用性监控面板(Docker) | uptime_kuma | ✅ | ✅ |
| gitea | 自托管 Git 服务 | — | ✅ | ✅ |
| openlist | 文件列表 / 网盘聚合(原 Alist) | — | ✅ | ✅ |
| ddns-go | 动态域名解析服务 | ddnsgo, ddns | ✅ | ✅ |
| certbot | Let's Encrypt 免费 SSL 证书 | letsencrypt | ✅ | ✅ |
| fail2ban | SSH 暴力破解防护 | f2b | ✅ | ❌ |
| cockpit | Linux Web 管理面板 | — | ✅ | ❌ |
| 1panel | 新一代 Linux 服务器运维面板(v2) | 1p | ✅ | ❌ |
| btpanel | 宝塔 Linux 运维面板(en 装 aaPanel 国际版) | bt | ✅ | ❌ |
| webmin | 经典 Web 系统管理面板(官方仓库) | — | ✅ | ❌ |
| casaos | 家庭云/NAS 轻量面板(Docker 应用商店) | — | ✅ | ❌ |
| tailscale | 免公网 IP 的组网 VPN | ts | ✅ | ✅ |
| wireguard | 现代、快速、安全的 VPN | wg | ✅ | ✅ |
| 模块 | 说明 | 别名 | Linux | macOS |
|---|---|---|---|---|
| essential-pkgs | curl/git/vim/htop/tmux/jq 等一键装齐 | essential, essential_pkgs | ✅ | ✅ |
| sys-setup | 换源/时区/NTP/优化/SSH 加固/自动更新 | sys_setup | ✅ | ✅ |
| nvm | Node.js 多版本管理 | — | ✅ | ✅ |
| brew | Homebrew 包管理器 | homebrew | ❌ | ✅ |
| swap | 创建 / 调整 swap 虚拟内存 | — | ✅ | ❌ |
| bbr | TCP BBR 拥塞控制加速 | — | ✅ | ❌ |
| 模块 | 说明 | 别名 | Linux | macOS |
|---|---|---|---|---|
| bun | Bun 运行时(含国内镜像加速) | — | ✅ | ✅ |
| deno | Deno 运行时 | — | ✅ | ✅ |
| go | Go 语言环境 | golang | ✅ | ✅ |
| rust | Rust 语言环境 | rustup | ✅ | ✅ |
| pnpm | Node.js 包管理器 | — | ✅ | ✅ |
| dev-mirror | 开发换源加速(npm/Go/Rust/pip) | dev_mirror, devmirror | ✅ | ✅ |
| dev-enhance | Neovim+LazyVim / git delta / tmux 配置 | — | ✅ | ✅ |
| dev-tui | lazydocker + lazygit | dev_tui, tui | ✅ | ✅ |
| modern-cli | bat/eza/ripgrep/fd/fzf/zoxide/starship/tldr/direnv | modern_cli, moderncli | ✅ | ✅ |
| zsh_setup | Zsh + Oh My Zsh + 插件配置 | zsh | ✅ | ✅ |
| terminal | 一键终端全家桶(zsh+ohmyzsh+现代 CLI+字体+atuin) | — | ✅ | ✅ |
| nerd-font | 终端图标字体(p10k/starship/eza 依赖) | nerd_font, nerdfont | ✅ | ✅ |
| atuin | SQLite 化 shell 历史(搜索/同步) | — | ✅ | ✅ |
| code-lint | 代码分析工具集 | codelint, code_lint, lint-tools | ✅ | ✅ |
| minikube | 本地 Kubernetes 开发环境 | — | ✅ | ✅ |
| 模块 | 说明 | 别名 | Linux | macOS |
|---|---|---|---|---|
| ollama | 本地大模型运行时 | — | ✅ | ✅ |
| opencode | 终端 AI 编程助手 | — | ✅ | ✅ |
| pi | Pi AI 编程代理框架 | — | ✅ | ✅ |
| 模块 | 说明 | 别名 | Linux | macOS |
|---|---|---|---|---|
| clash | 代理核心 + TUN 透明代理(mihomo) | mihomo | ✅ | ✅ |
| sys-cmd | 系统诊断命令集(cpu/mem/port/disk/net) | sys_cmd, syscmd | ✅ | ✅ |
| disk-usage | 磁盘空间管理(top 大目录下钻 / 监控 / 清理) | du, disk_usage | ✅ | ✅ |
| disk | 磁盘管理工具箱:分区/格式化/挂载/SMART 体检/坏块扫描/擦除 | — | ✅ | ❌ |
| ops-kit | 运维工具箱:一键巡检/日志运维/systemd 服务/安全基线 | ops, opskit | ✅ | ❌ |
| docker-image | 镜像导出为 .tar.gz(离线分发) | docker_image, dockerimage | ✅ | ✅ |
| process_manager_tool | 智能搜索和管理系统进程 | process_manager, pm | ✅ | ✅ |
| shutdown_timer | 定时 / 倒计时关机管理 | shutdown | ✅ | ✅ |
| safe-rm | 安全删除替代 rm,防误删 | safe_rm, safesrm | ✅ | ✅ |
| nat | NAT 端口转发 | port-forward, forward, nat-manager | ✅ | ✅ |
| multi-net | 多网卡策略路由 | multinet, multi_net | ✅ | ❌ |
| ufw | UFW 防火墙管理 | firewall | ✅ | ❌ |
| restic | 增量加密备份工具 | — | ✅ | ✅ |
| deskflow | 键鼠共享(Flatpak / Homebrew) | — | ✅ | ✅ |
| k7s | k7s 工具 | — | ✅ | ✅ |
| upftp | 轻量级 FTP 文件分享工具 | — | ✅ | ✅ |
* macOS 上引导安装 Docker Desktop。
所有模块遵循同一套约定,学习一个即可用全部:
./install.sh <模块> install # 安装 / 配置(默认动作)
./install.sh <模块> uninstall # 卸载
./install.sh <模块> status # 查看状态(输出一行结论,退出 0,用于探测)
./install.sh <模块> help # 用法说明部分模块提供额外子命令(用 list --full 查询完整列表):
# 开发环境 —— 国内镜像加速
./install.sh bun mirror # Bun 切国内镜像源
./install.sh bun unmirror # 恢复官方源
./install.sh dev-mirror all # npm/Go/Rust/pip 全部换源
# 代理与网络
./install.sh clash start # 启动 mihomo
./install.sh clash stop # 停止
./install.sh clash restart # 重启
./install.sh clash enable # 开机自启
./install.sh clash disable # 禁用自启
# 磁盘空间分析
./install.sh disk-usage top --depth 2 # 多层大目录下钻(交互终端可序号下钻)
./install.sh disk-usage clean # 一键清理
# 运维工具箱(仅 Linux)
./install.sh ops-kit inspect # 一键巡检报告(默认动作,只读)
./install.sh ops-kit inspect --json # 机器可读巡检结果
./install.sh ops-kit svc failed # systemd 失败单元排查
./install.sh ops-kit audit all # SSH 基线/公网端口/待更新自查
# 系统初始化(一次性全套)
./install.sh sys-setup all # 换源 + 时区 + NTP + 内核优化 + SSH 加固 + 自动更新
./install.sh sys-setup mirror # 仅换源
./install.sh sys-setup ssh # 仅 SSH 加固
./install.sh sys-setup optimize # 仅内核参数优化
./install.sh sys-setup ntp # 仅配置 NTP
./install.sh sys-setup timezone # 仅设时区
./install.sh sys-setup unattended # 仅配置自动更新
# 直接调用(绕过 install.sh,进入子菜单)
./dev-tools/dev-mirror/install.sh install all default
./sys-tools/multi-net/install.sh list
./sys-tools/sys-cmd/install.sh menu
./sys-tools/docker-image/install.sh save
./sys-tools/disk/install.sh wizard # 新盘一键上线:分区→格式化→挂载→fstab(仅 Linux)
./essentials/bbr/install.sh enable每个模块在 .manifest 中可声明 ALIASES,支持简写调用:
./install.sh pg # = postgres
./install.sh ts # = tailscale
./install.sh wg # = wireguard
./install.sh f2b # = fail2ban
./install.sh du # = disk-usage
./install.sh pm # = process_manager_tool
./install.sh homebrew # = brew
./install.sh zsh # = zsh_setup安装一次后,任意目录都可调用:
./install.sh cli install # 安装 uxs 到 ~/.tools/bin(自动配置 PATH)
uxs docker # 任意目录安装 docker
uxs bun mirror # 任意目录换源
uxs status --json # 任意目录查状态
uxs doctor # 任意目录环境诊断
uxs cli uninstall # 卸载 uxs 自身支持 bash / zsh / fish 的 PATH 配置,自动备份 shell rc 文件。
./install.sh completions # 一键安装到 shell 配置(自动检测 bash/zsh)
source completions/uxs.bash # 或手动 source(bash)
source completions/uxs.zsh # 或手动 source(zsh)
# 之后输入 uxs <Tab> 即可补全模块名与子命令只打印将执行的操作,不实际改动系统,适合审计与 CI:
./install.sh --dry-run docker # 预览 docker 安装流程
./install.sh --dry-run sys-setup all # 预览系统初始化一键检查运行 unix_script 的所有前提条件:
./install.sh doctor
# 检查项:Bash 版本 / curl/tar/git/sudo / shellcheck/jq /
# 操作系统 / CPU 架构 / 包管理器 / 磁盘空间 / 网络连通 / sudo 权限
# 返回值 = 发现的问题数(0 = 一切就绪)./uninstall.sh # 交互式逐项询问
./uninstall.sh docker # 仅卸载指定模块
./uninstall.sh --all # 卸载全部(需二次确认)
./uninstall.sh -h # 帮助卸载入口同样注册表驱动,自动发现所有 .manifest 模块。
状态列 = main 分支最近一次完成的 CI run 中对应 job 的结论,由
support-matrix任务自动刷新。
| 分类 | 系统 | 镜像 / 版本 | 包管理 | CI |
|---|---|---|---|---|
| 实机 | Ubuntu(runner 内置) | ubuntu-latest | apt | ✅ |
| 实机 | macOS(runner 内置) | macos-latest | brew | ✅ |
| 容器 | Ubuntu 26.04 | ubuntu:26.04 |
apt | ✅ |
| 容器 | Ubuntu 24.04 | ubuntu:24.04 |
apt | ✅ |
| 容器 | Debian 12 | debian:12 |
apt | ✅ |
| 容器 | Debian 13 | debian:13 |
apt | ✅ |
| 容器 | Fedora | fedora:latest |
dnf/yum | ✅ |
| 容器 | CentOS Stream 9 | quay.io/centos/centos:stream9 |
dnf/yum | ✅ |
| 容器 | AlmaLinux 9 | almalinux:9 |
dnf/yum | ✅ |
| 容器 | Rocky Linux 9 | rockylinux:9 |
dnf/yum | ✅ |
| 容器 | openSUSE Leap 15.6 | opensuse/leap:15.6 |
zypper | ✅ |
| 容器 | Arch Linux | archlinux:latest |
pacman | ✅ |
| 容器 | Alpine Linux | alpine:latest |
apk | ✅ |
| 国产化* | 银河麒麟 V10 SP3 | docker.io/macrosan/kylin:v10-sp3-2403 |
dnf/yum | ✅ |
| 国产化* | 统信 UOS V20 | docker.io/macrosan/uos:v20-1070 |
dnf/yum | ✅ |
| 国产化* | openEuler 24.03 LTS | docker.io/openeuler/openeuler:24.03-lts |
dnf/yum | ✅ |
| 国产化* | deepin 23 | docker.io/linuxdeepin/deepin:latest |
apt | ✅ |
| 国产化* | openKylin | docker.io/openkylin/openkylin:latest |
apt | ✅ |
* 国产化社区镜像为尽力而为(continue-on-error):结果记入报告,不阻塞质量门禁。