安装 Surge

需要安装 Surge，可以通过以下命令安装（在 macOS 或 Linux 上）：

curl -sLO https://github.com/surge/sh//releases/download/v3.2.2/surge-3.2.2-darwin-x64.gz | gunzip -c | tar -x

或者通过包管理器安装（如 npm）：

npm install -g surge

初始化项目

在项目目录中初始化 Surge：

surge init

这会生成一个 surge.json 文件,配置文件中包含项目信息。

配置 surge.json

编辑 surge.json 文件,通常内容如下：

{
  "surge": {
    "app": "index.html",
    "domain": "yourdomain.com",
    "static": "static/",
    "route": "route.html",
    "隧道": "yourdomain.com"
  }
}

• app：指定入口文件，默认为 index.html。
• domain：指定域名。
• static：指定静态文件目录。
• route：指定路由文件，默认为 route.html。
• 隧道：配置静态网站隧道,方便访问。

推送文件

将项目文件推送到 Surge：

surge push . -p yourprojectname

将 yourprojectname 替换为你在 Surge 上创建的项目名称。

查看部署状态

查看项目状态：

surge list

配置 GitHub Actions

如果你想自动化部署，可以在 GitHub Actions 中添加 Surge 的步骤。

name: Deploy
on:
  push:
    branches: [ main ]
env:
  SURGE_TOKEN: your-surge-token
  DOMAIN: yourdomain.com
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Surge
        uses: surge/surge-action
        with:
          app: index.html
          domain: ${{ env.DOMAIN }}
          static: static/
          route: route.html

配置文件结构

项目文件结构通常如下：

yourprojectname/
├── index.html
├── static/
│   └── images/
│       └── logo.png
├── route.html
└── surge.json

部署后操作

• 重启项目：

  surge restart

• 停止项目：

  surge down

• 删除项目：

  surge delete yourprojectname

配置域名和隧道

在 Surge 的控制台中：

1. 登录账号：surge login
2. 添加域名：surge domain yourdomain.com
3. 配置隧道：surge tunnel yourdomain.com

本地测试

可以使用 surge serve 命令在本地启动服务器：

surge serve

通过以上方法,你可以轻松配置和部署静态网站。