Linux

视频教程：bilibili-Linux  更推荐简洁的文档= =

1.安装 Node.js

在 node 官网 进行下载安装，版本请选择 18 以上版本，推荐最新长期稳定版。

请不要用包管理器安装，那样安装的版本较旧。

这里 使用 NodeSource 仓库 进行安装，终端 键入以下命令，

Ubuntu/Debian

# 以 Node.js 20.x 为例
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
 
# 验证
node -v

CentOS/RedHat

# 以 Node.js 20.x 为例
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs
 
# 验证
node -v

验证全局安装路径（如遇权限问题）

如果出现 EACCES 权限错误，建议配置 npm 全局安装路径到用户目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

2. 通过 npx 快速配置项目

npx 是 npm 包管理工具的一个命令，可以自动安装 npm 包并执行某个命令。

首先创建 空文件夹 作为 存储 框架目录 的目录，复制下面 命令 到 命令行，并回车

# 创建空目录作为框架目录，并切换到这个目录
mkdir ~/bot && cd ~/bot

再通过下面 npx kivibot 命令初始化项目，

接下来它会自动安装 kivibot 并执行 初始化项目 命令，根据引导创建项目

npx kivibot

完成后它会提示你创建成功，根据下方引导启动 KiviBot：

cd C:\Users\Administrator\Desktop\MyBot\DogBot && npm i && npm start

虽然不对，但还是解释下：

这里的 cd 是 切换目录 命令，&& 指多个命令一起运行，npm i 指安装框架依赖(需要的 npm 包)，npm start 指启动框架。

3.更新版本并启动 Kivibot

请先使用 cd 命令切换到 框架目录 ，

以 # 开头的内容为注释 非命令

cd C:\Users\Administrator\Desktop\MyBot\DogBot
# 绝对目录
cd DogBot
# 相对目录

为什么说不能直接按上面引导操作呢，因为默认 npm i 会安装 kivibot 1.5.3版本，而目前1.5.3版本已经不可用，需更换 rc 版本，就是额外再 npm i 后添加一步 npm i kivibot@rc 。

然后依次在 命令行 中输入下面 命令 ：

npm i
# 安装所有配置模块(install)
npm i kivibot@rc
# 更新kivibot(目前需更新rc版本使用)
npm start
# 或者npm run start 这里会执行node app.js命令

也可以直接：

npm i && npm i kivibot@rc && npm start

其中会要求 **抓取 ticket **请看: ❓ 如何获取滑块验证码的 ticket

如果显示密码错误，请从第二步重新开始配置。

如果为其他报错问题，可以看 常见问题

4.启动成功

✅ 通过上面操作后，会提示“账号已成功上线”，接下来：

• 在 🧩 插件文档 查看如何启用插件

后台部署(可选)

pm2 是一个用于后台运行的 npm包 ，

这里加入 -g 用于 全局安装 (global)，就是在所有地方都可以用 pm2

# 全局安装pm2
npm install pm2 -g
# 启动项目 请先确保能正确启动
pm2 start app.js
# 停止项目
pm2 stop app.js