Surge Mac 使用指南

Surge 是一个基于云的持久化服务，专为开发者和团队设计，简化了构建和部署 Web 应用，无论你是独立开发者还是团队成员，Surge 都能帮助你快速部署应用，减少服务器管理的负担，以下是 Surge 在 Mac 上的使用指南,帮助你快速上手并高效工作。

安装 Surge

你需要在 Mac 上安装 Surge,可以通过以下步骤完成安装：

1. 下载 Surge：

   • 访问 Surge官网 或通过终端使用 curl 命令直接下载。
   • 使用以下命令安装：

     curl -L https://surge.sh/|bash

   • 这将下载并安装 Surge latest 版本。

2. 配置 Surge：

   • 安装完成后，启动 Surge：

     surge

   • Surge 会自动生成一个默认的配置文件，位于 ~/.surge/config。
   • 修改配置文件以设置你的项目域名和其他选项。

3. 初始化 Git 仓库：

   如果你使用 Git，确保项目仓库已经初始化，Surge 可以直接读取 Git 提交信息,自动构建。

创建新项目

1. 在终端中创建项目：

   • 进入你的项目目录，运行：

     surge init

   • 这将创建一个新的 Surge 项目，包含 public 和 private 目录，以及一个 surge.json 配置文件。

2. 通过命令行工具操作：

   • Surge 提供了多种命令行工具来操作项目：
     • surge add：将项目内容推送到 Surge。
     • surge push：重新构建和部署项目。
     • surge preview：查看项目 preview URL。
     • surge logout：退出当前项目。

配置 Surge

• 修改配置文件：

  • 打开 surge.json 文件,修改内容以匹配你的项目需求。
  • 常用配置选项包括：
    • domain：指定域名。
    • static：指定静态文件目录。
    • surrogate：启用反向代理,处理动态路由。
    • git：关联 Git 仓库,自动构建。

• 启用反向代理：

  • 如果需要处理动态内容，可以在 surge.json 中启用 surrogate：

    {
      "surrogate": "surge static",
      "source": "src/**",
      "public": "public/**"
    }

  • 这将允许你在 Surge 上部署 Express 或其他 Web 框架应用。

部署应用

1. 推送项目到 Surge：

   • 在项目根目录运行：

     surge push

   • Surge 会构建项目，上传到云端,并自动更新域名解析。

2. 查看项目预览：

   • 使用 surge preview 命令获取项目的 preview URL,方便测试。

3. 多项目管理：

   • Surge 支持同时管理多个项目,使用不同的配置文件。
   • 在终端中切换项目使用：

     surge --project config.json

使用命令行工具

• 构建命令：

  • surge build：生成构建文件,适合离线部署。

• 部署命令：

  • surge deploy：将构建文件推送到 Surge。

• 删除项目：

  • surge delete：删除项目并释放域名。

集成测试

• 自动化测试：

  • Surge 集成了 Jest 测试框架,可以在项目中添加测试文件。
  • 使用 surge test 命令运行测试,确保代码质量。

• 持续集成：

  配置 GitHub Actions，自动化测试和部署流程,确保每次提交都能构建和部署。

使用命令行工具高效操作

• 快速切换项目：

  使用命令行参数或配置文件快速切换项目,避免重复输入密码。

• 自动化流程：

  Surge 提供了丰富的 CLI 工具，支持自定义脚本，自动化部署流程,提升效率。

注意事项

• 域名解析：

  确保域名已经解析到你的 Surge 项目地址,避免访问域名解析问题。

• 权限问题：

  确保 Surge 和项目文件有正确的权限,避免权限不足导致部署失败。

• 数据安全：

  Surge 将数据存储在云端，确保项目和数据的安全性,遵守相关的数据保护法规。

通过遵循以上步骤，你可以快速上手 Surge，并高效地部署应用，Surge 提供了强大的功能，帮助开发者专注于代码，而不是服务器管理，希望这篇指南能帮助你顺利使用 Surge,提升开发效率！