# ⚡ 一键部署指南

## 🎯 目标
自动部署到：**https://solarark.net/g2026/g4/**

---

## 📋 前提条件

你需要有服务器的 **SSH 访问权限**和 **sudo 权限**。

---

## 🚀 三步完成部署

### 第1步：上传部署脚本到服务器

在你的电脑上打开终端（Windows 可用 PowerShell 或 Git Bash）：

```bash
# 上传脚本到服务器
scp auto-deploy.sh username@solarark.net:/tmp/

# 输入服务器密码
```

或者，如果你已经在服务器上，可以跳过此步。

---

### 第2步：SSH 登录服务器并运行脚本

```bash
# SSH 登录
ssh username@solarark.net

# 赋予执行权限
chmod +x /tmp/auto-deploy.sh

# 运行部署脚本（需要 sudo）
sudo bash /tmp/auto-deploy.sh
```

**脚本会自动完成：**
- ✅ 检查并安装依赖（Git、Apache/Nginx）
- ✅ 备份现有部署（如果有）
- ✅ 克隆最新代码
- ✅ 验证文件完整性
- ✅ 设置正确的文件权限
- ✅ 配置 Web 服务器
- ✅ 重启服务
- ✅ 测试访问

**预计时间**: 5-10分钟

---

### 第3步：验证部署

脚本运行完成后，在浏览器中访问：
```
https://solarark.net/g2026/g4/
```

按 F12 检查：
- ✅ Console 无红色错误
- ✅ Network 所有资源状态码 200
- ✅ 页面正常显示

---

## 🔍 如果遇到问题

### 问题1：提示 "Permission denied"

**解决**：确保使用 `sudo` 运行脚本
```bash
sudo bash /tmp/auto-deploy.sh
```

### 问题2：Git 克隆失败（认证错误）

**解决**：脚本会提示输入 Gitea 用户名和密码
```
Username: yangyuqing
Password: [你的Gitea密码]
```

### 问题3：Web 服务器启动失败

**查看日志**：
```bash
# Apache
sudo tail -f /var/log/apache2/error.log

# Nginx
sudo tail -f /var/log/nginx/error.log
```

### 问题4：页面显示但样式不对

**检查 .htaccess**：
```bash
ls -la /var/www/html/g2026/g4/.htaccess
cat /var/www/html/g2026/g4/.htaccess
```

确保 Apache 启用了 mod_rewrite：
```bash
sudo a2enmod rewrite
sudo systemctl restart apache2
```

---

## 🔄 后续更新（超简单）

以后修改代码后，只需在服务器上运行：

```bash
ssh username@solarark.net
cd /var/www/html/g2026/g4
git pull origin master
sudo systemctl restart apache2
```

或者重新运行部署脚本：
```bash
sudo bash /tmp/auto-deploy.sh
```

---

## 📊 部署详情

### 脚本功能清单

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1/7 | 检查依赖 | 自动安装 Git 和 Web 服务器 |
| 2/7 | 创建备份 | 如果目录已存在，自动备份 |
| 3/7 | 创建目录 | 确保部署目录存在 |
| 4/7 | 获取代码 | Git clone 或 pull |
| 5/7 | 验证文件 | 检查关键文件是否存在 |
| 6/7 | 设置权限 | 正确的所有者和权限 |
| 7/7 | 配置服务 | Apache/Nginx 配置和重启 |

### 支持的系统

- ✅ Ubuntu / Debian
- ✅ CentOS / RHEL
- ✅ Apache2
- ✅ Nginx

### 部署位置

- **目录**: `/var/www/html/g2026/g4/`
- **URL**: `https://solarark.net/g2026/g4/`
- **备份**: `/var/www/html/g2026/g4_backup_时间戳/`

---

## 💡 小贴士

1. **首次部署**: 脚本会自动安装所需软件
2. **更新部署**: 脚本会检测并更新现有代码
3. **安全备份**: 每次部署前自动备份旧版本
4. **智能检测**: 自动识别 Apache 或 Nginx
5. **完整验证**: 部署后自动测试访问

---

## 🎊 成功标志

看到以下输出表示部署成功：

```
========================================
  ✅ 部署成功！
========================================

访问地址: https://solarark.net/g2026/g4/
部署目录: /var/www/html/g2026/g4/
Web 服务器: apache2

✓ 本地访问测试通过

祝毕业设计展示圆满成功！🎓✨
```

---

## 📞 需要帮助？

如果脚本执行出错，请提供：

1. **错误信息截图**
2. **服务器系统版本**:
   ```bash
   cat /etc/os-release
   ```
3. **Web 服务器类型**:
   ```bash
   sudo systemctl status apache2
   # 或
   sudo systemctl status nginx
   ```
4. **日志内容**:
   ```bash
   sudo tail -n 50 /var/log/apache2/error.log
   ```

---

**祝你一次部署成功！** 🚀✨

*详细文档请查看 DEPLOY_GUIDE.md*