添加一键部署脚本和自动部署指南

This commit is contained in:
2026-06-02 16:42:38 +08:00
parent e418f03f0c
commit efdd967d69
2 changed files with 454 additions and 0 deletions

217
AUTO_DEPLOY_README.md Normal file
View File

@@ -0,0 +1,217 @@
# ⚡ 一键部署指南
## 🎯 目标
自动部署到:**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
```
### 问题2Git 克隆失败(认证错误)
**解决**:脚本会提示输入 Gitea 用户名和密码
```
Username: yangyuqing
Password: [你的Gitea密码]
```
### 问题3Web 服务器启动失败
**查看日志**
```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*