Jiao77/astro-jiao77.cn

Fork 0

Files

Jiao77 9c0051c92b initial commit

2025-09-29 05:57:18 +08:00

4.6 KiB

Raw Blame History

🚀 部署指南

将您的 Astro 网站部署到 jiao77.cn (110.42.70.70) 服务器的完整步骤。

📋 部署前准备

1. 确认服务器环境

登录到您的服务器并检查：

# SSH 连接到服务器
ssh root@110.42.70.70  # 或您的用户名

# 检查 Apache 状态
sudo systemctl status apache2

# 检查 Apache 网站根目录
ls -la /var/www/jiao77.cn/

# 检查 Apache 模块
apache2ctl -M | grep -E "(rewrite|deflate|expires|headers)"

2. 启用必要的 Apache 模块

如果模块未启用，请运行：

sudo a2enmod rewrite
sudo a2enmod deflate  
sudo a2enmod expires
sudo a2enmod headers
sudo systemctl reload apache2

🚀 部署步骤

方法一：自动部署 (推荐)

构建项目

npm run build

运行部署脚本

./deploy.sh

按提示输入服务器用户名和网站根目录路径。

方法二：手动部署

构建项目

npm run build

压缩文件

cd dist
tar -czf ../website.tar.gz *
cd ..

上传到服务器

scp website.tar.gz root@110.42.70.70:/tmp/

在服务器上解压

ssh root@110.42.70.70
cd /var/www/html
sudo rm -rf *  # 清空现有文件 (请谨慎!)
sudo tar -xzf /tmp/website.tar.gz -C /var/www/html/
sudo chown -R www-data:www-data /var/www/html/
sudo chmod -R 755 /var/www/html/

方法三：使用 rsync (最佳选择)

# 直接同步 dist 目录内容
rsync -avz --delete --progress dist/ root@110.42.70.70:/var/www/html/

⚙️ Apache 配置

1. 配置虚拟主机 (可选但推荐)

将 apache-config.conf 的内容添加到您的 Apache 配置中：

# 在服务器上
sudo nano /etc/apache2/sites-available/jiao77.conf
# 粘贴 apache-config.conf 的内容

# 启用站点
sudo a2ensite jiao77.conf
sudo systemctl reload apache2

2. 上传 .htaccess 文件

确保 .htaccess 文件已上传到网站根目录：

scp .htaccess root@110.42.70.70:/var/www/html/

🔧 服务器优化

1. 设置正确的文件权限

sudo chown -R www-data:www-data /var/www/html/
sudo find /var/www/html/ -type d -exec chmod 755 {} \;
sudo find /var/www/html/ -type f -exec chmod 644 {} \;

2. 配置防火墙 (如果启用)

sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS

📊 部署后检查

1. 功能测试

访问 http://jiao77.cn 或 http://110.42.70.70
检查首页导航卡片是否正常显示
访问 /reports 页面确认报告组件正常
测试页眉展开/收缩功能
检查移动端响应式设计
验证动画效果是否流畅

2. 性能测试

# 使用 curl 测试压缩
curl -H "Accept-Encoding: gzip" -I http://jiao77.cn

# 检查响应时间
curl -o /dev/null -s -w "时间: %{time_total}s\n" http://jiao77.cn

3. 在线工具检测

GTmetrix - 性能分析
PageSpeed Insights - Google 性能评分
SSL Labs - SSL 配置检测 (如果使用 HTTPS)

🔄 更新部署流程

当您需要更新网站时：

修改代码
重新构建: npm run build
部署: ./deploy.sh

🛡️ SSL/HTTPS 配置 (推荐)

1. 获取免费 SSL 证书 (Let's Encrypt)

sudo apt update
sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d jiao77.cn -d www.jiao77.cn

2. 自动续期

sudo crontab -e
# 添加这行：
0 12 * * * /usr/bin/certbot renew --quiet

🐛 故障排除

问题1：页面不显示或显示 Apache 默认页

检查文件权限
确认 DocumentRoot 配置正确
查看 Apache 错误日志：sudo tail -f /var/log/apache2/error.log

问题2：CSS/JS 文件加载失败

检查 .htaccess 文件是否正确上传
确认 mod_rewrite 模块已启用
检查文件路径是否正确

问题3：动画效果不工作

检查 JavaScript 控制台错误
确认所有资源文件都已上传
验证 Content-Security-Policy 配置

问题4：移动端显示异常

检查 viewport meta 标签
验证响应式 CSS 是否正确加载
测试不同设备和浏览器

📞 技术支持

如果遇到部署问题，请检查：

Apache 错误日志：/var/log/apache2/error.log
Apache 访问日志：/var/log/apache2/access.log
浏览器开发者工具控制台
网络连接和防火墙设置

📈 监控和维护

建议设置：

定期备份网站文件
监控服务器资源使用情况
定期更新 Apache 和系统安全补丁
设置网站监控服务检测可用性

4.6 KiB Raw Blame History Unescape Escape