853 字
4 分钟
AquaDX 搭建笔记
CAUTION

很高兴你能很早地看到这篇文章
但是本文的大部分内容还未编写完毕,你可以先阅读 搭建环境部分 或 等待一周后再来阅读

前言

近几天想本地部署 AquaDX,但没有找到很好的教程,所以诞生了这篇文章
这是我的第一篇文章,如有错误请批评指正
本文使用 Windows 本地搭建环境的方法部署

一、搭建环境#

▶ 安装 JDK21#

  1. 前往 JDK21 下载页面
TIP

你可以直接使用该链接下载 Win64 JDK 21 安装包

  1. 选择合适的文件下载 下载 JDK21

  2. 打开安装包,点击 下一步,选择合适的路径,点击 下一步,等待安装完成即可

WARNING

请使用全英文路径
例如: D:\jdk21

▶ 安装 MariaDB#

  1. 前往 MariaDB 下载页面
TIP

你可以直接使用该链接下载 Win64 MariaDB 11.7.2 MSI 安装包

  1. 不出意外的话,页面会根据当前系统信息和所在地自动选择合适的版本与镜像源
    如果有错误,请手动选择
    点击 Downlaod 下载安装包 下载 MariaDB

  2. 打开安装包
    Next -> I accept... -> Next -> 选择合适的路径
    配置自己的密码(输两遍),将三个框全部勾选 (中间的框可以不用勾选)。配置合适的数据目录,可以使用默认的目录,无需更改
    配置 MariaDB Root 用户 -> Next -> 保持默认即可 -> Next -> Install -> 等待安装完成 -> Finish

WARNING

请使用全英文路径
例如: D:\MariaDB

二、启动 AquaDX#

▶ 获取 AquaDX 服务端文件#

  1. 前往 AquaDX Repo,创建一个 fork
MewoLab
/
AquaDX
Waiting for api.github.com...
00K
0K
0K
Waiting...

创建 fork

  1. 自动跳转至 fork,打开并修改 .github/workflow/gradle.yml,填充以下文本
TIP

此时的网址应该类似于:https://github.com/<username>/AquaDX/blob/v1-dev/.github/workflows/gradle.yml

name: Gradle Build

on:
  pull_request:
    branches: [ master ]
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3

    - name: Set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'temurin'

    - name: Setup Gradle
      uses: gradle/gradle-build-action@v2

    - name: Build with Gradle
      run: |
        mkdir data
        ./gradlew build

    - name: Upload Build Artifacts
      uses: actions/upload-artifact@v4
      with:
        name: build-outputs
        path: |
          build/distributions/AquaDX-boot-1.0.0.zip
  1. 点击右上角的 Commit changes... 按钮,在弹出的窗口中点击 Commit changes 按钮,提交更改
TIP

你可以根据自己的习惯修改 comment

提交更改

  1. 转到 Actions 页面,点击 I understand... 按钮,开启 repo 的 actions

  2. 在侧边栏选择 Gradle Build, 在跳转的页面中点击 Run workflow, 在下拉菜单中点击 Run workflow 按钮 启动 workflow

  3. 刷新页面,可以看到 workflow 正在运行
    在此期间,你可以点击侧边栏的 build 查看进度
    等待四五分钟,回到该 workflow 的 summary 页,不出意外的话,可以看到类似下面的页面 workflow 执行完成

  4. 点击 build-outputs 或右侧的下载按钮
    打开压缩包 (build-outputs.zip) 内的 AquaDX-boot-1.0.0.zip,将其解压至任意文件夹内

WARNING

请使用全英文路径
例如: D:\AquaDX

解压完成

▶ 配置数据库#

WARNING

本小节将创建名为 aqua 的数据库 和 密码为 aquaaqua 用户
你可以使用自己的名称,但建议与本教程保持一致

▶ 配置服务端#

  1. 前往该链接,点击右侧的下载按钮
    前往刚刚解压的文件夹中的 bin 文件夹,新建一个 config 文件夹,将配置文件保存在里面 点击下载按钮 保存配置文件

  2. 使用记事本打开该文件

AquaDX 搭建笔记
https://blog.bocchi.ink/posts/deploy-aquadx/
作者
Bocchi
发布于
2025-02-16
许可协议
CC BY-NC-SA 4.0