🚀 devboost

一键检测、修复、优化常见开发网络与基础环境问题。支持 Linux / macOS / WSL。

---

✨ 特性

• 智能检测：自动识别发行版、包管理器、systemd、网络状态，适配各种环境。
• DNS 优化：支持 systemd-resolved / resolv.conf，一键切换至阿里、腾讯、Cloudflare 等公共 DNS，安全可回滚。
• 系统镜像优化：为 apt / yum / dnf / pacman / brew 等包管理器切换国内镜像源（阿里、清华、中科大、华为云等），支持自定义和恢复官方源。
• 开发工具镜像：自动配置 npm / pnpm / yarn / pip / docker 的国内镜像，提升下载速度。
• GitHub 访问优化：通过更新 hosts 或设置代理环境变量，改善 GitHub 访问体验（需用户确认）。
• 安全可靠：所有修改自动备份，支持一键回滚，详细日志记录，--dry-run 模拟运行无风险。
• 跨平台支持：覆盖主流 Linux 发行版（Debian、Ubuntu、CentOS、Fedora、Rocky、Alma、Arch 等）、macOS 及 WSL。
• 模块化设计：功能模块独立，易于扩展和维护。
• 多语言支持：内置中文/英文双语界面，通过 --lang zh 切换。

---

📦 快速开始

一键远程运行

bash <(curl -sSL https://raw.githubusercontent.com/ISHAOHAO/devboost/main/install.sh)

本地运行

git clone https://github.com/ISHAOHAO/devboost.git
cd devboost
chmod +x install.sh lib/*.sh modules/*.sh
sudo ./install.sh

使用命令行直接优化系统镜像（阿里云，自动确认）

sudo ./install.sh --system-mirror --mirror aliyun --lang zh -y

---

🖥️ 支持的操作系统

分类	发行版
Debian 系	Debian 813, Ubuntu 1425, Kali Linux, Linux Mint, Deepin, Zorin OS, Raspberry Pi OS, Armbian, Proxmox VE, openKylin
RHEL 系	RHEL 710, Fedora 3043, CentOS 78/Stream, Rocky Linux 810, AlmaLinux 810, Oracle Linux 810
其他	openEuler 2025, OpenCloudOS 8.69, Arch Linux, macOS, WSL1/2

---

🌐 全球镜像源支持

devboost 现已集成全球数百个开源镜像站，按地区分类：

• 中国大陆：阿里云、腾讯云、华为云、清华大学、中科大、上海交大、北京大学等 20+ 镜像源
• 亚太地区：新加坡、日本、韩国、澳大利亚、新西兰、印度等国家和地区的镜像源
• 欧洲：德国、法国、英国、荷兰、瑞典、芬兰、瑞士等 30+ 镜像源
• 美洲：美国 MIT、普林斯顿、UCSC、Liquid Web、Nexcess 等，以及加拿大、巴西、阿根廷镜像源
• 非洲及中东：南非、肯尼亚、毛里求斯、土耳其等镜像源

系统会自动根据您的发行版过滤不兼容的镜像源，确保配置正确有效。

---

📚 使用说明

交互式菜单

直接运行 sudo ./install.sh，根据提示选择功能：

========== devboost 优化工具 ==========
1. DNS 优化
2. 系统镜像优化 (包管理器)
3. 开发工具镜像优化 (npm/pip/docker等)
4. GitHub 访问优化
5. 全部执行
0. 退出
========================================
请选择 [0-5]：

命令行选项

./install.sh [选项]

选项:
  -y, --yes               自动确认所有提示
  --dns                   仅运行 DNS 优化模块
  --system-mirror         仅运行系统镜像优化模块
  --devtools-mirror       仅运行开发工具镜像优化模块
  --github                仅运行 GitHub 访问优化模块
  --rollback              执行回滚操作
  --mirror <名称/URL>     指定镜像站（如 aliyun, tuna 或完整 URL）
  --protocol <http|https> 指定协议（默认 https）
  --branch <分支>         指定仓库分支（如 updates, security）
  --components <组件>     指定组件列表（如 main contrib non-free）
  --lang <zh|en>          设置语言（默认 en）
  --dry-run               模拟运行，不实际修改任何文件
  -h, --help              显示帮助

示例

# 使用清华大学镜像源更新 apt（自动确认）
sudo ./install.sh --system-mirror --mirror tuna --lang zh -y

# 仅优化 GitHub 访问
./install.sh --github

# 回滚到上次备份
sudo ./install.sh --rollback

# 模拟运行 DNS 优化，查看将执行的操作
sudo ./install.sh --dns --dry-run

---

🧩 模块介绍

• DNS 优化 (dns.sh)：检测当前 DNS，提供多组公共 DNS 选择，支持 systemd-resolved 和传统 resolv.conf，自动备份。
• 系统镜像优化 (system_mirror.sh)：根据发行版自动生成正确格式的源列表，提供中国大陆、海外及官方源选项，支持 apt/yum/dnf/pacman/brew。
• 开发工具镜像 (devtools_mirror.sh)：为 npm/pnpm/yarn/pip/docker 配置国内镜像，支持自定义 registry。
• GitHub 访问优化 (github.sh)：通过更新 hosts 或设置代理环境变量改善访问，需用户确认。

---

🔧 开发与贡献

欢迎贡献代码、报告问题或提出建议！

开发环境

git clone https://github.com/ISHAOHAO/devboost.git
cd devboost
# 安装依赖（用于测试）
# Ubuntu/Debian: sudo apt install bats shellcheck
# CentOS/RHEL: sudo yum install bats shellcheck

运行测试

bats test/

贡献指南

请阅读 CONTRIBUTING.md 了解详情。

---

📄 许可证

MIT © 2026 devboost contributors