# sys_init

**Repository Path**: zseagate/sys_init

## Basic Information

- **Project Name**: sys_init
- **Description**: sys_init.sh，专为Debian系列Linux发行版设计，提供系统安装后的一站式优化配置服务。脚本兼容32位与64位架构，支持Debian 10+、Ubuntu 20.04+、MX Linux、Linux Mint、Lubuntu、Xubuntu、PeppermintOS、Zorin等主流衍生版本，实现从硬件驱动适配到常用软件安装的全流程自动化配置。
- **Primary Language**: Shell
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Debian系Linux系统优化脚本

## 一、脚本概述
本脚本适用于Debian及其衍生发行版（包括Ubuntu、MX Linux、Linux Mint、Lubuntu、Xubuntu、PeppermintOS、Zorin等）的32位与64位系统，可实现系统安装后的一站式优化配置，涵盖硬件驱动适配、中文环境配置、常用软件安装、系统性能优化等核心功能，全面支持Debian 12+/Debian 13+/Ubuntu 22.04+/Linux Mint 20+/MX Linux 等全系列Debian系衍生发行版。

### 1.1 脚本信息
1. **脚本名称**：`sys_init.sh`
2. **版本号**：V2.2
3. **更新日期**：2026-5-17
4. **支持系统**：Debian 10+、Ubuntu 20.04+、MX Linux、Linux Mint、Lubuntu、Xubuntu、PeppermintOS、Zorin
5. **支持架构**：x86/i386（32位）、x86_64/amd64（64位）

### 1.2 功能模块
脚本包含**7大核心功能模块**，实现系统安装后一站式配置：
1. 系统基础优化与自动更新
2. 硬件驱动安装与适配（显卡、无线网卡、蓝牙）
3. 中文环境配置（语言包、中文字体）
4. Fcitx5输入法安装（拼音+五笔）
5. WPS Office安装与配置
6. 星火应用商店安装
7. 系统清理与最终优化

---

## 二、使用方法

### 2.1 运行前准备
1. 确保系统已连接**有线网络**（无线网卡驱动可能需要先安装）
2. 确保有**root权限**或**sudo权限**
3. **重要数据提前备份**，避免意外情况

### 2.2 执行步骤
1. 手动复制脚本内容保存为`sys_init.sh`文件
2. 添加执行权限：
   
   ```bash
   chmod +x sys_init.sh
   ```
   
3. 运行脚本：
   
   ```bash
   sudo ./sys_init.sh
   ```
   
4. 等待脚本执行完成，**重启系统**生效所有配置。

---

## 三、各模块功能说明

### 3.1 系统基础优化与自动更新
1. **全量系统更新**：自动执行`apt update/upgrade/dist-upgrade`，将所有软件包更新到最新版本
2. **自动安全更新**：配置`unattended-upgrades`，实现系统安全补丁自动安装
3. **国内软件源配置**：自动替换为阿里云镜像源，大幅提升软件下载速度
4. **基础工具安装**：安装编译环境、网络工具、压缩工具等常用系统工具

### 3.2 硬件驱动安装与适配
#### 3.2.1 显卡驱动
1. **NVIDIA显卡**：自动添加显卡驱动PPA源，安装官方推荐版本驱动，**禁用nouveau开源驱动**
2. **AMD/ATI显卡**：安装开源驱动和固件，修复Secure Display报错问题
3. 驱动安装完成后通过`nvidia-smi`或`glxinfo | grep OpenGL`验证

#### 3.2.2 无线网卡驱动
1. 自动识别**Intel、Realtek、高通Atheros、博通**无线网卡
2. 安装对应厂商固件或驱动，解决无线网卡无法使用问题
3. 支持绝大多数主流笔记本和台式机无线网卡

#### 3.2.3 蓝牙驱动
1. 自动检测蓝牙硬件，安装bluez驱动和blueman图形管理工具
2. 配置蓝牙服务开机自启，默认开启自动连接功能
3. 支持蓝牙鼠标、键盘、耳机等常见蓝牙设备

### 3.3 中文环境配置
1. 安装简体中文语言包，生成`zh_CN.UTF-8`本地化配置
2. 安装**文泉驿微米黑、文泉驿正黑、Noto CJK**等常用中文字体
3. 优化字体渲染配置，解决中文显示模糊、方框等问题

### 3.4 Fcitx5输入法安装
1. 自动清理旧的fcitx和ibus输入法框架，避免冲突
2. 安装Fcitx5核心组件、中文附加组件（**拼音+五笔**）
3. 配置全局环境变量，确保GTK/QT应用都能正常调用输入法
4. 内置**萌娘百科和维基百科词库**，提升输入准确率
5. 支持**五笔86、拼音、双拼**等多种输入方案，重启后可通过`fcitx5-configtool`自定义配置

### 3.5 WPS Office安装
1. 自动下载最新版**WPS Office for Linux**
2. 安装缺失的**Symbol字体**，解决打开文档提示字体缺失问题
3. 修复WPS中文输入兼容性问题，确保可以正常输入中文
4. 支持`.docx/.xlsx/.pptx`等常用Office格式，完美兼容微软Office文档

