步骤 1:安装Surge
确保你已安装Surge,打开终端,并运行以下命令:
npm install -g surge
步骤 2:初始化Surge并关联GitHub仓库
在终端中执行:
surge init
根据提示输入你的GitHub用户名和仓库名称,当你完成初始化后,Surge会生成一个surge.json文件。
步骤 3:配置surge.json文件
编辑位于~/Surge ~/.surge的surge.json文件,添加以下配置:
{
"project": "your-project-name",
"domain": "yourdomain.com",
"origin": "https://yourgithubrepo.git.io",
"path": "dist/",
"branch": "main"
}
project:项目名称,用于区分多个项目。domain:你注册的域名。origin:你的GitHub仓库URL,确保仓库是公开的。path:指定静态文件目录,通常是dist/。branch:部署的分支,默认为main。
步骤 4:配置域名规则文件
创建或编辑位于~/Surge ~/.surge/rules的文件,添加以下内容:
echo "mydomain.com, https://yourgithubrepo.git.io" >> ~/Surge ~/.surge/rules
将mydomain.com替换为你的域名,yourgithubrepo.git.io替换为你的GitHub仓库路径。
步骤 5:部署静态文件
运行以下命令将文件推送到Surge:
surge push
步骤 6:配置域名解析(如有必要)
登录到你注册域名提供商的账户,找到DNS记录,添加一个CNAME记录:
- 名称:
- 类型:CNAME
- 目标:
surge.sh(Surge提供的IP地址) - TTL:自动
确保DNS更改生效,通常需要几小时。
测试访问
在浏览器中打开http://yourdomain.com,检查是否正确部署。
额外设置
- 多个项目:在
surge.json中使用project字段区分项目。 - 端口转发:在
surge.json中添加forwarding字段,配置端口。 - 其他托管平台:如使用Bitbucket,修改
origin为https://your-bitbucketrepo.git.io。
通过以上步骤,你应该能够成功设置Surge并配置域名访问规则,如果遇到问题,检查文件路径和配置是否正确,确保域名解析和服务器配置无误。








