安装并配置Surge的步骤如下
-
安装Surge CLI:
- 使用 npm 安装 Surge 命令行工具:
npm install surge
- 使用 npm 安装 Surge 命令行工具:
-
初始化Surge项目:
- 在项目根目录中运行以下命令,初始化Surge配置文件:
surge init config.json
- 打开
config.json文件,确保内容如下:{ "branch": "main", "surge": { "build": "make build", "clean": "make clean", "preview": "make preview", "deploy": "make deploy" } } - 提交
config.json到 Git仓库。
- 在项目根目录中运行以下命令,初始化Surge配置文件:
-
部署项目到Surge:
- 确保项目已经构建完成,运行以下命令将项目部署到Surge:
surge deploy
- 如果需要指定部署分支:
surge deploy --branch your-branch-name
- 确保项目已经构建完成,运行以下命令将项目部署到Surge:
-
获取Surge链接:
- 部署完成后,Surge会输出一个链接,通常格式为
https://your-project.surge.sh。
- 部署完成后,Surge会输出一个链接,通常格式为
-
配置GitHub Actions(自动化部署):
-
在项目的
Cargo.toml或package.json中添加Surge配置:{ "name": "your-project", "version": "1..", "private": false, "surge": { "branch": "main", "prefix": "[your-surge-prefix]", "domain": "your-project.surge.sh" } } -
在 GitHub Actions 中启用 workflow,
name: Deploy on: push: branches: [ 'main' ] jobs: deploy: runs-on: ubuntu-latest steps: - name: Deploy to Surge uses: surgehq/surge-action with: surge-token: ${{ secrets.SURGE_TOKEN }} project: your-project branch: main
-
-
使用Surge的本地开发工具:
- 安装
surge-watch作为本地开发工具:npm install surge-watch -g
- 初始化 watcher:
surge-watch
- 在浏览器中打开
http://localhost:9999,即可看到本地开发环境。
- 安装
-
配置域名:
- 如果有自己拥有的域名,配置
config.json:{ "branch": "main", "surge": { "build": "make build", "clean": "make clean", "preview": "make preview", "deploy": "make deploy", "domain": "your-domain.com" } } - 配置 DNS 解析,指向 Surge 的 URL。
- 如果有自己拥有的域名,配置
-
错误处理与调试:
- 部署失败时,检查
config.json中的配置是否正确。 - 使用
git push或通过 GitHub Actions 检查日志,解决问题后重新部署。
- 部署失败时,检查
通过以上步骤,您可以成功安装并使用Surge进行静态项目的托管和部署,如果遇到问题,可以参考Surge的官方文档或社区求助。

@版权声明
转载原创文章请注明转载自原子VPN|多平台网络连接与线路优化工具,支持节点切换、网络测速及电脑手机端使用,满足不同网络环境下的连接需求,网站地址:https://yuanziapp.com.cn/