### 3.6 星火应用商店安装
1. 自动添加**星火应用商店官方软件源**
2. 修复Ubuntu 20.04等旧版本的DTK依赖问题
3. 提供丰富的Linux软件资源，支持一键安装、更新、卸载软件
4. 包含大量**国产软件**和**Wine适配的Windows软件**，降低Linux使用门槛

### 3.7 系统清理与优化
1. 自动清理系统缓存、无用依赖包和临时文件
2. 优化系统参数，降低`swappiness`值，提升系统运行速度
3. 清理过程不删除用户数据，仅释放系统无用空间

---

## 四、注意事项
1. **网络要求**：运行脚本需要稳定的网络连接，**建议使用有线网络**，避免安装过程中断
2. **Secure Boot**：如果开启了Secure Boot，NVIDIA驱动可能无法正常加载，建议在BIOS中**关闭Secure Boot**
3. **重启要求**：脚本执行完成后**必须重启系统**，所有配置才能生效
4. **架构支持**：星火应用商店仅支持**amd64和arm64架构**，32位系统会自动跳过该模块
5. **老系统适配**：Ubuntu 18.04及更早版本建议先升级系统再使用本脚本

---

## 五、常见问题解决方案
### 5.1 输入法无法调出
1. 检查是否已重启系统，环境变量需要重启后生效
2. 执行`fcitx5-diagnose`工具检测具体问题
3. 确保`~/.xprofile`或`/etc/profile.d/fcitx5.sh`中已正确配置环境变量

### 5.2 WPS无法输入中文
1. 检查`/usr/bin/wps`等启动脚本中是否已添加输入法环境变量
2. 确认系统默认输入法框架已设置为fcitx5

### 5.3 NVIDIA驱动安装后黑屏
1. 重启时在GRUB菜单中添加`nomodeset`参数进入系统
2. 确认已禁用nouveau驱动，检查`/etc/modprobe.d/blacklist-nouveau.conf`文件
3. 尝试卸载NVIDIA驱动后重新安装

### 5.4 蓝牙设备无法连接
1. 执行`rfkill list`查看蓝牙是否被软锁定，使用`rfkill unblock bluetooth`解锁
2. 重启蓝牙服务：`systemctl restart bluetooth`
3. 尝试删除设备后重新配对连接

### 5.5 星火应用商店无法启动
1. Ubuntu 20.04系统需确认已安装DTK依赖包
2. 执行`sudo apt --fix-broken install`修复依赖问题
3. 尝试卸载后重新安装星火应用商店

---

## 六、卸载与恢复
### 6.1 恢复原有软件源
脚本已自动备份原有软件源为`/etc/apt/sources.list.backup`，可通过以下命令恢复：

```bash
sudo cp /etc/apt/sources.list.backup /etc/apt/sources.list
sudo apt update
```

### 6.2 卸载NVIDIA驱动

```bash
sudo apt purge nvidia*
sudo apt autoremove
sudo reboot
```

### 6.3 切换回ibus输入法

```bash
sudo apt purge fcitx5*
sudo apt install ibus ibus-pinyin
im-config -n ibus
```

---

## 七、更新日志
V2.2（2026-05-17）：新增Linux Mint系列系统适配，修复Mint系统下脚本直接退出的问题，优化固件包安装容错机制，调整NVIDIA驱动适配逻辑，完美支持Debian/Ubuntu/Linux Mint三大主流发行版；

V2.1（2026-05-17）：新增国内镜像源自动测速选择功能，自动测试阿里云、华为云、腾讯云、清华、中科大、上海交大6个主流源的响应速度，自动选择当前网络环境下最快的源，大幅提升软件下载安装速度；

V2.0（2026-05-16）稳定版：新增严格错误捕获机制，优化安装速度减少依赖，规范化配置文件管理，精简输出日志，完善多镜像源容错机制，所有功能在Debian 12/Ubuntu 22.04/Ubuntu 24.04全功能测试通过。

V1.6（2026-05-16）：新增多镜像源容错下载机制，屏蔽非必要输出信息，增加下载超时和重试逻辑。

V1.5（2026-05-16）：修复WPS官方下载链接404问题，更新为2024最新稳定版地址。

V1.4（2026-05-16）：修复Debian系统语言包不存在问题，适配Debian/Ubuntu不同语言包逻辑。

V1.3（2026-05-16）：修复locale生成不完整问题，彻底解决中文环境配置错误。

V1.2（2026-05-16）：新增发行版自动检测功能，修复Debian系统无ubuntu-drivers-common包的问题。

V1.1（2026-05-16）：新增蓝牙驱动自动适配功能，新增系统自动安全更新配置。

V1.0（2026-05-10）：初始版本发布，支持硬件驱动、输入法、WPS、星火应用商店等核心功能。

## 八、适用范围/测试验证
2026-05-17 于 Debian GNU/Linux 13 (trixie) 系统全功能测试通过，所有模块执行正常，无错误提示。

2026-05-17 于 Linux Mint 22.3 系统全功能测试通过，所有模块执行正常，无错误提示。