Surge配置教程

Surge是一个强大的静态文件推送工具，能够帮助开发者快速部署和更新静态网站，以下是Surge的详细配置教程,帮助你高效地使用Surge进行项目部署。

安装Surge工具

你需要安装Surge工具,可以通过以下命令安装：

npm install -g surge

如果你使用Yarn,可以执行以下命令：

yarn global add surge

安装完成后,Surge会被添加到你的全局执行路径中。

创建Surge配置文件

Surge的配置文件通常命名为surge.json，位于你的项目根目录下,配置文件的内容如下：

{
  "surge": {
    "app": "your-app-name",
    "domain": "your-domain.com",
    "project": "path/to/your/project",
    "branch": "main",
    "prefix": [],
    "sourcemap": true,
    "external": true,
    "static": true,
    "routes": {}
  }
}

• app：项目应用名,用于标识你的应用。
• domain：指定要部署到的域名。
• project：项目的路径,Surge会从该路径构建静态文件。
• branch：指定要部署的分支，默认为main。
• prefix：自定义路径前缀,用于更复杂的部署。
• sourcemap：是否生成源地地图文件。
• external：是否为应用外部链接提供服务。
• static：是否启用静态文件模式。
• routes：配置路由规则,用于处理动态路由。

配置域名和CNAME记录

在配置文件中，添加CNAME记录,指向Surge的服务器：

"CNAME": "your-app-name.surge.sh"

在你的域名提供商处，设置A记录，将your-domain.com指向Surge的IP地址，Surge的IP地址为181.168.168或255.140.160。

使用Surge进行部署

执行以下命令从本地构建项目并推送到Surge：

surge your-project/

Surge会构建项目，上传文件，并自动生成配置，你可以通过浏览器访问http://your-domain.com查看部署结果。

配置静态文件路径

在surge.json中，确保静态文件路径正确,如果你的项目结构如下：

your-project/
├── static/
│   └── index.html
└── surfer.json

Surge会自动处理这些文件，并将它们部署到/static路径。

高级配置（可选）

1 自定义域名

如果你有自己的域名,可以在配置文件中添加：

"CNAME": "your-app-name.your-domain.com"

2 设置A记录

在域名提供商处，创建A记录，将www.your-domain.com指向Surge的IP地址。

3 使用SSL证书

Surge支持自动获取免费的Let's Encrypt SSL证书,你可以手动在配置文件中添加：

"certificate": "your-certificate.pem",
"private_key": "your-private-key.pem"

4 优化构建过程

使用surge build命令优化构建时间,删除不需要的文件或优化代码。

使用案例

假设你有一个简单的React项目，位于app/目录下,Surge配置文件如下：

{
  "surge": {
    "app": "my-react-app",
    "domain": "my-react-app.com",
    "project": "app",
    "branch": "main",
    "sourcemap": true,
    "external": true,
    "static": false,
    "routes": {
      "/": "index.html",
      "/about": "about.html"
    }
  }
}

构建并推送：

surge app/

访问http://my-react-app.com即可查看应用。

常见问题

• 域名解析延迟：确保域名解析完成后,访问才会正常。
• 证书重载：更新证书后,可能需要几小时才能生效。
• 路由问题：检查surge.json中的路由配置是否正确。

Surge是一个强大的工具，适合快速部署静态项目，通过配置surge.json，你可以定制推送行为，支持多种编程语言和框架，掌握以上配置方法,你可以轻松实现静态项目的快速部署和更新。

如果你有更多问题，可以参考Surge的官方文档或社区获取帮助,祝你在使用Surge时一切顺利！