LedgerSMB 1.13.8 介绍与选型指南

目标：面向需要"复式记账 + 进销存/应收应付"的中小企业技术选型者，讲清 LedgerSMB 的定位、架构、功能边界与同类产品量化对比，帮助判断它是否适合自己的业务。本文全部数据溯源自官方渠道（ledgersmb.org、GitHub 官方仓库与 Releases、官方 FAQ），查询日期为 2026-10-24。

一、环境信息（溯源与取证范围）

本文为认知与选型篇，内容仅联网溯源官方一手来源，未做本地实测改造。取证来源与查询日期如下：

• LedgerSMB 官网主页与特性说明：https://ledgersmb.org/（查询日期 2026-10-24）
• 官方发布下载目录：https://download.ledgersmb.org/f/Releases/（查询日期 2026-10-24，目录内当前仅列出 1.13.8/，目录时间戳 2026-09-04）
• 官方 GitHub 仓库 README（1.13 稳定分支）：https://github.com/ledgersmb/LedgerSMB/blob/1.13/README.md（查询日期 2026-10-24）
• 官方 1.13.8 发布页：https://github.com/ledgersmb/LedgerSMB/releases/tag/1.13.8（查询日期 2026-10-24）
• 官方 FAQ（版本生命周期/支持策略）：https://ledgersmb.org/faq（查询日期 2026-10-24）
• 官方在线手册《Running your business with LedgerSMB》：https://book.ledgersmb.org/（查询日期 2026-10-24）
• GitHub 星数、最新版本徽章取自 shields.io 对各项目仓库的实时渲染（查询日期 2026-10-24），License 取自各仓库页面内嵌元数据（查询日期 2026-10-24）

版本结论（实查）：

💡 说明：1.13.8 发布页同时给出 docker pull ledgersmb/ledgersmb:1.13.8 与 ghcr.io/ledgersmb/ledgersmb:1.13.8 两种官方镜像获取方式，说明容器化交付是官方一等公民的发布形态；部署实操见本专栏部署篇（文末参考链接）。

二、软件概述

LedgerSMB 是一个免费、开源、基于 Web 的复式记账（double-entry accounting）与 ERP 系统，面向中小企业（Small and Medium business），主打"把财务账做对"：报价单（Quotations）、订单（Ordering）、开票（Invoicing）、项目（Projects）、工时单（Timecards）、库存管理（Inventory）、发货（Shipping）等功能在同一个账套内闭环。官方在项目方向声明中将其定位为"为中小企业提供坚实的开源会计软件基础——集成开票、订单处理、报价等 ERP 能力，并强调多币种记账的正确性与性能，避免供应商锁定"（来源：官网 Mission，查询日期 2026-10-24）。

历史沿革（来源：仓库版权声明与官网，查询日期 2026-10-24）：项目血统可追溯到 1999 年 DWS Systems 公司的 SQL-Ledger；2006 年社区从 SQL-Ledger 分叉出 LedgerSMB。仓库版权头写明 Copyright (c) 2006 - 2024 The LedgerSMB Project contributors 与 Copyright (c) 1999 - 2006 DWS Systems Inc (under the name SQL Ledger)，即它继承了 SQL-Ledger 二十余年的账务代码演进。

基本身份（实查汇总）：

💡 说明：GitHub 星数（2026-10-24 实查 570）在同类中偏低，这与它的用户画像有关——LedgerSMB 的使用者是"要跑真账的小企业财务人员与代理记账服务商"，而不是极客工具型产品的普罗大众；评估社区健康度时应更多关注其持续发布节奏（1.13 系列自 2025-10 起已连发 8 个点版本）与官方 EOL 承诺（见上表）。

三、核心架构

LedgerSMB 是典型的"胖数据库"三层 Web 应用：应用层很薄，账务规则大量下沉到 PostgreSQL 内部。理解这一点对后续部署与运维都非常关键——数据库不是"存数据的地方"，而是账本本身。

架构分层（依据官方 README、官方书与仓库代码结构归纳，来源查询日期 2026-10-24）：

浏览器（Chrome/Firefox/Edge/Safari 等，见 1.13 README 兼容矩阵）
        │  HTTP/HTTPS（生产建议 nginx/Apache 反代，官方标注"仅生产环境必需"）
        ▼
LedgerSMB 应用层（Perl，PSGI 兼容运行，路由形如 login.pl / setup.pl）
        │  每个请求以数据库会话为边界
        ▼
PostgreSQL（1.13 要求 13+；每个公司 = 一个独立数据库）
   ├── 数据表：总账、应收/应付、库存、固定资产、部门/项目等
   ├── PL/pgSQL 存储过程与触发器：记账规则、数据一致性检查（1.13 重点强化项）
   └── 每公司一库 → 天然的多公司隔离与备份边界

