使用须知

该文章需要搭配博主另一篇文章来食用
传送门：AnZhiYu主题魔改日记

博主使用的部署方案为github+sqlite+vercel部署，如需使用其他部署方案请到原项目文档查看

后端部署教程

  • 进入原项目地址，点击右上角的fork复制项目

    fork时不要修改仓库名称，否则会导致管理面板部分功能不可用

  • 在fork到的项目中进入hexo-circle-of-friends/hexo_circle_of_friends/fc_settings.yaml，修改该文件，需要修改的配置如下：
    1
    2
    LINK: [
         {link: "https://chenfengblog.eu.org/link/", theme: "common2"}  # link改为你的友链页地址，theme选择你的博客主题

    若使用的是AnZhiYu主题，配置文件中的theme改为common2，注意一定要使用common2，否则将无法拉取到自己的友链

  • 然后依次点击该仓库的Settings–>Secrets–>New repository secret
  • 添加4个环境变量secret：
  1. GH_NAME：github名称，也就是你的github用户名，例如我的就是chenfengyyds
  2. GH_EMAIL：github邮箱，填写你注册github的邮箱，例如我的就是255693535@qq.com
  3. STORAGE_TYPE：存储方式，填写sqlite
  4. GH_TOKEN：github访问token，获取方式如下，其中，Select scopes选择repo和workflow
    如何获取token
    • 进入https://github.com/settings/tokens
    • 依次点击Personal access tokens–>Tokens (classic)–>Generate new token▼–>Generate new token (classic)
    • 接下来进入这个界面，需要验证你的邮箱，当然你也可以点下面的Use your password使用密码验证
    • 验证完成之后，就可以进入创建token的界面，按照图中设置token即可
    • 最后滚轮拉到页面最下面，点击Generate token创建
    • 接下来会进入该界面，我们复制显示的token

      注意：该token在该界面仅会显示一次，之后就不能查看了，要是忘记了token就只能删除了重新创建一个了

  • 配置完成后，应该如下图所示：
  • 然后依次点击该仓库的setting–>Actions–>General–>勾选Read and write permissions–>Save
  • 前往vercel官网，直接用github创建账号并用手机号绑定
  • 依次点击Add New...–>Project新建项目
  • 找到你刚刚fork的仓库，点击Import
  • 然后点击Deploy，回到首页，等待一会就能部署完成
  • 进入刚才创建的项目主页，点击Settings–>Environment Variables
  • 添加环境变量
  1. GH_NAME：github名称，也就是你的github用户名，例如我的就是chenfengyyds
  2. GH_EMAIL：github邮箱，填写你注册github的邮箱，例如我的就是255693535@qq.com
  3. GH_TOKEN：github访问token
  4. VERCEL_ACCESS_TOKEN：获取方式如下
    如何获取VERCEL_ACCESS_TOKEN
    • 点击vercel页面右上角的Settings–>Tokens，仿照图中填写完成token信息后点击Create

      注意：该token在该界面仅会显示一次，之后就不能查看了，要是忘记了token就只能删除了重新创建一个了

  • 复制生成的token，添加到vercel环境变量中即可
  • 添加完成后，应该如下图所示：
  • 在github打开仓库，依次点击Actions–>update-friends-posts–>Run workflow进行第一次运行
  • 等待运行完毕后，仓库中应该会生成data.db文件，并且vercel也会同步更新
  • 至此，友链朋友圈后端部分已经搭建完成

    注意 ⚠️Vercel 默认域名于 2022 年 8 月 27 日被 GFW 屏蔽，请绑定自定义域名使用

绑定自定义域名

  • 进入vercal，点击需要进行自定义域名的项目
  • 点击Settings–>Domins，在中间输入框内填上你的域名，然后点击Add
  • 接下来会提示需要将CNAME记录解析，我们需要记下Name和VAlue的数据，稍后会用到
  • 去到你的域名提供商那里，给域名新增一条CNAME记录，名称和目标分别填写刚才Name和VAlue的数据，代理状态选择仅DNS，TTL选为自动，然后点击保存即可
  • 回到vercal，当你看到这条消息的时候，这就说明你已经绑定好自定义域名了