DEPLOY-GUIDE

产品云相册官网 - 部署指南

🚀 部署方案

由于是生产环境,请选择以下安全的部署方式:


方案一:使用上传脚本(推荐)

FTP 方式

  1. 编辑上传脚本
   cd docs/website
   nano upload.sh
   
  1. 修改配置信息
   FTP_HOST="ftp.yourserver.com"     # 改成你的FTP地址
   FTP_USER="your_username"           # 改成你的用户名
   FTP_PASS="your_password"           # 改成你的密码
   FTP_PATH="/public_html/"           # 改成网站根目录
   
  1. 执行上传
   chmod +x upload.sh
   ./upload.sh
   

SSH 方式(更安全)

  1. 编辑上传脚本
   cd docs/website
   nano upload-ssh.sh
   
  1. 修改配置信息
   SSH_HOST="yourserver.com"          # 改成你的服务器地址
   SSH_USER="your_username"           # 改成你的用户名
   SSH_PORT="22"                      # SSH端口
   SSH_PATH="/var/www/html/"          # 改成网站根目录
   
  1. 执行上传
   chmod +x upload-ssh.sh
   ./upload-ssh.sh
   

方案二:使用 FTP 工具(图形界面)

推荐工具

  • Windows: FileZilla、WinSCP
  • Mac: Cyberduck、FileZilla
  • Linux: FileZilla

上传步骤

  1. 下载并安装 FTP 工具
  2. 连接到服务器
  3. 找到网站根目录
  4. 上传 docs/website 里的所有文件

方案三:使用免费静态托管(零成本)

GitHub Pages(完全免费)

  1. 在 GitHub 创建仓库
  2. 上传网站文件
  3. 开启 GitHub Pages
  4. 获得免费域名:https://yourname.github.io/repo-name

Netlify(完全免费)

  1. 注册 Netlify 账号
  2. 拖拽上传网站文件夹
  3. 获得免费域名:https://your-site.netlify.app
  4. 支持自定义域名

Vercel(完全免费)

  1. 注册 Vercel 账号
  2. 导入项目
  3. 获得免费域名:https://your-site.vercel.app
  4. 支持自定义域名

方案四:使用宝塔面板(如果有)

如果你的服务器安装了宝塔面板:

  1. 登录宝塔面板
  2. 找到网站目录
  3. 使用文件管理器上传
  4. 或使用在线解压功能

📋 上传文件清单

确保上传以下所有文件:

✅ index.html              # 首页
✅ docs.html               # 文档中心
✅ cases.html              # 客户案例
✅ about.html              # 关于我们
✅ docs/                   # 文档目录
   ✅ pc/index.html        # PC端文档
   ✅ mobile/index.html    # 手机端文档
   ✅ pc/index-md.html     # Markdown版文档
   ✅ pc/markdown/*.md     # Markdown文件
✅ README.md               # 说明文档
✅ MARKDOWN-GUIDE.md       # Markdown使用指南

🔍 上传后验证

1. 检查首页

访问:http://你的域名/index.html

应该看到产品云相册首页。

2. 检查文档

点击"PC端操作文档"或"手机端操作文档",确认可以正常访问。

3. 检查响应式

用手机访问,确认页面可以正常显示。


⚠️ 常见问题

问题1:页面无法访问

解决方案

  • 检查文件是否全部上传
  • 检查文件路径是否正确
  • 检查服务器是否正常运行

问题2:Markdown 文档无法加载

解决方案

  • 确认 Markdown 文件路径正确
  • 确认服务器支持静态文件访问
  • 尝试使用纯 HTML 版本(index.html)

问题3:样式显示异常

解决方案

  • 清除浏览器缓存
  • 检查 CSS 文件是否上传完整


🛠️ 推荐的生产环境配置

Nginx 配置

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/html;
    index index.html;

location / {

try_files $uri $uri/ =404;

}

# 启用 Gzip 压缩

gzip on;

gzip_types text/html text/css application/javascript;

}

Apache 配置


    ServerName your-domain.com
    DocumentRoot /var/www/html

Options Indexes FollowSymLinks

AllowOverride All

Require all granted


📞 需要帮助?

如果遇到问题,请提供:

  1. 服务器类型(Apache/Nginx/宝塔等)
  2. 错误信息截图
  3. 访问的具体 URL

我可以帮你排查问题!


安全提醒

  • ❌ 不要在聊天中提供 FTP/SSH 密码
  • ✅ 使用脚本上传,密码保存在本地
  • ✅ 定期更换服务器密码
  • ✅ 使用 SSH 密钥登录(比密码更安全)