l4rm4nd/VoucherVault

这是什么？

核心功能

• 01存储优惠券、代金券、礼品卡和会员卡及其兑换码。
• 02以二维码或条形码展示兑换码，新建时可通过摄像头或文件扫描识别。
• 03通过 Apprise 发送到期提醒。
• 04支持多用户、卡片共享和 OIDC 单点登录。
• 05提供适配移动端的 PWA，支持 48 小时离线缓存。
• 06提供 REST API，可为 Home Assistant 等仪表盘提供统计数据。

适用场景

• 将多家商店的会员卡和礼品卡集中到一个数字钱包中。
• 在优惠券或代金券过期前收到提醒。
• 在家庭服务器上与家人共享礼品卡。
• 在 Home Assistant 仪表盘上展示优惠券统计信息。

快速上手

1. 1

   创建持久化卷目录

   mkdir -p ./volume-data/database
2. 2

   将卷目录所有者调整为 www-data（UID/GID 33）

   sudo chown -R 33:33 volume-data/*
3. 3

   使用 Docker Compose 启动容器

   docker compose -f docker/docker-compose-sqlite.yml up -d
4. 4

   访问 http://127.0.0.1:8000，并从容器日志中获取自动生成的 admin 密码

   docker compose -f docker/docker-compose-sqlite.yml logs -f

使用前须知

• !需要 Docker；若用于生产环境，建议配合带 TLS 的反向代理。
• !自托管需要手动调整卷目录权限并进行环境变量配置。
• !采用 GPL-3.0 许可证，这是一种 copyleft 许可，衍生作品需要同样开源。

收录于专题

标签

常见问题

VoucherVault 是什么？

基于 Django 的自托管应用，用于数字化管理优惠券、代金券、会员卡和礼品卡，并支持到期提醒。 VoucherVault 是一个自托管的 Django Web 应用，用于在一处统一管理优惠券、代金券、会员卡和礼品卡。每张卡片可保存兑换码，并以二维码或条形码形式展示，还能上传图片或 PDF 附件。礼品卡支持记录交易历史。

VoucherVault 可以免费使用吗？用的什么许可证？

VoucherVault 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

VoucherVault 还在维护吗？

活跃维护中。VoucherVault 最近一次提交是在 2026年11月3日。

VoucherVault 适合用来做什么？

将多家商店的会员卡和礼品卡集中到一个数字钱包中。 在优惠券或代金券过期前收到提醒。 在家庭服务器上与家人共享礼品卡。 在 Home Assistant 仪表盘上展示优惠券统计信息。

VoucherVault 怎么安装和运行？

创建持久化卷目录: mkdir -p ./volume-data/database 将卷目录所有者调整为 www-data（UID/GID 33）: sudo chown -R 33:33 volume-data/* 使用 Docker Compose 启动容器: docker compose -f docker/docker-compose-sqlite.yml up -d 访问 http://127.0.0.1:8000，并从容器日志中获取自动生成的 admin 密码: docker compose -f docker/docker-compose-sqlite.yml logs -f

在哪里获取 VoucherVault？

源代码和安装说明在 GitHub 上：https://github.com/l4rm4nd/VoucherVault