Surge规则配置指南

Surge是一款流行的静态网站部署工具,通过简单的YAML配置文件，用户可以轻松定义域名、路径、404错误页面等规则，本文将详细指导如何配置Surge规则，帮助用户高效管理静态网站。

了解Surge规则配置文件

Surge的核心配置文件是surge.yaml或surge.json，根据文件扩展名的不同，配置方式略有不同，配置文件的结构包括以下几个关键部分：

1. 项目名称：用于标识项目，配置为project: "项目名称"。
2. 入口文件：指定应用的入口文件，常用于前端框架，如from: "入口文件名"。
3. 域名规则：定义域名和路径映射关系，格式为host: "域名.com"，path: "/"（默认）。
4. 404错误页：配置404错误页面路径，如error: "404.html"。
5. 部署命令：自定义部署脚本，扩展功能。

自定义域名与路径映射

在Surge配置中,域名和路径的映射是核心功能之一，用户可以根据需求定义多个域名和路径组合。

host: "www.example.com"
path: "/"

如果需要将不同目录部署到不同域名,可以添加多个host和path组合：

host: "www.sub.example.com"
path: "/subpath"

配置404错误页面

默认情况下,Surge会自动生成404页面，但用户可以自定义错误页面路径：

error: "404.html"

扩展部署命令

Surge支持通过surge deploy命令扩展功能，用户可以在surge.yaml中添加自定义脚本：

build: |
  echo "构建完成..."
  mv build/* ./
deploy: |
  echo "部署中..."
  surge deploy --remote-only

Nginx反向代理配置

对于需要通过Nginx代理的项目,可以在Surge配置中添加Nginx相关规则：

nginx: |
  server {
    listen 80;
    server_name your_domain.com;
    location / {
      proxy_pass http://your_domain:port;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
    }
  }

常见问题与解决

1. 域名解析问题：检查DNS记录是否正确，确保域名解析到正确的IP地址。
2. 路径映射错误：检查surge.yaml文件中host和path是否正确配对。
3. 部署失败：确保Surge命令执行权限，检查网络连接是否正常。

优化与维护

• 定期检查Surge配置文件,确保所有规则准确无误。
• 对于多环境部署,可以通过配置文件扩展使用环境变量或分支策略。
• 使用工具自动化配置,如actions插件，提升部署效率。

通过以上配置,用户可以充分利用Surge的强大功能，轻松管理静态网站的域名、路径和错误页等规则，提升部署效率和用户体验。