Appearance
下载与安装
本章介绍如何获取「汇账」的安装包并在本机运行。
系统提供两种分发形态:
| 形态 | 适用场景 | 说明 |
|---|---|---|
| 免安装应用(app-image) | 推荐 | 自带精简 Java 运行时,解压即用,无需另装 JDK |
| 可执行 jar | 已有 JDK 21 的环境 | 单个 jar 文件,java -jar 运行 |
每个平台各提供两个版本:
- 个人记账(GUI 版):带图形界面启动器,可在窗口或系统托盘中启停服务、打开浏览器、实时查看日志。
- 后端服务(服务版):命令行启动,适合服务器或后台常驻运行。
下载地址
当前版本:0.0.1-SNAPSHOT。以下均为阿里云 OSS 长期签名地址,有效期至 2036 年。
Windows(x64)
| 版本 | 下载 | 校验 |
|---|---|---|
| 个人记账(GUI) | Ledgerly-windows-x64.zip | sha256 |
| 后端服务 | LedgerlyServer-windows-x64.zip | sha256 |
| 校验清单 | SHA256SUMS |
Linux(x64)
| 版本 | 下载 | 校验 |
|---|---|---|
| 个人记账(GUI) | Ledgerly-linux-x64.tar.gz | sha256 |
| 后端服务 | LedgerlyServer-linux-x64.tar.gz | sha256 |
| 校验清单 | SHA256SUMS |
可执行 jar(跨平台)
需要本机已安装 JDK 21。
| 版本 | 下载 | 校验 |
|---|---|---|
| 普通 jar | ledgerly-0.0.1-SNAPSHOT-jdk21.jar | sha256 |
| 带 GUI 启动器 jar | ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar | sha256 |
运行
Windows
解压 zip 后进入解压出的目录:
- 个人记账(GUI):双击
Ledgerly.exe,在启动器界面上点击「启动服务」,再点「打开浏览器」。 - 后端服务:运行
LedgerlyServer.exe,会附带控制台窗口显示日志;服务在本机http://localhost:8080提供页面与接口。
Linux
个人记账(GUI):
bash
tar xzf Ledgerly-linux-x64.tar.gz
cd Ledgerly
./bin/Ledgerly后端服务:
bash
tar xzf LedgerlyServer-linux-x64.tar.gz
cd LedgerlyServer
./bin/LedgerlyServer可执行 jar
bash
java -jar ledgerly-0.0.1-SNAPSHOT-jdk21.jar带 GUI 启动器的 jar(需要桌面环境):
bash
java -jar ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar默认访问地址为 http://localhost:8080,可在「设置」中修改端口,或运行时用 --server.port=18081 指定。
校验下载文件
建议下载后校验文件完整性(sha256 文件内容即对应压缩包/ jar 的 SHA-256 值)。
Linux:
bash
sha256sum -c Ledgerly-linux-x64.tar.gz.sha256Windows PowerShell:
powershell
Get-FileHash -Algorithm SHA256 .\Ledgerly-windows-x64.zip
# 与 .sha256 文件中的值比对运行目录与数据
- 配置、日志、数据默认落在程序所在目录;可用
--home=<目录>参数或环境变量LEDGERLY_HOME指定基准目录。 - 首次访问时,页面会引导选择 SQLite(本地单文件,零配置)或 MySQL,保存后自动建表。