From e418f03f0c4ae74652b1247060e63a9c5dbc2452 Mon Sep 17 00:00:00 2001
From: yangyuqing <1614872855@qq.com>
Date: Tue, 2 Jun 2026 16:36:39 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=BF=AB=E9=80=9F=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=93=8D=E4=BD=9C=E6=89=8B=E5=86=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 QUICK_DEPLOY.md | 310 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 310 insertions(+)
 create mode 100644 QUICK_DEPLOY.md

diff --git a/QUICK_DEPLOY.md b/QUICK_DEPLOY.md
new file mode 100644
index 0000000..f310f23
--- /dev/null
+++ b/QUICK_DEPLOY.md
@@ -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*