5.9 KiB
5.9 KiB
⚡ 快速部署操作手册
🎯 目标
将网站部署到：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分钟
# 第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分钟
步骤：
-
下载 FileZilla
https://filezilla-project.org/ -
连接服务器
主机: solarark.net 用户名: [你的FTP用户名] 密码: [你的FTP密码] 端口: 21 (FTP) 或 22 (SFTP) -
定位目录
本地站点: d:\my_website 远程站点: /g2026/g4/ -
上传文件
选中以下文件拖拽到右侧： ├── index.html ├── css/ ├── js/ ├── images/ ├── .htaccess └── README.md 右键 → 上传 -
验证上传
检查远程目录文件大小是否与本地一致 确保 .htaccess 已上传（可能需要显示隐藏文件）
方式三：Windows打包 + FTP（简单 ⭐⭐⭐）
预计时间: 20分钟
步骤：
-
运行打包脚本
cd d:\my_website deploy.bat -
等待生成 ZIP
生成文件: website_deploy_20260602_HHMMSS.zip -
上传 ZIP 到服务器
使用 FileZilla 上传 ZIP 到 /g2026/g4/ -
在服务器上解压
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：页面空白
快速诊断:
# 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，说明路径错误
解决:
<!-- 临时测试：改为绝对路径 -->
<link rel="stylesheet" href="/g2026/g4/css/style.css">
❌ 问题3：404 Not Found
原因: URL 重写未配置
Apache 解决:
# 检查 .htaccess 是否存在
cat /var/www/html/g2026/g4/.htaccess
# 检查 Apache 配置
sudo nano /etc/apache2/apache2.conf
# 确保 AllowOverride All
Nginx 解决:
# 添加 try_files
location /g2026/g4/ {
try_files $uri $uri/ /g2026/g4/index.html;
}
❌ 问题4：图片不显示
原因: 图片未上传
解决:
# 检查 images 目录
ls -la /var/www/html/g2026/g4/images/
# 暂时不影响展示（使用占位图）
🔄 后续更新（超简单）
Git Pull 方式（推荐）
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/
✅ 页面显示"雪域阳光方舟 - 轻索方舱"
✅ 莫兰迪苔绿色正确显示
✅ 卡片阴影柔和美观
✅ 导航功能正常
✅ 移动端适配完美
✅ 老师验收通过
💡 小贴士
- 首次部署建议先用 SSH + Git 方式，最稳定
- 部署前先备份（如果服务器已有内容）
- 部署后立即测试，不要等到第二天
- 保留部署日志，方便排查问题
- 记录服务器路径，下次更新用
祝你一次部署成功！ 🚀✨
快速参考：详细文档请查看 DEPLOY_GUIDE.md