# Ubuntu 22.04 佳石服务安装脚本使用说明 (v2.3)

本脚本专为 **Ubuntu 22.04 LTS (Jammy)** 系统量身定制，集成了智能网络修复、科学的源管理和健壮的容错机制，确保在各种复杂网络环境下都能一键完成部署。

## ✨ 核心特性

1. **⚡ 智能源优选**：脚本会自动测试阿里云、清华、腾讯、华为、官方等多个镜像源，自动选择**当前网速最快**的一个，并确保主系统源和兼容源使用同一个镜像站，拒绝依赖冲突。
2. **🌐 Netplan DNS 自动修复**：
    * 自动识别 `/etc/netplan/*.yaml` 配置文件。
    * 智能注入 `114.114.114.114` 和 `223.5.5.5` 到 DNS 列表头部。
    * 自动执行 `netplan apply`，永久解决域名解析失败问题。
3. **🕒 强力时区配置**：
    * 采用四级保障策略 (`timedatectl` -> `ln` -> `cp` -> 手动交互)。
    * 如果自动配置全部失效，脚本会自动调出交互界面供您手动选择，确保时间准确 (Asia/Shanghai)。
4. **📝 全量日志记录**：每次运行都会在当前目录自动生成带时间戳的日志文件 (如 `jiasion_install_20260101_120000.log`)，方便故障回溯。
5. **🛡️ 熔断保护**：一旦检测到关键步骤（如 `apt-get update`）失败，脚本会立即停止，防止破坏系统环境。
6. **📦 双保险下载**：关键依赖（如 `libssl1.1`）配置了官方备用源，主线路不通时自动切换。

## 🚀 快速开始

### 1. 上传脚本

将 `srv_ubuntu.sh` 上传到服务器任意目录（例如 `~`）。

### 2. 赋予权限

```bash
chmod +x srv_ubuntu.sh
```

### 3. 执行安装

```bash
# 标准安装 (默认安装最新版服务)
# 过程中可能需要输入 sudo 密码
sudo ./srv_ubuntu.sh install

# 安装指定版本
sudo ./srv_ubuntu.sh install 1.5.25
```

### 4. 服务重装

如果需要清理环境并重新安装：

```bash
# 会先停止并卸载旧版服务，然后重新执行安装流程
sudo ./srv_ubuntu.sh reinstall
```

## ❓ 常见问题排查 (FAQ)

**Q: 脚本运行完提示 "手动配置成功" 是什么意思？**
A: 这意味着前三种自动修改时区的方法（如 `timedatectl`）都失败了（可能因容器权限限制），脚本自动为您调出了图形化界面。只要您在界面中选对了 Asia/Shanghai，结果就是成功的。

**Q: 安装失败了，哪里看报错？**
A: 请查看当前目录下的日志文件：

```bash
ls -l *.log
cat jiasion_install_XXXXXXXX_XXXXXX.log
```

日志中会有红色的 `[ERROR]` 提示具体原因。

**Q: 为什么 `/etc/resolv.conf` 还是被修改了？**
A: 只有在 Netplan 自动修复失败（极为罕见）的情况下，脚本才会作为最后的手段临时去修改 `/etc/resolv.conf`，重启后可能会失效，但足够保证本次安装完成。

**Q: 必须使用 Ubuntu 22.04 吗？**
A: **是的**。脚本内置了严格的版本检测，非 Ubuntu 22.04 (Jammy) 系统会直接拒绝运行。

---
*Last Updated: 2026-01-04*