dastapov/hledger Docker 镜像 - 轩辕镜像

hledger及相关工具的Docker镜像

该Docker镜像提供hledger（纯文本会计软件）及其相关工具：

• hledger-web：hledger的Web界面
• hledger-ui：hledger的curses界面
• hledger-iadd："hledger add"的交互式控制台前端
• hledger-interest：计算贷款/抵押账户利息的工具
• hledger-stockquotes：从AlphaVantage获取***价格的工具（不过最近该API限制为每天25次请求）
• pricehist：从多种来源获取货币和***价格的工具
• hledger-utils：提供hledger edit和hledger plot的工具包
• hledger-lots：管理***批次的工具

以及hledger仓库bin目录中的各种附加工具：

• hledger-balance-as-budget
• hledger-check-fancyassertions
• hledger-check-postable
• hledger-check-tagfiles
• hledger-combine-balances
• hledger-move
• hledger-print-location
• hledger-register-max2
• hledger-register-max
• hledger-smooth
• hledger-swap-dates

镜像版本/标签

• 最新：latest、1.50.2、latest-dev、1.50.2-dev
• 旧版本：1.50.1、1.50.1-dev、1.50、1.50-dev、1.43.2、1.43.2-dev、1.43.1、1.43.1-dev、1.43、1.43-dev、1.42.1、1.42.1-dev、1.42、1.42-dev、1.41、1.41-dev、1.40、1.40-dev、1.34、1.34-dev、1.33.1、1.33.1-dev、1.33、1.33-dev、1.32.3、1.32.3-dev、1.32.2、1.32.2-dev、1.32.1、1.32.1-dev、1.31、1.31-dev、1.30.1、1.30.1-dev、1.29.2、1.29.2-dev、1.29.1、1.29.1-dev、1.28、1.28-dev、1.27.1、1.27.1-dev、1.27、1.27-dev、1.26、1.26-dev、1.25、1.25-dev、1.24.1、1.24.1-dev、1.24、1.24-dev、1.23、1.23-dev、1.22.2、1.22.2-dev、1.22.1、1.22.1-dev、1.22、1.22-dev、1.21、1.21-dev、1.20.4、1.20.4-dev、1.20.3、1.20.3-dev、1.20.2、1.20.2-dev、1.20、1.20-dev、1.19.1、1.19.1-dev、1.19、1.19-dev、1.18.1、1.18.1-dev、1.18、1.18-dev、1.17.1.1、1.17、1.16.2、1.16.1、1.15.2、1.15.1、1.14、1.14.1、1.14.2

使用方法

hledger-web

默认情况下，容器会启动hledger-web，监听5000端口，从data卷读取日记帐文件hledger.journal。假设您的日记帐文件位于~/journals/all.journal，可运行：

docker run --rm -d -e HLEDGER_JOURNAL_FILE=/data/all.journal -v "$HOME/journals:/data" -p 5000:5000 --user $(id --user) dastapov/hledger

然后访问http://localhost:5000使用hledger-web。

如果已定义LEDGER_FILE环境变量，可尝试：

docker run --rm -d -e HLEDGER_JOURNAL_FILE=/data/$(basename $LEDGER_FILE) -v "$(dirname $LEDGER_FILE):/data" -p 5000:5000 --user $(id --user) dastapov/hledger

您提供的任何额外参数都会传递给hledger-web。

GitHub仓库包含简化调用的辅助脚本：

./run.sh ~/journals/all.journal web

环境变量

• HLEDGER_JOURNAL_FILE
  • 输入文件（默认：/data/hledger.journal）
• HLEDGER_HOST
  • 设置TCP主机（默认：0.0.0.0）
• HLEDGER_PORT
  • 设置TCP端口（默认：5000）
• HLEDGER_DEBUG
  • 调试输出（默认：1，增大可获取更多输出）
• HLEDGER_BASE_URL
  • 设置基础URL（默认：http://localhost:$HLEDGER_PORT）
• HLEDGER_RULES_FILE
  • CSV转换规则文件（默认：/data/hledger.rules）
• HLEDGER_ARGS
  • 要传递给hledger-web的额外参数。您也可以在命令行提供额外参数，但环境变量在docker-compose配置中更有用。

shell中的hledger命令行

通过为docker run提供替代启动命令，可以在容器中运行hledger命令行版本（或hledger-iadd、hledger-ui等）。

您可以直接进入容器的shell（记得包含-it）：

docker run --rm -it -v "$HOME/hledger-data:/data" --user $(id --user) dastapov/hledger bash

GitHub仓库包含简化调用的辅助脚本：

./run.sh ~/journals/all.journal bash

通过docker run直接调用hledger命令行

可以使用docker run直接调用hledger：

docker run --rm -v "$HOME/hledger-data:/data" --user $(id --user) dastapov/hledger hledger -f /data/hledger.journal stats

确保为docker run提供--rm参数，否则容器会保留在容器 registry 中，这可能不是您想要的。

用于hledger开发

可以使用提供的Dockerfile获取hledger开发环境。构建目标dev会生成基于Debian的镜像，包含stack和hledger的所有构建依赖：

docker image build --tag hledger-dev --target dev .

或者，可通过latest-dev或VERSION-dev标签使用预构建镜像：

docker run --rm -it -v "$HOME/hledger-data:/data" dastapov/hledger:latest-dev bash