安装Surge
-
安装Node.js(如果尚未安装)
下载并安装Node.js,确保版本为LTS(长期支持版本)。
-
安装Surge CLI
- 打开终端,运行以下命令安装Surge:
npm install surge
- 打开终端,运行以下命令安装Surge:
初始化Surge项目
-
创建Surge配置文件
- 在项目目录下运行以下命令,生成
surge.json:surge init
- 这会打开默认浏览器,创建Surge账户,如果已有账户,可能会提示输入密码。
- 在项目目录下运行以下命令,生成
-
配置Surge项目信息
- 打开生成的
surge.json文件,编辑内容:{ "project": { "name": "your-project-name", "version": "1..", "description": "Your project description", "github": "your-repo-url", "surge": { "bucket": "your-bucket-name" } } } github字段可选,用于从GitHub自动构建。
- 打开生成的
-
初始化完成
确认配置文件已保存,继续下一步。
构建项目
- 构建静态文件
- 运行以下命令构建静态文件:
surge build
- Surge会将项目目录中的静态文件压缩并准备好部署。
- 运行以下命令构建静态文件:
部署项目
- 推送到Surge
- 运行以下命令将构建好的文件推送到Surge:
surge push
- 这会提示你输入Surge密码,成功后即可完成部署。
- 运行以下命令将构建好的文件推送到Surge:
访问项目
- 获取访问信息
- 部署完成后,Surge会展示你的项目名称、域名和文件路径。
- 访问地址为:
http://your-account-name.surgehosting.net/your-project-name/
进一步配置(可选)
-
域名绑定
- 如果有自定义域名,运行:
surge domain your-domain.com
- 配置完成后,可能需要设置SSL,使用
surge ssl命令。
- 如果有自定义域名,运行:
-
设置CDN
- 使用
surge cdn命令,选择要部署的镜像位置。
- 使用
高级功能
-
持续集成
使用Surge CLI脚本在CI/CD流程中自动化部署,参考Surge文档。
-
权限管理
- 添加读者权限:
surge permission add reader user:pass@example.com
- 添加读者权限:
故事
通过以上步骤,你已经成功安装并部署了第一个Surge项目,继续探索其高级功能,如多环境部署和持续集成,以优化你的开发流程,遇到问题时,参考丰富的文档和活跃的社区,获取及时支持。









