1.前置条件

• 服务器环境：你需要一台可以上网的服务器，支持安装以下软件：
  • 操作系统：Linux（推荐）或 Windows（虽然支持，但配置可能不同）。
  • Web 服务器：Nginx（推荐）或 Apache。
  • 编程语言：Node.js（推荐）。
  • 数据库：MySQL 或 MongoDB（可选）。
  • 域名：已注册并指向服务器的域名。

安装Node.js

• Linux/macOS：
  • 使用Nginx安装Node.js：

    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt-get install -y nodejs

  • 验证安装：

    node -v
    npm -v

• Windows：

  下载并安装最新版本的 Node.js。

安装SSR

• 下载SSR

  • 访问 SSR的官方网站 或 GitHub仓库。
  • 下载对应的版本（根据你的Node.js版本选择）。

• 安装SSR

  npm install -g @docusaurus/sss

  或者

  npm install -g sss@latest

创建项目

• 初始化项目

  sss new my-website

  • my-website 是你项目的名称。
  • 这会创建一个新目录 my-website,包含项目文件。

• 进入项目目录

  cd my-website

配置项目

• 修改sidekick.config.js

  • 打开 sidekick.config.js，根据需要配置：

    module.exports = {
      type: 'website', // 必须是'website'
      out: 'dist', // 输出路径
      static: 'static', // 静态文件路径
      routes: [
        {
          path: '/',
          component: 'Home'
        }
      ]
      // 其他配置（如数据库、API等）
    }

• 安装组件（如需）

  npm install sss-component-example

构建项目

• 运行开发服务器

  npm run dev

  • 服务器会自动打开浏览器，访问 http://localhost:7001。

部署到服务器

• 使用Nginx配置反向代理

  • 创建Nginx配置文件（例如nginx.conf）：

    events {}
    http {
        server {
            listen 80;
            server_name your-domain.com;
            root /path/to/your-website/dist;
            location / {
                proxy_pass http://localhost:7001;
                proxy_set_header Host $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header X-Forwarded-Proto $scheme;
            }
        }
    }

  • 安装Nginx：

    sudo apt-get install -y nginx

  • 启动并重启Nginx：

    sudo systemctl start nginx
    sudo systemctl enable nginx

• 上传文件到服务器

  • 将项目构建后的dist文件夹上传到服务器指定路径。

测试

• 访问服务器上的域名,确认页面是否正确加载。
• 检查是否有错误提示,根据日志进行故障排除。

后续操作

• 构建生产版

  npm run build

• 部署到生产服务器

  使用CI/CD工具自动化部署。

• 维护与更新
  • 定期更新SSR和相关组件。
  • 备份数据库和静态文件。

常见问题

• 权限问题：确保Nginx有足够的权限访问文件。
• 端口冲突：确认服务器和本地端口没有冲突。
• SSL配置：如果需要 HTTPS,配置SSL证书。

希望这篇指南能帮助你顺利安装和配置SSR！如果有其他问题，可以参考 SSR的官方文档 或在相关社区求助。