Ubuntu/Debian

《Surge服务器配置与使用指南》

Surge服务器是一种轻量级的静态网站托管服务,广泛应用于前端开发、文档托管等场景，它以简单易用的配置和高效的部署特性著称，本文将详细介绍Surge服务器的设置流程，包括安装、配置、部署等内容。

安装Surge服务器需要通过Node.js包管理工具npm完成，执行以下命令安装Surge：

npm install -g surge

安装完成后,创建一个Surge配置文件，命名为surge.json，在文件中添加以下内容：

{
  "surge": {
    "git": "git://your-repo.git",
    "branch": "main",
    "prefix": "[your-domain].surge.sh",
    "domain": "your-domain.surge.sh",
    "enabled": true
  }
}

填写配置文件中的信息时,需注意以下几点：

1. git仓库地址：替换为你的项目仓库地址。
2. 分支选择：根据项目习惯选择合适的分支，如main、master或其他。
3. 域名设置：建议使用域名或子域名，以便于访问。

运行以下命令初始化Surge,并将项目部署到服务器：

git add surge.json
git commit -m "添加Surge配置"
surge

此时会打开默认浏览器,展示托管后的项目内容。

设置域名

如果需要使用自定义域名,需先在域名提供商处解析域名指向Surge服务器的IP地址，完成后，编辑surge.json，添加域名配置：

{
  "surge": {
    "git": "git://your-repo.git",
    "branch": "main",
    "prefix": "[your-domain].surge.sh",
    "domain": "your-domain.surge.sh",
    "enabled": true,
    "https": true
  }
}

配置HTTPS

Surge服务器支持自动化HTTPS设置,可以通过配置文件开启：

{
  "surge": {
    "git": "git://your-repo.git",
    "branch": "main",
    "prefix": "[your-domain].surge.sh",
    "domain": "your-domain.surge.sh",
    "enabled": true,
    "https": true,
    "origin": "https://your-domain.surge.sh"
  }
}

自动化部署

为了自动化部署,可以使用持续集成工具（如GitHub Actions）触发Surge命令，添加到github/workflows/main.yml：

name: Surge部署
on:
  push:
    branches: [ main ]
jobs:
  deploy-surge:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout代码
        uses: actions/checkout@v2
      - name: Surge部署
        uses: surge/surge-action@latest
        with:
          surge: surge.json

安全组防火墙设置

确保Surge服务器的安全组防火墙配置正确,允许HTTP（80）和HTTPS（443）端口：

sudo ufw allow out 443

常见问题解决

1. 权限不足：确保Node.js和npm有足够权限运行，使用以下命令修复：

sudo npm install -g surge -f

2. 域名解析问题：检查DNS记录是否正确，确保域名指向Surge服务器的IP地址。

3. HTTPS错误：检查证书是否正确配置，确保域名在证书中注册。

通过以上步骤,你可以轻松设置并使用Surge服务器进行静态网站托管，Surge的高效性能和简单配置使其成为开发者的理想选择。