Gitee Pages 部署静态网站

Gitee Pages 是 Gitee（码云）提供的静态网站托管服务，能力上接近 GitHub Pages，但在部署链路和平台约束上有几处明显差异。

---

部署流程

1. 在 Gitee 新建仓库
2. 推送静态文件（或构建产物）到仓库
3. 服务 → Gitee Pages → 选择部署分支 → 开启
4. 站点在 https://<username>.gitee.io/<repo>/ 可用

---

与 GitHub Pages 的关键差异

维度	GitHub Pages	Gitee Pages
实名认证	不需要	需要（个人身份验证）
仓库可见性	需要 Public（免费）	不要求 Public
自动部署	push 自动触发	手动触发（在 Pages 设置页点击"更新"）
构建系统	Jekyll / GitHub Actions	不支持自动构建
HTTPS	自动 Let's Encrypt	自动
自定义域名	支持	支持
带宽限制	100GB/月	未对外公布

影响最大的几项差异如下：

1. 实名认证。 Gitee Pages 要求账号完成实名认证（姓名 + 身份证号）。这一点会直接影响个人项目是否放在平台侧托管。

2. 手动更新。 推送到部署分支后，站点不会自动更新，需要登录 Gitee 进入 Pages 设置页手动点击“更新”。发布频率较高时，这一步会成为部署链路里的额外人工环节。

3. 无自动构建。 Gitee Pages 只提供静态文件托管，不承担类似 GitHub Actions 的 CI 构建职责。构建产物需要先在本机或 CI 环境生成，再将 dist/ 推送到仓库。

---

自建服务器替代方案

当实名认证要求或手动更新流程不符合当前项目约束时，自建 Nginx 服务器是一条直接的替代路径：

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/app/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # 静态资源长期缓存
    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

部署链路可以简化为：

1. 本地/CI 构建 → dist/
2. rsync -avz dist/ user@server:/var/www/app/dist/
3. Nginx 自动serve 新文件

自建方案的主要成本是一台轻量云服务器，最低配置通常在 50-100 元/月。HTTPS 可以配合 Let's Encrypt（certbot）自动续期。对应的收益是部署链路完全可控，不受实名认证、手动更新或平台能力边界限制。