关键架构事实：

1. 一个公司一个 PostgreSQL 数据库：账套（company）与数据库一一对应，多公司并发登录（同一浏览器登录多个公司）是 1.13 的主打新特性（官网主页，查询日期 2026-10-24）。这使备份/恢复、迁移的最小单位天然是"库"。
2. 业务逻辑双栖：Perl 应用层负责请求编排与页面渲染，账务正确性依赖数据库内的存储过程与约束；因此 PostgreSQL 版本兼容性是升级时最敏感的约束（官方 FAQ 与 README 均明确版本要求）。
3. 输出模板化：对客户可见的单据（发票、订单、报表）走模板系统，支持 PDF、HTML、CSV、ODF（OpenDocument）等格式，模板可自行定制（README 描述）。
4. 内置邮件发送：可直接把发票/订单以 PDF 附件从系统内发给客户或向供应商发出询价（README 描述）。
5. 多语言：自带 45 种语言翻译，翻译经 Transifex 平台协作（官网主页、README）。

💡 技术拓展：本文标题中的"复式记账"是会计记账法的核心分野，选型前值得花一分钟分清：

记账法	原理	特点	典型软件
复式记账	每笔交易同时在至少两个科目登记（借贷相等）	有自校验能力，能出资产负债表/利润表，审计友好	LedgerSMB、GnuCash、Tryton
单式记账（流水式）	只按收支流水记录	简单直观，但无法自证账目平衡	各类个人记账 App
现金收付制 vs 权责发生制	确认收入/费用的时点不同	企业账普遍要求权责发生制	LedgerSMB 支持应收应付挂账

LedgerSMB 属于严格的复式记账 + 权责发生制路线，这是它区别于"个人流水记账"类软件（如 Firefly III 的轻量用法）的根本点。本文及部署、配置、API 各篇实际采用的正是这一复式记账主线。

四、功能特性

以下特性清单实查自官网主页与 GitHub README（查询日期 2026-10-24）：

💡 说明：与"全家桶式 ERP"（自带 CRM/官网/电商）不同，LedgerSMB 刻意把边界收在"会计 + 围绕会计的进销存"上。官网 Mission 强调"correctness and performance equally important"（正确性与性能并重），并称即使在大数据集上也坚持两者。这是理解它功能取舍的钥匙：它不追求功能多，追求账对。

五、快速开始（官方上手途径）

本节为官方文档转述（来源：GitHub 1.13 分支 README、官网安装指引页 https://ledgersmb.org/content/installing-ledgersmb-113，查询日期 2026-10-24），帮助读者在选型前了解上手成本。

途径 A：官方源码 tarball 安装（生产部署的从零安装路径）：

# 1. 下载 1.13.8 发布包（官方下载站点）
wget https://download.ledgersmb.org/f/Releases/1.13.8/ledgersmb-1.13.8.tar.gz
# 2. 校验完整性（sha256 取自 GitHub 1.13.8 发布页）
sha256sum ledgersmb-1.13.8.tar.gz
# 预期：d996090172d72c4415537e8a383ca847dcd2cbaed28c704acbb33d63b865d1ea
# 3. 解压到部署目录后，按官方安装页安装 Perl 依赖（cpanm/发行版包）、
#    配置 PostgreSQL 与 ledgersmb.conf，最后以 PSGI 方式托管启动

前置要求（1.13 README 实查）：服务器端 Perl 5.36.1+、PostgreSQL 13+；生产环境还需前置 nginx/Apache/lighttpd/Varnish 之一做 Web 服务器。

途径 B：官方容器编排样例（README 提供的评估用快速路径）：官方在 ledgersmb-docker 仓库维护了 1.13 分支的 docker-compose.yml 样例，wget 下载后一条 docker compose up -d 即可同时起应用与数据库，默认通过 5762 端口访问 setup.pl（公司库创建）与 login.pl（日常登录）。官方 README 同时明确警示：该样例不含 TLS 加密，不适合生产；并提醒"不要使用非官方或 AI 生成的编排样例，它们经常不完整、静默失效或缺少必需服务"。

💡 说明：途径 B 的完整落地（含 PostgreSQL 依赖链、数据持久化、首次建账）在本专栏《LedgerSMB 1.13.8 Docker Compose 部署指南》中有从零到一的实测演练；从零 tarball 安装的 systemd 托管路径同见该篇的对比与参考。

六、适用场景与限制

适用场景（基于官方定位与功能域推断，来源查询日期 2026-10-24）：

