Surge Mac规则设置指南

Surge Mac 是一个高效的静态网站部署工具，支持通过配置文件（surge.json）进行自定义设置，以下是常见规则的设置说明,帮助你优化网站性能和安全性。

基本规则

文件类型

• ``：匹配任意文件。
• *.html：匹配 HTML 文件。
• *.js：匹配 JavaScript 文件。
• *.css：匹配 CSS 文件。
• *.jpg、*.png、*.gif：匹配图片文件。

网页配置

• "$surge": true：启用 Surge，自动部署到 CDN。
• "dist": true：部署构建后的文件到 dist 目录。

无关文件

• 忽略隐藏文件。
• "!.git"：忽略 Git 目录。
• "!.env"：忽略 .env 文件。

错误处理

• "404": "/404.html"：指定 404 错误页面。
• "500": "/500.html"：指定 500 错误页面。

路径映射

文件路径

• "**": "/dist/"：将根目录映射到 /dist/,适用于构建后的静态文件。

静态资源

• "images/**": "/images/"：将 images 目录映射到 /images/,方便图片访问。

代码优化

JS 和 CSS 压缩

• "js": true：压缩 JS 文件。
• "css": true：压缩 CSS 文件。

构建工具

• "build": true：执行构建脚本，例如使用 webpack 或 rollup。

安全设置

防止 XSS 攻击

• "xss": false：默认启用,建议根据项目需求调整。

防止 CSRF 攻击

• "csrf": false：默认启用,建议根据项目需求调整。

防止未授权访问

• "restrict": true：限制访问未列出的文件。

高级配置

环境变量

• "env": ["key=your-value"]：传递环境变量。

缓存时间

• "cache": "1h"：设置缓存时间,避免频繁刷新。

Gzip 压缩

• "gzip": true：启用 Gzip 压缩,减少传输数据量。

CDN

• "cdn": "https://your-cdn.com"：指定 CDN 域名。

示例配置

{
  "basic": true,
  "fileTypes": ["**"],
  "xss": false,
  "restrict": true,
  "cache": "1h",
  "build": true,
  "surge": true,
  "dist": true,
  "paths": [
    {"source": "**", "to": "/dist/"},
    {"source": "images/**", "to": "/images/"}
  ],
  "env": ["NODE_ENV=production"]
}

注意事项

• 合理配置：根据项目需求设置,避免过度优化导致问题。
• 测试环境：建议在测试环境中验证配置是否正确。
• 自动化：可以使用脚本自动化构建和部署过程。

希望这些设置能帮助你更好地利用 Surge Mac,提升网站性能和用户体验！