安装 Surge
在不同的操作系统上安装 Surge:
- macOS:
npm install -g surge
- Windows:
npm install -g surge
- Linux:
npm install -g surge
初始化 Surge
在项目根目录中创建一个 surge.json 文件:
{
"surge": true,
"git": "git://your-repo.git",
"dom": "yourdomain.surge.sh",
"branch": "main"
}
git:你的项目的 git 地址。dom:你希望你的项目在 Surge 上显示的域名,Surge 会自动将你的项目缩短到这个域名。branch:你希望部署的分支(默认是main)。
推送到 Surge
在项目根目录中运行以下命令:
surge push
Surge 会读取你的 surge.json 文件,准备好部署你的项目。
访问你的项目
- 浏览器:打开
http://yourdomain.surge.sh。 - 命令行:
curl -o http://yourdomain.surge.sh
本地调试
在本地运行你的项目后,Surge 也可以帮助你在本地开启一个服务器,方便你预览和调试:
surge serve
配置域名和 HTTPS
-
自定义域名:
- 注册一个域名(如
yourdomain.com)。 - 在你的 DNS 提供商配置 CNAME 记录,将
yourdomain.com指向 Surge 生成的 IP 地址。 - 在
surge.json中更新dom为你的域名。 - 运行
surge push --domain yourdomain.com。
- 注册一个域名(如
-
HTTPS: Surge 提供了免费的 HTTPS 状态,自动在
yourdomain.surge.sh上为你配置 SSL,对于自定义域名,可以自己购买 SSL 证书并配置。
常见问题
-
权限问题:
- 确保你有权限访问项目目录。
- 使用
sudo如果需要。
-
错误处理:
- 查看 Surge 的日志:
surge --log - 检查项目依赖是否安装:
npm install或yarn install
- 查看 Surge 的日志:
删除部署
如果你想删除旧的部署,可以运行:
surge delete
其他命令
- 更新项目:
surge push --update - 重新部署:
surge push --force
希望这些步骤能帮助你快速上线项目!如果有问题,可以查阅 Surge 文档 或社区获取支持。









