介绍如何为闭源版 Yohaku 使用免费的 GitHub Actions 构建 Docker 镜像并部署。闭源版本应使用私有仓库,不应将 PAT 写入 YAML 或分享,GHCR 镜像地址需使用自己的命名空间;私有 GHCR 部署还需具备 read:packages 权限的拉取令牌,并应确认第三方项目许可证。PAT 需在 GitHub Settings 的 Tokens (classic) 中创建,勾选 repo 权限后添加为 Actions Secret,名称固定为 SOURCE_PAT。随后在 .github/workflows/build.yml 配置工作流,并创建 docker-compose.yml 启动 Docker,通过 Nginx 配置反向代理。Yohaku 主题可在后台“集成-代码片段”中新建 theme 文件夹及 shiro 的 JSON 或 YAML 配置文件。若前端无法访问,可在后台发布一篇手记。
Yohaku前端构建
我使用的是Yohaku的闭源版本,有需要的朋友可以找作者赞助获取。接下讲一下闭源版本的Yohaku如何利用免费的github actions去构建docker镜像。
action流程图
注意事项
- 闭源版本请使用私有仓库部署。
- 不要把 PAT 写进 YAML。
- 不要把自己的 PAT 分享给其他人。
- GHCR 镜像地址必须改为你自己的命名空间。
- 定时任务是轮询,不会在上游提交后立即运行。
- 私有 GHCR 镜像部署时还需要一个仅有 read:packages 权限的拉取令牌。
- 使用第三方项目构建镜像前需要确认其许可证条款。
PAT创建
首先创建一个PAT,下面是创建步骤
工作流文件
复制以下代码到仓库的.github/workflows/build.yml文件里面
博客部署
本博客使用的是docker部署,因此教程也是docker部署的教程
docker-compose配置文件
创建docker-compose.yml文件然后把以下代码复制到文件中
通过下面命令启动docker
反向代理配置
这里只讲nginx的配置,caddy可以自行使用ai生成配置文件
应用Yohaku主题
进入后台管理页面,找到集成-代码片段,点击+号创建一个theme文件夹,然后在该文件夹里面创建一个名为shrio的文件,shrio文件要保证格式为json或者yaml。
JSON配置文件
YAML配置文件
我部署过程中遇到的问题