Nexus
Linux 安装指南
本指南将带你在 Linux 系统上完成 FlowGate 的完整部署，包括 FGateNexus（核心服务）和 FGateClient（Client 端）两个部分。
前置要求
- Linux（x64 或 ARM64）操作系统
- 基本的命令行操作能力
一键安装（推荐）
我们推荐使用一键安装脚本进行部署，该脚本会自动处理架构识别、下载 FGateNexus 并配置 systemd 开机自启：
bash -c "$(curl -fsSL https://fgate.crashvibe.cn/install.sh)"bash -c "$(wget -qO- https://fgate.crashvibe.cn/install.sh)"一键安装完成后，服务会自动运行。你可以跳过下方的手动步骤，直接 安装 FGateClient 插件。
手动安装
如果你更喜欢手动部署或处于不支持一键脚本的环境下，请按照以下步骤操作：
下载 FGateNexus
前往 FGateNexus Releases 下载适用于 Linux 的压缩包，根据你的服务器架构选择对应版本：
| 架构 | 适用场景 | 文件名 |
|---|---|---|
| x64 | 大多数 VPS / 物理机 | FGateNexus-vx.x.x-linux-x64.tar.gz |
| ARM64 | ARM 服务器 / 树莓派等 | FGateNexus-vx.x.x-linux-arm64.tar.gz |
下载完成后，将压缩包解压到你希望运行服务的目录，例如 /opt/flowgate/：
mkdir -p /opt/flowgate
tar -xzf FGateNexus-*-linux-*.tar.gz -C /opt/flowgate
cd /opt/flowgate配置 FGateNexus
打开 config/appsettings.json，根据你的需求修改配置项。
首次运行时，FGateNexus 会自动在目录下创建
sqlite.db 数据库文件以及配置文件。运行 FGateNexus
赋予可执行权限后运行：
chmod +x /opt/flowgate/FGateNexus-linux-*
cd /opt/flowgate
./FGateNexus-linux-*启动成功后，你将看到类似以下的输出：
[MIGRATION] 检查并执行数据库迁移...
[SUCCESS] 数据库准备就绪
INFO: 配置文件路径：.../config/appsettings.json
Listening on http://127.0.0.1:3000/...
INFO: Koishi 服务启动 http://127.0.0.1:5140服务启动后会监听以下端口：
| 服务 | 地址 |
|---|---|
| FGateNexus HTTP / API | http://127.0.0.1:3000 |
| Koishi | http://127.0.0.1:5140 |
Koishi 用于与你的聊天适配器进行链接，在管理面板中配置适配器时需要使用到这个地址。
安装 FGateClient 插件
插件安装步骤与操作系统无关，请参阅独立教程：安装 FGateClient 插件。
开机自启（可选）
推荐使用 systemd 将 FGateNexus 注册为系统服务。
新建文件 /etc/systemd/system/fgatenexus.service，内容如下：
[Unit]
Description=FGateNexus Service
After=network.target
[Service]
Type=simple
WorkingDirectory=/opt/flowgate
ExecStart=/opt/flowgate/FGateNexus-linux-*
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target然后启用并启动服务：
systemctl daemon-reload
systemctl enable fgatenexus
systemctl start fgatenexus查看运行状态：
systemctl status fgatenexus