pages-server/README.md
“xHuPo” 5a32a5859e new 1
2024-12-13 18:39:52 +08:00

1.6 KiB
Raw Blame History

Gitea Pages

English (Google TR) | 中文

参照 Github Pages 实现的 Gitea Pages 原:Pages

想法:

单用户模式,支持多个仓库。

4个配置读取方式。默认环境变量配置文件命令行参数。 优先级依次升高。

定时刷新git分支更新最新内容。

多用户模式,支持多个用户。

token 需要如下权限:

  • organization:read
  • repository:read
  • user:read

使用说明

仓库 https://gitea.com/owner/repo.git 对应示例配置中的 owner.example.com/repo

如需访问 CNAME 配置的域名,则需要先访问仓库对应的 <owner>.example.com/<repo> 域名, 此操作只需完成一次。

注意 需要仓库存在 gh-pages 分支和分支内存在 index.html 文件才可访问,如果配置后仍无法访问可重启 Caddy 来清理缓存。

文件回退策略

  • URL 末尾为 / 时将自动追加 index.html
  • 未找到文件时,如果存在 404.html 将使用此文件,响应 404 状态码
  • 如果仓库带有 routes-historyroutes-hash 标签时,默认回退使用 index.html, 同时返回 200 状态码

TODO

  • 支持 CNAME 自定义路径 (仅适用于 HTTP 模式,不处理 acme 相关的内容)
  • 支持内容缓存
  • 优化并发模型和处理竞争问题
  • 支持 Http Range 断点续传
  • 支持 oauth2 登录访问私有页面

致谢

此项目参考了 42wim/caddy-gitea

LICENSE

此项目使用 Apache-2.0