Surge是一个非常流行的静态网站部署工具，支持文件的快速推送。配置文件通常是一个JSON格式的文件，名称为surge.json，位于你的项目根目录下。以下是Surge配置文件的常见内容和结构

Surge配置文件示例

{
  "front": {
    "url": "https://yourdomain.com",
    "path": "/"
  },
  "backend": {
    "url": "https://yourbackenddomain.com",
    "path": "/api"
  },
  "cname": "yourdomain.com",
  "bind": {
    "host": "yourdomain.com",
    "port": 443
  },
  "deploy": {
    "source": [
      "dist/**/*",
      "!*.DS-",
      "!*.git*",
      "!*.env*",
      "!*.log*"
    ],
    "keep": 3,
    "force": true,
    "parallel": true,
    "incremental": true
  },
  "monitors": [
    {
      "name": "github",
      "url": "https://api.github.com/repos/YOUR-REPO/statuses/{commit}",
      "token": "YOUR-GITHUB-TOKEN"
    }
  ],
  "error-report": {
    "email": "your.email@example.com"
  },
  "additional": {
    "headers": [
      "X-Frame-Options: DENY",
      "X-Content-Type-Options: nosniff"
    ],
    "custom": {
      "key": "value"
    }
  }
}

配置文件解释

1. front:

   • 用于配置前端的域名和路径。
   • "url": "https://yourdomain.com"：前端应用的域名。
   • "path": "/"：前端应用的路径。

2. backend:

   • 用于配置后端服务的域名和路径。
   • "url": "https://yourbackenddomain.com"：后端服务的域名。
   • "path": "/api"：后端服务的路径。

3. cname:

   • 如果你已经有自己的域名并想将其绑定到Surge上,可以指定CNAME。
   • 值通常是你的域名，比如yourdomain.com。

4. bind:

   • 配置绑定选项。
   • "host": "yourdomain.com"：绑定的域名。
   • "port": 443：绑定的端口（通常是443，用于HTTPS）。

5. deploy:

   • 配置部署选项。
   • source：定义要部署的文件或文件夹。
     • ["dist/**/*"]：匹配dist目录下的所有文件。
     • !*.DS-：排除隐藏文件。
     • !*.git*：排除.git目录和文件。
     • !*.env*：排除.env文件。
     • !*.log*：排除日志文件。
   • keep: 部署时保留的旧版本数量（默认为3）。
   • force: 强制重新部署（默认为true）。
   • parallel: 是否并行处理文件（默认为true）。
   • incremental: 是否只部署有变化的文件（默认为true）。

6. monitors:

   • 配置监控选项。
   • 支持GitHub、GitLab、Bitbucket等平台的构建状态监控。
   • 每个监控项需要配置仓库名称、URL和token。

7. error-report:

   • 配置错误报告选项。
   • "email": "your.email@example.com"：指定收错误报告的邮箱。

8. additional:

   • 提供额外的设置。
   • "headers"：添加额外的HTTP头。
   • "custom"：自定义的配置项。

使用说明

1. 创建surge.json文件。
2. 填写相应的配置信息。
3. 运行以下命令部署：

surge push -p ./dist/

示例

如果你想快速配置一个简单的静态网站，surge.json文件可以是：

{
  "front": {
    "url": "https://yourdomain.com",
    "path": "/"
  },
  "cname": "yourdomain.com",
  "bind": {
    "host": "yourdomain.com",
    "port": 443
  }
}

注意事项

• 确保你有一个dist或build目录,里面包含你的静态文件。
• 如果你使用自签名证书（比如Let's Encrypt），记得在bind中设置正确的host和port。
• 部署后可以通过Surge的管理界面查看你的网站状态。

希望这个配置文件示例能帮助你快速上手使用Surge！