-
创建
surge.json文件:在项目根目录下新建一个名为surge.json的文件。 -
配置基本信息:
- 项目名称:在
project字段中指定项目名称。 - 源管理:在
source字段中指定源文件或Git仓库,如果从本地文件系统读取,设置为;如果使用Git,设置为"git://github.com/username/repository.git"。
- 项目名称:在
-
指定目标路径和文件:
- 目标路径:在
surge.target中指定部署到的文件夹。 - 文件名:在
surge.file中指定入口文件,如index.html。
- 目标路径:在
-
配置远程服务器:
- 主机名:设置
remote.host为目标域名。 - 端口:设置
remote.port为80(HTTP)或443(HTTPS)。 - 身份验证:如有必要,添加用户名、密码、private_key等。
- 主机名:设置
-
启用实验功能(可选):
- 保持连接:在
experimental.keepalive中设置延迟,如5分钟。 - 自动化脚本:在
experimental.before中添加预部署命令,如构建和复制文件。
- 保持连接:在
-
保存并验证配置:
- 确保所有路径和信息正确无误。
- 使用
surge config验证配置文件。 - 运行
surge push进行部署。
示例配置文件:
{
"project": "my-static-site",
"source": "dist",
"surge": {
"target": "dist",
"file": "index.html"
},
"remote": {
"host": "yourdomain.com",
"port": 80,
"username": "username",
"password": "password",
"protocol": "https"
},
"experimental": {
"keepalive": 5,
"before": ["npm run build", "cp -r dist/* dist"]
}
}
步骤说明:
-
创建文件:在项目根目录下创建
surge.json。 -
填写项目名称:在
project字段中输入项目名称。 -
源管理配置:
- 如果使用本地文件,设置
source为。 - 如果使用Git仓库,设置为Git URL,并可选指定分支。
- 如果使用本地文件,设置
-
目标路径和文件:
target为部署的文件夹,通常为dist。file为入口文件,如index.html,或者留空以使用默认文件。
-
远程服务器配置:
host为目标域名。port为目标端口,默认为80(HTTP)或443(HTTPS)。- 可选
username、password、private_key等,视需求而定。
-
实验功能:
keepalive用于防止连接超时,建议设置为正整数。before用于预执行部署前的脚本,例如构建和部署。
-
保存并验证:
- 确认所有路径正确。
- 使用
surge config验证配置文件。 - 运行
surge push开始部署。
通过以上步骤,你可以根据项目需求自定义Surge配置文件,实现静态网站的快速部署。




