ubuntu下载安装koishi

基于Ubuntu系统的Koishi安装方法总结：

---

一、通过Koishi Desktop安装（推荐新手）

1. 下载安装包

• 访问Koishi官网或GitHub仓库，下载适用于Linux的.deb文件（适用于Ubuntu/Debian）。

2. 安装与运行

# 安装依赖（若缺失）
sudo apt install ./koishi-desktop_*.deb

# 启动Koishi
koishi-desktop

• 首次运行后，浏览器自动打开控制台（默认地址：http://localhost:5140）。

---

二、命令行手动安装（开发者适用）

1. 安装依赖环境

# 安装Node.js（推荐v18+）
wget https://nodejs.org/dist/v18.12.1/node-v18.12.1-x64.msi
sudo dpkg -i node-v18.12.1-x64.msi

# 安装Yarn
npm install -g yarn

2. 创建Koishi实例

# 初始化项目
yarn create koishi

# 进入项目目录并启动
cd koishi
yarn start

• 日志默认输出到终端，数据保存在项目目录下的.koishi文件夹。

---

三、通过APT包管理器安装（需手动配置）

1. 添加第三方仓库（如EPEL）

sudo apt install software-properties-common
sudo add-apt-repository ppa:koishi/koishi
sudo apt update

2. 安装Koishi

sudo apt install koishi

• 注意：此方法依赖第三方仓库，需验证源可靠性。

---

四、使用1Panel快速部署（服务器管理适用）

1. 安装1Panel

wget -O install.sh https://download.fastgit.org/1panel-dev/1panel-installer/raw/main/install_24.04.sh
bash install.sh

2. 通过1Panel安装Koishi

• 登录1Panel控制台 → 应用商店 → 搜索“Koishi” → 点击安装。
• 勾选“外部访问端口”以允许远程连接。

---

五、常见问题与优化

1. 端口与防火墙

• 若无法访问控制台，检查端口5140是否开放：

  sudo ufw allow 5140/tcp
  

2. 数据持久化

• 默认数据存储在项目目录，建议备份.koishi文件夹或配置数据库（如MySQL）。

3. 插件配置

• 在控制台插件市场安装adapter-onebot、database-sqlite等插件，支持QQ、Telegram等平台。

---

六、方法对比

方式	优点	缺点	适用场景
Koishi Desktop	图形化操作，无需配置环境	依赖图形界面，不适合服务器	本地开发/测试
命令行手动安装	灵活，适合定制化	需熟悉Node.js和Yarn	开发者/自定义需求
APT包管理器	简单快捷	依赖第三方源，版本可能滞后	生产环境快速部署
1Panel部署	自动化配置，支持远程管理	需额外安装1Panel	服务器批量管理

---

七、参考来源

• 安装包与基础配置：
• 手动部署与插件管理：
• 第三方仓库与APT安装：
• 1Panel快速部署：