Build tutorial

最完整的 SimpleFSD 搭建教程

本文档将提供两种搭建 SimpleFSD 的方法，请根据你的需求和技术背景选择最适合你的方式。 必要时请参考API文档，我们正在持续迭代，或许会对开发者或者你有用。

• 方法一（推荐新手）： 使用预编译的发布版本，运行后编辑config.json完成搭建。
• 方法二（推荐开发者）： 克隆源代码仓库，使用 Go 编译器自行构建。

---

方法一：使用预编译发布版本

这种方法最为直接，你只需要下载对应你操作系统的可执行文件并运行即可。

步骤 1：下载可执行文件

1. 访问 SimpleFSD 的官方发布页面： https://github.com/Flyleague-Collection/SimpleFSD/releases/

2. 在最新的发布版本（例如 v0.7.0）的 “Assets” 部分，找到适合你可执行文件：

   • Windows 用户： 下载 fsd-windows-amd64-v0.7.0.exe 或类似名称的文件。
   • Linux 用户： 下载 fsd-linux-amd64-v0.7.0 或类似名称的文件。

步骤 2：运行程序

根据你的操作系统，选择以下方式之一：

对于 Windows 用户

1. 将下载的可执行文件（例如 fsd-windows-amd64-v0.7.0.exe）放置在你希望的任意文件夹中。
2. 直接双击该文件即可运行。

配置Config.json

运行后终端会自动关闭并留下config.json配置文件，具体简介请参考配置文件简介 配置后请通过运行可执行文件开启服务器，不自动关闭并提示FSD Server Listen On [::]:6809或Starting http server on 0.0.0.0:6810则开启服务器完成

对于 Linux 用户

1. 打开终端（Terminal），并进入到存放下载文件的目录。
2. 为文件添加可执行权限：

   chmod +x simplefsd-linux-amd64

3. 运行程序：

   * fsd-linux-amd64-v0.7.0

4.配置config.json

配置Config.json

运行后终端会自动关闭并留下config.json配置文件，具体简介请参考配置文件简介 配置后请通过运行可执行文件开启服务器，不自动关闭并提示FSD Server Listen On [::]:6809或Starting http server on 0.0.0.0:6810则开启服务器完成

至此，方法一的搭建已经完成！服务器应该已经启动并运行。

---

方法二：从源代码构建（需要 Go 环境）

如果你希望获取最新的代码，或者是一名开发者，可以选择此方法。

前提条件

确保你的系统上已经安装了 Go 编程语言，并且版本 必须高于 1.23.4。

• 检查 Go 版本： 打开终端（Linux/macOS）或命令提示符/PowerShell（Windows），输入以下命令：

  go version

  如果输出类似 go version go1.23.4 linux/amd64 且版本号大于 1.23.4，则满足条件。如果未安装或版本过低，请前往 Go 官网下载 并安装最新版本。

步骤 1：获取源代码

你有两种方式获取源代码：

• 方式 A（推荐使用 Git）： 克隆本仓库。

  git clone https://github.com/Flyleague-Collection/SimpleFSD.git
  cd SimpleFSD

• 方式 B（直接下载）： 下载源代码 ZIP 压缩包。

  1. 下载链接：https://github.com/Flyleague-Collection/SimpleFSD/archive/refs/heads/main.zip
  2. 将ZIP文件解压到你选择的目录中。
  3. 在终端或命令提示符中，进入解压后的目录（例如 SimpleFSD-main）。

步骤 2：构建项目

在源代码根目录下，执行以下 Go 命令来编译和构建项目。这会下载所有依赖项并生成可执行文件。

go build -x .\cmd\fsd\

• [可选]使用upx压缩可执行文件 (windows)```bash upx.exe -9 .\fsd.exe

(linux)```bash
upx -9 .\fsd

步骤 4：运行程序

构建成功后，运行生成的可执行文件。

对于 Windows 用户

.\fsd.exe

或者直接在文件资源管理器中双击 fsd.exe。

对于 Linux 用户

./fsd

至此，方法二的搭建已经完成！你现在运行的是由源代码直接编译的最新版本 SimpleFSD。

---

下一步

无论你使用哪种方法，成功运行后，SimpleFSD 服务器都会开始监听指定的端口（默认通常是 6809）。你可以根据项目的具体文档，配置客户端连接或进行进一步的设置。

常见问题 (FAQ)

• Q： 运行程序时提示 command not found (Linux) 或无法运行 (Windows)。

  • A（方法一）： 确保下载了正确的平台版本。对于 Linux，请记得执行 chmod +x 命令赋予可执行权限。
  • A（方法二）： 确保 Go 已正确安装且 GOPATH 和 GOROOT 环境变量配置正确。请再次检查 go version 命令的输出。

• Q： 我想修改配置（如端口号、数据库路径等）。

  • A： 请查阅项目根目录下的 config.json文件，并修改"fsd_server"的"port"端口。具体配置项请参考项目的其他 Wiki 页面。

• Q： 方法二构建时下载依赖超时或失败。

  • A： 这通常是由于网络问题。可以尝试设置 Go 模块代理，例如在中国大陆的用户可以执行：

    go env -w GOPROXY=https://goproxy.cn,direct

    然后重新执行 go build 命令。

如果遇到其他问题，请在项目的 Issues 页面搜索或提出新问题。

编者： guloudalaoshi