添加快速部署操作手册
This commit is contained in:
310
QUICK_DEPLOY.md
Normal file
310
QUICK_DEPLOY.md
Normal file
@@ -0,0 +1,310 @@
|
||||
# ⚡ 快速部署操作手册
|
||||
|
||||
## 🎯 目标
|
||||
将网站部署到：**https://solarark.net/g2026/g4/**
|
||||
|
||||
---
|
||||
|
||||
## 📋 部署前准备（5分钟）
|
||||
|
||||
### ✅ 确认事项
|
||||
- [ ] 代码已推送到 Gitea: https://gitea.solarark.net/yangyuqing/new-site
|
||||
- [ ] 有服务器访问权限（SSH 或 FTP）
|
||||
- [ ] 知道服务器项目根目录路径
|
||||
|
||||
### 📦 当前版本
|
||||
- 最新提交: `31ea4ba - 添加部署脚本和完整部署指南`
|
||||
- 包含文件: index.html, css/, js/, .htaccess, images/
|
||||
|
||||
---
|
||||
|
||||
## 🚀 三种快速部署方式
|
||||
|
||||
### 方式一：SSH + Git（最快 ⭐⭐⭐⭐⭐）
|
||||
|
||||
**预计时间**: 10分钟
|
||||
|
||||
```bash
|
||||
# 第1步：SSH登录服务器
|
||||
ssh username@solarark.net
|
||||
|
||||
# 第2步：进入部署目录（根据实际路径修改）
|
||||
cd /var/www/html/g2026/g4
|
||||
|
||||
# 第3步：克隆仓库
|
||||
git clone https://gitea.solarark.net/yangyuqing/new-site.git .
|
||||
# 输入 Gitea 用户名和密码
|
||||
|
||||
# 第4步：设置权限
|
||||
sudo chown -R www-data:www-data .
|
||||
sudo chmod -R 755 .
|
||||
|
||||
# 第5步：重启 Web 服务器
|
||||
sudo systemctl restart apache2
|
||||
# 或 sudo systemctl restart nginx
|
||||
|
||||
# 第6步：测试访问
|
||||
curl -I https://solarark.net/g2026/g4/
|
||||
```
|
||||
|
||||
**完成标志**: 返回 `HTTP/1.1 200 OK`
|
||||
|
||||
---
|
||||
|
||||
### 方式二：FileZilla FTP上传（常用 ⭐⭐⭐⭐）
|
||||
|
||||
**预计时间**: 15分钟
|
||||
|
||||
#### 步骤：
|
||||
|
||||
1. **下载 FileZilla**
|
||||
```
|
||||
https://filezilla-project.org/
|
||||
```
|
||||
|
||||
2. **连接服务器**
|
||||
```
|
||||
主机: solarark.net
|
||||
用户名: [你的FTP用户名]
|
||||
密码: [你的FTP密码]
|
||||
端口: 21 (FTP) 或 22 (SFTP)
|
||||
```
|
||||
|
||||
3. **定位目录**
|
||||
```
|
||||
本地站点: d:\my_website
|
||||
远程站点: /g2026/g4/
|
||||
```
|
||||
|
||||
4. **上传文件**
|
||||
```
|
||||
选中以下文件拖拽到右侧：
|
||||
├── index.html
|
||||
├── css/
|
||||
├── js/
|
||||
├── images/
|
||||
├── .htaccess
|
||||
└── README.md
|
||||
|
||||
右键 → 上传
|
||||
```
|
||||
|
||||
5. **验证上传**
|
||||
```
|
||||
检查远程目录文件大小是否与本地一致
|
||||
确保 .htaccess 已上传（可能需要显示隐藏文件）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 方式三：Windows打包 + FTP（简单 ⭐⭐⭐）
|
||||
|
||||
**预计时间**: 20分钟
|
||||
|
||||
#### 步骤：
|
||||
|
||||
1. **运行打包脚本**
|
||||
```cmd
|
||||
cd d:\my_website
|
||||
deploy.bat
|
||||
```
|
||||
|
||||
2. **等待生成 ZIP**
|
||||
```
|
||||
生成文件: website_deploy_20260602_HHMMSS.zip
|
||||
```
|
||||
|
||||
3. **上传 ZIP 到服务器**
|
||||
```
|
||||
使用 FileZilla 上传 ZIP 到 /g2026/g4/
|
||||
```
|
||||
|
||||
4. **在服务器上解压**
|
||||
```bash
|
||||
ssh username@solarark.net
|
||||
cd /var/www/html/g2026/g4
|
||||
unzip website_deploy_*.zip
|
||||
rm website_deploy_*.zip
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ 部署后验证（必做！）
|
||||
|
||||
### 1. 基础访问测试
|
||||
```
|
||||
浏览器打开: https://solarark.net/g2026/g4/
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- ✅ 页面正常显示
|
||||
- ✅ 标题显示"雪域阳光方舟 - 轻索方舱"
|
||||
- ✅ 莫兰迪绿色调正确
|
||||
|
||||
### 2. 控制台检查（F12）
|
||||
```
|
||||
按 F12 → Console 标签
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- ✅ 无红色错误
|
||||
- ✅ 无 404 警告
|
||||
|
||||
### 3. Network 资源检查
|
||||
```
|
||||
F12 → Network 标签 → 刷新页面
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- ✅ style.css 状态码 200
|
||||
- ✅ main.js 状态码 200
|
||||
- ✅ 所有资源加载成功
|
||||
|
||||
### 4. 功能测试
|
||||
```
|
||||
✓ 点击导航栏各链接，平滑滚动
|
||||
✓ 滚动页面，导航高亮变化
|
||||
✓ 悬停卡片，有上浮效果
|
||||
✓ 缩小窗口，变为单列布局
|
||||
```
|
||||
|
||||
### 5. 移动端测试
|
||||
```
|
||||
Chrome DevTools → Toggle Device Toolbar
|
||||
选择 iPhone 12 Pro
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- ✅ 汉堡菜单可点击
|
||||
- ✅ 单列布局
|
||||
- ✅ 文字清晰可读
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 常见问题速查
|
||||
|
||||
### ❌ 问题1：页面空白
|
||||
|
||||
**快速诊断**:
|
||||
```bash
|
||||
# SSH 检查文件是否存在
|
||||
ls -la /var/www/html/g2026/g4/index.html
|
||||
ls -la /var/www/html/g2026/g4/css/style.css
|
||||
```
|
||||
|
||||
**解决**:
|
||||
- 确认文件已上传
|
||||
- 检查文件权限（应为 644 或 755）
|
||||
- 查看 Web 服务器错误日志
|
||||
|
||||
### ❌ 问题2：样式不加载
|
||||
|
||||
**快速诊断**:
|
||||
```
|
||||
F12 → Network → 查找 style.css
|
||||
如果 404，说明路径错误
|
||||
```
|
||||
|
||||
**解决**:
|
||||
```html
|
||||
<!-- 临时测试：改为绝对路径 -->
|
||||
<link rel="stylesheet" href="/g2026/g4/css/style.css">
|
||||
```
|
||||
|
||||
### ❌ 问题3：404 Not Found
|
||||
|
||||
**原因**: URL 重写未配置
|
||||
|
||||
**Apache 解决**:
|
||||
```bash
|
||||
# 检查 .htaccess 是否存在
|
||||
cat /var/www/html/g2026/g4/.htaccess
|
||||
|
||||
# 检查 Apache 配置
|
||||
sudo nano /etc/apache2/apache2.conf
|
||||
# 确保 AllowOverride All
|
||||
```
|
||||
|
||||
**Nginx 解决**:
|
||||
```nginx
|
||||
# 添加 try_files
|
||||
location /g2026/g4/ {
|
||||
try_files $uri $uri/ /g2026/g4/index.html;
|
||||
}
|
||||
```
|
||||
|
||||
### ❌ 问题4：图片不显示
|
||||
|
||||
**原因**: 图片未上传
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 检查 images 目录
|
||||
ls -la /var/www/html/g2026/g4/images/
|
||||
|
||||
# 暂时不影响展示（使用占位图）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 后续更新（超简单）
|
||||
|
||||
### Git Pull 方式（推荐）
|
||||
```bash
|
||||
ssh username@solarark.net
|
||||
cd /var/www/html/g2026/g4
|
||||
git pull origin master
|
||||
sudo systemctl restart apache2
|
||||
```
|
||||
|
||||
### FTP 覆盖方式
|
||||
```
|
||||
1. 本地修改文件
|
||||
2. git add . && git commit && git push
|
||||
3. FileZilla 重新上传修改的文件
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 紧急联系信息
|
||||
|
||||
### 如果部署失败，提供以下信息给老师：
|
||||
|
||||
```
|
||||
📍 访问地址: https://solarark.net/g2026/g4/
|
||||
⏰ 部署时间: [填写时间]
|
||||
💻 部署方式: [SSH/FTP/其他]
|
||||
❌ 遇到的问题: [详细描述]
|
||||
📸 错误截图: [如有]
|
||||
🔍 控制台错误: [复制错误信息]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎊 成功标志
|
||||
|
||||
看到以下内容即表示部署成功：
|
||||
|
||||
✅ 可以访问 https://solarark.net/g2026/g4/
|
||||
✅ 页面显示"雪域阳光方舟 - 轻索方舱"
|
||||
✅ 莫兰迪苔绿色正确显示
|
||||
✅ 卡片阴影柔和美观
|
||||
✅ 导航功能正常
|
||||
✅ 移动端适配完美
|
||||
✅ 老师验收通过
|
||||
|
||||
---
|
||||
|
||||
## 💡 小贴士
|
||||
|
||||
1. **首次部署建议先用 SSH + Git 方式**，最稳定
|
||||
2. **部署前先备份**（如果服务器已有内容）
|
||||
3. **部署后立即测试**，不要等到第二天
|
||||
4. **保留部署日志**，方便排查问题
|
||||
5. **记录服务器路径**，下次更新用
|
||||
|
||||
---
|
||||
|
||||
**祝你一次部署成功！** 🚀✨
|
||||
|
||||
*快速参考：详细文档请查看 DEPLOY_GUIDE.md*
|
||||
Reference in New Issue
Block a user