腾讯云部署
准备工作
注册云开发CloudBase(opens new window) 进入云开发控制台 (opens new window),新建环境,请按个人需要配置环境
推荐选择计费方式包年包月,套餐版本基础班 1 如果提示“选择部署应用”,请选择“不创建环境”
环境初始化
安全配置
进入刚刚创建的环境,选择登录授权,启用“匿名登录”
选择安全配置,将网站域名添加到“WEB安全域名”
复制环境id
部署
手动部署
点击云函数,
新建函数,函数名称填写:twikoo
,创建方式选择:空白函数
,运行环境选择:Nodejs 10.15
,函数内存请选择:128MB
点击下一步,修改函数代码:
代码语言:javascript复制exports.main = require('twikoo-func').main
确定完成后,点击刚才创建的twikoo函数,点击函数代码,创建 package.json
{ "dependencies": { "twikoo-func": "1.4.9" } }
命令行环境部署
以下操作部署,可使用任意环境面板部署,这里使用的是git进行部署
克隆本仓库
代码语言:javascript复制git clone https://github.com/imaegoo/twikoo.git
cd twikoo
安装依赖项
代码语言:javascript复制npm install -g yarn # 已安装 yarn 可以跳过此步
yarn install
授权云开发环境(会自动跳转到授权界面,点击授权即可)
代码语言:javascript复制yarn run login
自动部署
代码语言:javascript复制yarn deploy -e 您的环境id
Vercel 部署
Vercel 部署的环境需配合 1.4.0 以上版本的 twikoo.js 使用
查看视频教程(opens new window)
- 申请 MongoDB (opens new window)账号
- 创建免费 MongoDB 数据库,区域推荐选择
AWS / N. Virginia (us-east-1)
- 在 Clusters 页面点击 CONNECT,按步骤设置允许所有 IP 地址的连接(为什么? (opens new window)),创建数据库用户,并记录数据库连接字符串,请将连接字符串中的
<password>
修改为数据库密码 - 申请 Vercel (opens new window)账号
- 点击以下按钮将 Twikoo 一键部署到 Vercel
(opens new window)
- 进入 Settings - Environment Variables,添加环境变量
MONGODB_URI
,值为第 3 步的数据库连接字符串 - 进入 Overview,点击 Domains 下方的链接,如果环境配置正确,可以看到 “Twikoo 云函数运行正常” 的提示
- Vercel Domains(包含
https://
前缀,例如https://xxx.vercel.app
)即为您的环境 id
启用Twikoo
在 Hexo 中使用
在Hexo-theme-Butterfly 主题使用
直接在主题配置文件中填写刚才复制到环境ID即可:
代码语言:javascript复制twikoo:
envId: 刚才复制到环境ID
region:
visitor: false
option:
请参考 Butterfly 安裝文檔(四) 主題配置-2 (opens new window)进行配置
更多内容请移步twikoo文档
开启管理面板
进入环境-登录授权 (opens new window),点击“自定义登录”右边的“私钥下载”,下载私钥文件
用文本编辑器打开私钥文件,复制全部内容
点击评论窗口的“小齿轮”图标,粘贴私钥文件内容,并设置管理员密码,然后就可以进入管理面板了
更新
手动部署的更新方式
登录环境-云函数 (opens new window),点击 twikoo,点击函数代码,打开 package.json
文件,将 "twikoo-func": "x.x.x"
其中的版本号修改为最新版本号,点击“保存并安装依赖”即可。
提示:
如果您的云函数是 1.0.0 之前的版本,因为 1.0.0 版本修改了部署步骤,请先参考腾讯云部署的 【云函数配置】开始,重新创建云函数,再按照此步骤更新。
如果升级后出现无法读取评论列表,云函数报错,请在函数编辑页面,删除 node_modules
目录(删除需要半分钟左右,请耐心等待删除完成),再点击保存并安装依赖。如果仍然不能解决,请删除并重新创建 Twikoo 云函数。
命令行部署的更新方式
进入 Twikoo 源码目录,执行以下命令更新现有的云函数
代码语言:javascript复制yarn deploy -e 您的环境id
Vercel 部署的更新方式
- 进入 Vercel 仪表板 (opens new window)- twikoo - Settings - Git
- 点击 Connected Git Repository 下方的仓库地址
- 打开 package.json,点击编辑
- 将
"twikoo-vercel": "x.x.x"
其中的版本号修改为最新版本号。点击 Commit changes - 部署会自动触发,可以回到 Vercel 仪表板 (opens new window),查看部署状态