Surge 是一个高效的静态文件托管工具，广泛应用于前端开发、项目部署等场景，本文将详细指导用户如何使用 Surge 客户端进行项目部署和管理。
安装 Surge 客户端
安装 Surge
通过 npm 安装：
npm install -g surge
也可以使用 Yarn 安装：
yarn global add surge
安装完成后，Surge 会被添加到 PATH 中,随时可以在命令行中使用。
在不同操作系统上安装
- Windows：运行命令行，输入
npm install -g surge或yarn global add surge。 - Mac：同样使用 npm 或 Yarn 命令安装。
- Linux：确保安装了 npm 或 Yarn 后，使用相应命令安装 Surge。
项目初始化
创建项目目录
在终端中创建一个新目录，example-project：
mkdir example-project cd example-project
初始化 Git 仓库
如果项目尚未初始化 Git 仓库,执行以下命令：
git init
安装 Surge CLI
在项目目录中安装 Surge CLI 可以帮助自动化操作：
npm install surge-cli --save-dev
配置 Surge
创建 Surge 配置文件
在项目根目录下创建 surge.json 文件：
touch surge.json
打开文件,添加以下内容：
{
"surge": {
"git": "git@github.com:yourusername/yourrepo.git",
"domain": "yourdomain.surge.sh"
}
}
将 git 和 domain 替换为你的实际信息。
推送到 Surge
运行 Surge CLI
在项目根目录中运行以下命令：
npx surge
Surge 会提示你输入你的 GitHub token 和仓库名。
推送代码
输入你的 GitHub token 后，Surge 会自动推送代码到 GitHub Repository，并创建 Surge 的静态页面。
检查域名解析
推送成功后，访问 http://yourdomain.surge.sh 查看是否正常加载。
使用 Surge CLI 命令
本地测试
使用以下命令在本地启动一个 Surge 服务器：
npx surge serve
然后打开浏览器访问 http://localhost:808。
部署到生产环境
使用以下命令直接将项目部署到 Surge：
npx surge push
Surge 高级功能
多页面应用
在 surge.json 中添加多页面配置：
{
"surge": {
"git": "git@github.com:yourusername/yourrepo.git",
"domain": "yourdomain.surge.sh",
"pages": ["index.html", "page2.html"]
}
}
这样可以创建多个页面。
自定义域名
如果有自定义域名，可以在 Surge 控制台设置域名解析。
HTTPS 配置
Surge 提供免费的 HTTPS 功能,无需额外配置。
常见问题
域名解析延迟
如果域名访问速度慢，可以尝试更换 DNS 服务器或等待时间延长。
SSL 错误
如果出现 SSL 错误，检查证书是否正确配置或选择使用 Surge 提供的免费 HTTPS。
Surge 客户端为开发者提供了便捷的静态文件托管和部署工具，通过以上步骤，用户可以快速将项目部署到线上并进行管理，更多高级功能可以参考官方文档或社区资源，充分发挥 Surge 的优势！
