需要安装 Surge CLI:
npm install -g surge
或者使用 Yarn:
yarn global add surge
创建项目
进入项目目录,创建一个基本的文件结构:
mkdir my-project cd my-project
创建 package.json 文件:
{
"name": "my-project",
"version": "1..",
"private": true,
"scripts": {
"start": "surge serve"
}
}
创建 src 文件夹,添加一个简单的 HTML 文件:
<!DOCTYPE html> <html> <head>My Surge Site</title> </head> <body> <h1>Hello from Surge</h1> </body> </html>
配置 Surge
在项目根目录创建 surge.json 文件:
{
"surge": {
"app": "src",
"domain": "yourdomain.com",
"port": 300
}
}
如果你使用的是 GitHub 项目,需要在 package.json 中添加 Git 提交信息:
{
"name": "my-project",
"version": "1..",
"private": true,
"scripts": {
"start": "surge serve",
"pre": "git add ."
}
}
推送到 Surge
在项目根目录运行以下命令:
surge
根据提示输入你的 GitHub 用户名和密码(如果是私仓),或者使用 SSH 向导。
配置域名(已有域名)
如果你已经有一个域名,登录 Surge 网站,添加你的域名:
- 登录 Surge
- 点击“+ New Domain”。
- 输入你的域名,点击“Add Domain”。
- 复制配置文件中的 TXT 记录到你的 DNS 提供商那里。
部署完成
你的网站现在可以通过 yourdomain.com 访问。
管理部署
- 重新部署:在项目根目录运行
surge,它会自动推送更新。 - 退出:按下
Ctrl + C结束。 - 重启服务器:
surge restart。 - 停止部署:
surge stop。
续费
每个月的免费使用额度足够用于个人项目,但如果需要更多功能,可以选择付费计划。
查看部署历史
登录 Surge 网站,查看所有部署记录,可以重启或删除旧版本。
注意事项
- 确保你的域名已经备案。
- 如果需要 HTTPS,可以选择 Surge 的免费 SSL 或者配置自己的证书。
- 部署时间可能需要几分钟,耐心等待。
完成以上步骤,你已经成功使用 Surge 部署了静态网站!