1. 需要"真账"的中小企业：要出标准资产负债表/利润表，需要应收应付、固定资产折旧、成本中心核算。
2. 多公司代账/集团多账套：一个公司一个库的模型天然适合代账公司或小集团。
3. 多币种业务：1.13 报表按币种拆分余额，适合有外币往来的贸易型公司。
4. 数据主权与长期可控：数据全部在自己的 PostgreSQL 里，账簿可 SQL 级审计，无订阅费、无锁定。

限制与注意（实查汇总）：

1. 版本生命周期硬约束：1.13 EOL 为 2027-10-04（官方 FAQ），到点必须升大版本；1.12 已定于 2026-12-14 停止支持——选型落地请直接从 1.13.x 开始，不要从 1.12 起步。
2. 数据库版本依赖：1.13 要求 PostgreSQL 13+，1.14（开发中）要求 PostgreSQL 14+（README 实查）；规划宿主机/托管数据库版本时要预留余量。
3. Perl 技术栈：二次开发需要 Perl 能力储备；社区贡献者规模较小（星数 570 实查），遇到深水区问题主要靠官方矩阵频道与邮件列表。
4. Safari 浏览器必须走 HTTPS：1.13 README 明确 Safari 对纯 HTTP 访问不受支持——生产部署必须配 TLS。
5. 官方容器样例非生产级：官方明确其 compose 样例缺 TLS、不满足生产要求，生产需自行前置 Web 服务器与证书。
6. 界面为传统 Web 表单风格：以 Quasar 框架改进 UI（1.13 亮点之一），但整体交互仍是"账务软件"型，不适合期待消费级颜值的团队。

七、同类选型对比

对比范围：开源领域与"记账/ERP"相关的六款常见产品 + GnuCash 作参照。全部量化数据实查于 2026-10-24（GitHub 星数与最新版本徽章取自 shields.io 实时渲染，License 取自各仓库页面内嵌元数据）：

表格解读（关键差异与如何选）：

1. 账务正统性：LedgerSMB 与 Tryton 是"数据库内核级复式记账"路线（账务规则在 PostgreSQL 内），Odoo/ERPNext 是"应用层记账"路线（灵活但账务深度依赖模块配置），GnuCash/Firefly III 则偏个人场景。要"代理记账级"的账，前者更对口。
2. 社区与生态：Odoo/ERPNext/Firefly III 星数高一个数量级，插件与教程生态最丰富；LedgerSMB 社区小但发布纪律好（1.13 系列八连发 + 明确 EOL 表），属于"小而稳"。
3. 技术栈人力：团队熟悉 PHP 可先看 Dolibarr/Akaunting；熟悉 Python 看 Odoo/ERPNext/Tryton；熟悉 Perl 或有历史 SQL-Ledger 资产，LedgerSMB 几乎是唯一延续血统的现代化选项。
4. 多币种与多公司：LedgerSMB 把两者做成账套内核能力（每公司一库、报表按币种拆分），Odoo 多公司靠配置、多币种靠模块——需要时都能做，但深度不同。

「如果……则……」选型建议：

• 如果你要的是个人/家庭记账——不要选 LedgerSMB，选 Firefly III 或 GnuCash（轻、社区大）。
• 如果你要**"五脏俱全"的全功能 ERP（CRM、电商、制造）且接受模块化调教**——选 Odoo 或 ERPNext，LedgerSMB 功能面明显更窄。
• 如果你的核心诉求是严格复式记账 + 应收应付/固定资产/多币种/多公司账套，团队能接受 Perl 栈与朴素界面——LedgerSMB 是同赛道里最纯粹的开源选择，且官方镜像让部署成本可控。
• 如果你是 SQL-Ledger 老用户寻找延续——LedgerSMB 即其直系后裔（1999 年血统可考），迁移路径官方有支持。
• 如果你的企业正在 1.12 上运行——官方 EOL 为 2026-12-14，应尽快规划升级到 1.13.x。

八、参考链接

• 官网：https://ledgersmb.org/
• GitHub 仓库：https://github.com/ledgersmb/LedgerSMB
• 1.13.8 发布页（含 sha256）：https://github.com/ledgersmb/LedgerSMB/releases/tag/1.13.8
• 官方下载站点：https://download.ledgersmb.org/f/Releases/
• 官方安装指引（1.13 tarball）：https://ledgersmb.org/content/installing-ledgersmb-113
• 首次使用准备指引：https://ledgersmb.org/content/preparing-ledgersmb-113-first-use
• 官方在线手册：https://book.ledgersmb.org/
• 官方 FAQ（版本生命周期）：https://ledgersmb.org/faq
• 官方镜像（Docker Hub）：https://hub.docker.com/r/ledgersmb/ledgersmb/
• 本专栏同系列：部署实操见《LedgerSMB 1.13.8 Docker Compose 部署指南》，参数精读见《LedgerSMB 1.13.8 配置参数详解》，接口调用见《LedgerSMB 1.13.8 API 使用详解》。