Shiroi主题是 Shiro 的闭源版本，获取方式详见 赞助

🔍前提

• 拥有 Shiroi 仓库访问权限
• 拥有一台云服务器，本文使用的是2核2G的阿里云ECS云服务器
  • 如果是中国内地的服务器，记得先完成ICP备案
  • 免费试用的ECS服务器不满足可备案服务器要求
• 拥有自己的域名
• 已安装并启动 Mix Space 后端
  • docker部署（推荐）
  • 反向代理
• 已设置主题配置

📦准备

• 服务器需要先安装 Node.js, npm, pnpm, pm2, sharp

  # 以阿里云ECS为例
    
  # 安装node
  sudo yum install -y nodejs
    
  # 安装pnpm
  npm install -g pnpm
    
  # 安装pm2
  npm install -g pm2
    
  # pm2开机自启动
  pm2 startup # 生成启动脚本
  pm2 save # 保存当前进程列表
  
  # 安装sharp
  npm i -g sharp
  

• fork项目shiroi-deploy-action到自己的github账号下

• 在shiroi-deploy-action仓库添加Responsitory secrets

  

  • HOST：服务器公网ip
  • USER：服务器登录用户名，一般为root
  • PASSWORD：服务器登录密码
  • KEY：服务器 SSH Key（可选，密码 key 二选一）
  • PORT：服务器 SSH 端口，一般为22
  • GH_PAT：可访问 Shiroi 仓库的 Github Token，token设置路径：github头像下拉目录/Settings/Developer settings/Personal access tokens/Tokens(classic)

    

💡触发工作流

• 本地拉取先前fork的shiroi-deploy-action项目代码，在项目目录下打开git bash。

• 执行以下命令：

  # 生成新的哈希值，并写入build_bash文件
  echo "$(git rev-parse --short HEAD)-$(date +%s)" > build_hash
    

• 提交、推送代码，推送之后在shiroi-deploy-action仓库中的Actions可以看到执行中的工作流。

  git add build_hash
  # 注意提交信息固定为"trigger-workflow"，这样工作流才能正常运行完
  git commit -m "trigger-workflow"
  git push origin main
    

🚀启动前端

• 工作流执行完毕后，会在服务器的root下生成shiro目录，在shiro下添加.env文件，内容如下：

  INI

  NEXT_PUBLIC_API_URL=http://localhost:2333
  NEXT_PUBLIC_GATEWAY_URL=http://localhost:2333
     
  # 替换为自己的域名
  NEXT_PUBLIC_API_URL=https://example.com/api/v2
  NEXT_PUBLIC_GATEWAY_URL=https://example.com
  
  TMDB_API_KEY=
  GH_TOKEN=
    

• 在shiro目录下，执行以下命令，看到启动成功就可以了。

  # 首次启动时执行，保证服务是启动在2323端口（与nginx配置保持一致）
  export PORT=2323
  node server.js
    

🛠️常见问题

• 访问前端时，页面上提示：“初始数据的获取失败，请检査 API服务器是否正常运行。”
  • 是否已在Mix Space后台完成主题配置
  • 如果是中国大陆的服务器，需进行ICP备案
• 工作流未触发或提前终止
  • 检查git提交信息是否为：trigger-workflow