Wallos 5.10.2 介绍与选型指南
Wallos 是一款开源可自托管的个人订阅追踪器（PHP 8.3 + SQLite），本文说清其定位、架构、功能清单，并与 Firefly III、Actual、Ghostfolio、Maybe 量化对比给出选型结论。
Wallos 5.10.2 介绍与选型指南
目标：说清 Wallos 是什么、解决什么问题、技术架构如何，并通过与同类个人财务/订阅管理工具的量化对比给出选型结论。本文为认知篇，全部信息来自官方渠道联网溯源（查询日期 2026-10-25），不涉及本地实测。
一、环境信息
- 软件版本：Wallos v5.10.2（官方 GitHub Releases 最新稳定版，查询日期 2026-10-25）
- 官方仓库：https://github.com/ellite/Wallos
- GitHub Stars：8.7k（shields.io 徽章实查，查询日期 2026-10-25）
- 开源协议：GNU General Public License v3（GPLv3）
- 技术栈：PHP 8.3 + SQLite + NGINX/Apache（官方 README 明确要求）
- 官方镜像：
bellamy/wallos（Docker Hub，含latest与5.10.2等版本 tag） - 官方演示站：https://demo.wallosapp.com（账号 demo / demo，数据库每 2 小时重置）
- 落地与文档站：https://wallosapp.com、https://api.wallosapp.com（API 文档）
二、软件概述
Wallos 是一款开源、可自托管的个人订阅追踪器（Personal Subscription Tracker）。它解决的核心问题是：流媒体、云服务、软件会员、域名续费等周期性订阅越来越多，靠脑子或电子表格很难记清「每个订阅多少钱、下次什么时候扣款、一年总共花多少」。Wallos 把这些订阅统一登记到一个 Web 应用里，提供统计视图、日历视图和到期通知，让个人或家庭对周期性支出做到心里有数。
项目由葡萄牙开发者 Henrique（henrique.pt）以个人项目形式维护，采用 GPLv3 协议开源。作者在 LICENSE 旁专门写了「Why GPLv3」一节，强调衍生作品必须以同协议发布，保证软件永远自由。项目接受社区 PR，并有 Discord 社区与在线 Demo。
💡 技术拓展：个人/家庭财务管理类自托管软件大致分三个方向——
方向 代表 特点 订阅/周期性支出追踪 Wallos 专注「订阅清单 + 到期提醒 + 花费统计」，轻量 复式记账全量财务 Firefly III、Actual 账户、预算、报表齐全，但录入成本高 净资产/投资追踪 Ghostfolio、Maybe 偏资产与投资组合，不适合纯订阅提醒 Wallos 属于第一类：不做复式记账，只盯「周期性订阅支出」这一件事。
三、核心架构
Wallos 是典型的传统 LEMP/LAMP 单体 PHP 应用，架构非常轻：
- 后端：PHP 8.3（官方要求 8.3，并需启用 curl、dom、gd、intl、openssl、sqlite3、zip、mbstring、fpm 模块），页面以服务端渲染的
.php页面为主（index.php、stats.php、calendar.php、settings.php、admin.php 等）。 - 前端：原生 HTML/CSS/JS，提供明暗双主题与移动端视图，支持 PWA（含 manifest 与 service-worker）。
- 数据库：内嵌 SQLite，单文件
db/wallos.db，迁移脚本在首次打开注册页时自动执行；另提供endpoints/db/migrate.php供升级时手动执行。 - 定时任务：依靠系统 cron 定期执行
endpoints/cronjobs/*.php脚本（更新下次付款日期、更新汇率、发送通知、生成 AI 推荐、检查新版本等）。 - 外部集成：Fixer API（汇率换算）、SMTP/Mailgun 等邮件通道、Discord/Telegram/Gotify/Pushover/Webhook/Ntfy 等通知通道、OIDC/OAuth 单点登录、ChatGPT/Gemini/本地 Ollama 的 AI 订阅建议。
- API：内置 REST 风格 API（
api/目录），以用户级 API Key 鉴权，官方文档在 api.wallosapp.com。
💡 技术拓展：自托管应用常见的数据库选型——
数据库 形态 适用场景 SQLite 内嵌单文件，零运维 单机、单用户/家庭、中小数据量 MySQL/MariaDB 独立服务进程 多用户并发、需要远程访问 PostgreSQL 独立服务进程 复杂查询、强一致性业务 Wallos 定位个人/家庭单实例，采用 SQLite：备份=复制一个文件，恢复=放回去，运维成本几乎为零。
四、功能特性
依据官方 README（查询日期 2026-10-25），Wallos 的功能清单如下：
- 订阅管理：登记周期性订阅与付款，含价格、币种、扣款周期、下次付款日期、支付方式、付款人（家庭成员）、分类、备注、官网链接，支持「自动续费/手动续费/已停用」状态与「替代订阅」关联。
- 统计视图：按月度/年度汇总支出，含分类占比等维度。
- 日历视图：以月历形式展示各订阅的扣款日。
- 多币种与汇率换算：支持多币种登记订阅，可接入 Fixer API 获取汇率，把所有订阅折算到主币种展示。
- 到期与取消提醒：支持邮件、Discord、Pushover、Telegram、Gotify、Webhook（另含 Ntfy、Mattermost、Pushplus、Server 酱等）多渠道通知，可设置提前 N 天提醒。
- 分类管理：自定义支出分类，观察消费习惯。
- Logo 搜索：没有订阅方 Logo 时可联网搜索获取。
- 排序与筛选：多视角查看订阅清单。
- 移动端视图与 PWA：手机上也能方便使用。
- 多语言：社区翻译机制，含简体中文。
- OIDC/OAuth 单点登录：管理页可开启，亦支持
OIDC_*环境变量声明式配置。 - AI 订阅建议：接入 ChatGPT、Gemini 或本地 Ollama，周期性生成订阅优化建议（由 cron 任务驱动）。
- 多用户/家庭成员：支持家庭成员（household）作为付款人维度，管理员可在 Admin 页管理用户与站点设置。
五、快速开始（最小可用示例）
官方给出两条最小路径（源自官方 README，查询日期 2026-10-25）：
方式一：Docker 单容器
docker run -d --name wallos \
-v /path/to/config/wallos/db:/var/www/html/db \
-v /path/to/config/wallos/logos:/var/www/html/images/uploads/logos \
-e TZ=Asia/Shanghai \
-p 8282:80 --restart unless-stopped \
bellamy/wallos:5.10.2
方式二：裸机（NGINX + PHP 8.3-FPM）
# 1. 下载源码到 Web 根目录并改名数据库种子文件
mv /var/www/html/db/wallos.empty.db /var/www/html/db/wallos.db
# 2. 浏览器打开站点，在注册页创建首个账号（迁移自动执行）
# 3. 配置 cron 定时任务（更新付款日/汇率/通知等，详见安装篇）
两种方式启动后都是：浏览器打开 http://服务器IP:端口 → 注册首个账号 → 进入设置页完善币种/分类/通知渠道 → 开始登记订阅。
六、适用场景与限制
适用场景：
- 个人/家庭追踪流媒体、SaaS、域名、服务器等周期性订阅，避免「忘记取消被自动续费」。
- 多币种订阅（如同时订阅 Netflix USD、iCloud CNY）需要统一折算成本币看总账。
- 希望在扣款前几天收到 Telegram/邮件/Webhook 提醒。
- NAS/家庭服务器玩家想要一个零依赖、单文件数据库的轻量应用。
限制（依据官方文档与项目定位）：
- 不是复式记账软件：没有账户、转账、预算、资产负债表；需要完整记账请看 Firefly III / Actual。
- SQLite 单文件数据库：面向单机单实例，不适合多节点横向扩展或高并发团队场景。
- 汇率换算依赖 Fixer API（需自行申请免费 Key），不配置则多币种折算不可用。
- 通知、AI 建议、汇率更新依赖 cron 定时任务，裸机部署需手工配置 crontab（官方镜像已内置）。
- 无原生移动端 App，靠响应式页面 + PWA。
七、同类选型对比
对比对象取自 Awesome Selfhosted「Money, Budgeting & Management」分区主流项目，星数为 shields.io 徽章实查（查询日期 2026-10-25），版本以各项目 GitHub Releases 最新稳定版为准。
| 维度 | Wallos | Firefly III | Actual Budget | Ghostfolio | Maybe |
|---|---|---|---|---|---|
| GitHub Stars | 8.7k | 25k | 30k | 9.6k | 54k |
| 定位 | 订阅追踪 | 复式记账全量财务 | 预算/记账（本地优先） | 投资/净资产追踪 | 全能个人财务 |
| 技术栈 | PHP 8.3 + SQLite | PHP + MySQL/PostgreSQL | Node.js + SQLite | NestJS + PostgreSQL | Ruby on Rails + PostgreSQL |
| 部署重量 | 极轻（单 PHP 应用） | 中等（需独立数据库） | 轻 | 重（多服务） | 重 |
| 到期提醒 | 多渠道内置 | 无（靠规则/报表） | 无 | 无 | 有限 |
| 复式记账 | 无 | 完整 | 完整 | 无 | 完整 |
| 学习/录入成本 | 低 | 高 | 中 | 低 | 中 |
| 协议 | GPLv3 | AGPLv3 | MIT | AGPLv3 | AGPLv3（仓库状态需关注） |
选型建议：
- 只想管「订阅什么时候扣钱、一年花多少、快到期提醒我」→ Wallos，部署最简单、心智负担最低。
- 要正规复式记账、预算、财务报表 → Firefly III（功能最全但最重）。
- 喜欢「信封预算法」、本地优先/桌面体验 → Actual。
- 主要需求是股票/基金/加密资产净值追踪 → Ghostfolio。
- 想要现代化全能财务仪表盘且能接受较新项目的波动 → Maybe。
版本节奏：Wallos 在 2026 年保持活跃迭代，近期版本线 v5.7 → v5.8 → v5.9 → v5.10（v5.10.2 为 2026-10-25 实查的最新稳定版），修复与小特性发布频率较高；升级方式为覆盖源码 + 执行迁移脚本（裸机）或更换镜像 tag（容器）。
八、参考链接
- 官方仓库：https://github.com/ellite/Wallos
- Releases：https://github.com/ellite/Wallos/releases
- 官方站/演示：https://wallosapp.com 、https://demo.wallosapp.com
- API 文档：https://api.wallosapp.com/
- 作者博客：https://henrique.pt
- 对比项目：https://github.com/firefly-iii/firefly-iii 、https://github.com/actualbudget/actual 、https://github.com/ghostfolio/ghostfolio 、https://github.com/maybe-finance/maybe