macOS 安装指南

本指南将带你在 macOS 系统上完成 FlowGate 的完整部署，包括 FGateNexus（核心服务）和 FGateClient（Client 端）两个部分。

前置要求

macOS（Apple Silicon 或 Intel）操作系统
基本的命令行操作能力（Terminal）

下载 FGateNexus

前往 FGateNexus Releases 下载适用于 macOS 的压缩包，根据你的设备架构选择对应版本：

架构	适用设备	文件名
x64	Intel Mac	`FGateNexus-vx.x.x-mac-x64.tar.gz`
ARM64	Apple Silicon (M 系列)	`FGateNexus-vx.x.x-mac-arm64.tar.gz`

下载完成后，将压缩包解压到你希望运行服务的目录，例如 ~/flowgate/。

配置 FGateNexus

打开 config/appsettings.json，根据你的需求修改配置项。

首次运行时，FGateNexus 会自动在目录下创建 sqlite.db 数据库文件以及配置文件。

运行 FGateNexus

打开终端（Terminal），进入解压目录，赋予可执行权限后运行：

cd ~/FlowGate
chmod +x FGateNexus
./FGateNexus

后续你也可以直接双击执行文件来启动。

启动成功后，你将看到类似以下的输出：

[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 插件。

开机自启（可选）

你不会 Bing 一下嘛