218 lines
4.1 KiB
Markdown
218 lines
4.1 KiB
Markdown
# ⚡ 一键部署指南
|
||
|
||
## 🎯 目标
|
||
自动部署到：**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*
|