以下为 Shiro 闭源版本 Yohaku 部署方案,可能随着版本更新而不再适用
安装 1Panel
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
配置镜像输入 y(安装openresty需要),其他一律 enter 即可
安装完成后,打开1panel网址,进入应用商店,安装openresty
后端部署
正常需要安装 docker,不过由于 1Panel 面板默认会安装 docker,所以这里不需要,如果使用宝塔面板或其他方式,请自行安装docker
拉取并修改配置文件
主要修改ALLOWED_origins和JWT_SECRET
启动 core
docker compose up -d
这里需要几分钟时间,耐心等待
网站创建
以下步骤均在 1Panel 中进行
证书申请
先创建Acme账户,账号类型建议选ZeroSSL,省事
创建完后申请证书 → 填写主域名 → Acme账户 → 秘钥算法(EC 256) → 验证方式(HTTP) → 自动续签 → 确认
创建网站
创建 → 静态网站 → 监听IPV6 → 配置 → HTTPS(开启,选择刚才的证书) → 配置文件(将下面内容插入到中间)
我是单域名配置,如果你是双域名,参考官方文档
修改完毕,点击保存并重载
访问 https://你的域名/qaqdmin 就可以正常进入博客后台(如果碰到问题也不要急,可以在评论区留下你的问题,或许可以给你提供一些帮助),然后就是简单的填写博客基本信息
前端部署
这一步中间可能会出现各种错误,建议在服务器上安装 Claude Code,让大模型帮你分析排查问题,一般都能解决
我采用的是 Innei 提供的自动部署工作流方式
Fork
打开github,fork上面的仓库
设置 Secrets
打开仓库,进入 Settings → Secrets and variables → Actions → Repository secrets → 挨个添加下面的参数
HOST服务器地址USER服务器用户名PASSWORD服务器密码PORT服务器 SSH 端口KEY服务器 SSH Key(可选,密码 key 二选一)GH_PAT可访问之前 repository 内填写仓库的 Github Token
配置 .env
在服务器 root 下创建 yohaku 文件夹,并在其下创建 .env
填写以下内容
修改 deploy
打开 .github/workflows/deploy.yml 进行修改
如果直接使用 Innei 的部署过程中出现报错,可以参考我的进行修改,或者询问大模型,github自带的 Copilot 也挺好用的
改完之后 commit,会自动跑,可以进入Actions查看流程
配置云函数
进入博客后台,附加功能 → 配置与云函数
创建一条 theme 引用、名称为 shiro 的配置项(数据类型 JSON 或 YAML),这里贴上官方提供的案例
修改好后保存
都完成后,访问前端,没问题的话,恭喜你部署成功