HomeBox

文档 | 演示 | ***

什么是 HomeBox

HomeBox 是一款为家庭用户打造的库存与组织系统！专注于简洁易用，是满足家庭库存管理、物品组织需求的理想解决方案。在开发过程中，我们始终遵循以下原则：

• 🧘 简单但可扩展 - HomeBox 设计简洁，易于使用，无需复杂的设置或配置。同时支持根据基础设施需求进行灵活扩展。
• 🚀 极速性能 - HomeBox 采用 Go 语言开发，运行速度极快且部署资源需求极低。通常，整个容器的空闲内存占用不到 50MB。
• 📦 便携性 - HomeBox 设计为可在任何环境运行。通过使用 SQLite 和嵌入式 Web UI，实现了轻松部署、使用和备份。

核心功能

• 📇 丰富的组织方式 - 将物品分类到类别、位置和标签中。还可创建自定义字段来存储物品的额外信息。
• 🔍 强大的搜索功能 - 使用强大的搜索功能快速查找库存中的物品。
• 📸 图片上传 - 上传物品图片以便快速识别。
• 📄 文档与保修跟踪 - 跟踪物品的重要文档和保修信息。
• 💰 购买与维护跟踪 - 记录物品的购买日期、价格和维护计划。
• 📱 响应式设计 - HomeBox 支持在任何设备上使用，包括桌面电脑、平板和智能手机。

截图

您也可以尝试 Homebox 的演示实例：

• 演示
• nightly 版本

快速开始

配置与 Docker Compose

# 如果使用 rootless 或 hardened 镜像，请确保数据文件夹具有正确权限
mkdir -p /path/to/data/folder
chown 65532:65532 -R /path/to/data/folder
docker run -d \
--name homebox \
--restart unless-stopped \
--publish 3100:7745 \
--env TZ=Europe/Bucharest \
--volume /path/to/data/folder/:/data \
ghcr.io/sysadminsmedia/homebox:latest
# ghcr.io/sysadminsmedia/homebox:latest-rootless
# ghcr.io/sysadminsmedia/homebox:latest-hardened

贡献指南

贡献是开源社区之所以成为学习、启发和创造的绝佳场所的原因。您的任何贡献都将受到高度赞赏。

如需开始基于代码的贡献，请参阅我们的贡献指南。

如果您不是开发人员且无法协助翻译，仍可通过财务方式贡献。财务支持有助于我们维护项目并维持演示环境运行。

帮助我们翻译

我们希望确保 Homebox 支持尽可能多的语言。如果您有兴趣帮助我们翻译 Homebox，请通过我们的Weblate 实例提供协助。

致谢

• 原始项目由 https://github.com/hay-kot 创建
• Logo 由 https://github.com/lakotelman 设计

贡献者