家庭库存管理神器Homebox一键部署教程,NAS轻松搭建物品管理系统,帕斯内网穿透实现远程访问!
作者
小编
发布时间

项目介绍
Homebox 是一个专为家庭用户设计的库存和组织管理系统!它专注于简单性和易用性,是您家庭库存、组织和管理需求的完美解决方案。这个项目在开发过程中始终坚持以下原则:
简单 - Homebox 设计简单易用,无需复杂的设置或配置。使用单个 docker 容器即可部署,或者为您选择的平台编译二进制文件自行部署。
极速 - Homebox 使用 Go 语言编写,运行极快且资源占用极少。一般情况下,整个容器的空闲内存使用量不到 50MB。
便携 - Homebox 设计为便携式,可在任何地方运行。使用 SQLite 和嵌入式 Web UI,使其易于部署、使用和备份。
主要功能包括:创建和管理物品、保修信息管理、CSV 导入/导出、自定义报告、二维码标签生成器、通过标签和位置组织物品、多租户支持等。项目界面美观,操作简单,特别适合家庭用户管理各种物品和设备的信息。
项目地址: 点我跳转
部署安装
如需在外也打开项目需要配置内网穿透使用,点击前往 帕斯内网穿透,先注册好账号备用。
打开飞牛 NAS 或其他的 NAS 设备 点击本地镜像-添加镜像-从 URL 添加。这一步先添加 docker 镜像

镜像填
1ghcr.io/hay-kot/homebox:latest
等待下载完成后点击启动按钮启动容器

勾选开机自动启动后下一步,端口设置这里。请设置容器端口为 7745,主机端口为 3100(如果端口冲突可以修改主机端口,但容器端口必须保持 7745)
存储位置这里,需要创建一个文件夹映射到容器的 /data 目录,用于持久化存储数据库和上传的文件。
环境变量设置:
必须设置: TZ: 时区设置,例如 Asia/Shanghai
可选设置: HBOX_LOG_LEVEL: 日志级别,默认 info HBOX_WEB_MAX_UPLOAD_SIZE: 最大文件上传大小(MB),默认 10 HBOX_OPTIONS_ALLOW_REGISTRATION: 是否允许用户注册,默认 true
其他的都不用填写,直接下一步启动就好了。
创建成功后可以访问 ip:3100 到这里就可以正常显示项目了
穿透公网
打开帕斯内网穿透控制台,点击隧道管理-隧道列表

点击创建新隧道
隧道节点可以随便选,一般选个负载低的就可以

接下来填写信息,隧道名称可以随便填写
本地 IP 默认就可以
传输协议可以选择 TCP 也可以选择 HTTP/HTTPS
HTTP 就是域名的形式,教程以使用 TCP 为演示
本项目中如果没有修改端口的话默认是 3100 端口,这里本地端口就填 3100
远程端口可以留空也可以自定义。下图仅做参考,请按照实际项目端口添加。

填写完毕点击确定
点击刚才创建好的隧道,点击获取配置文件

回到飞牛 NAS,点击应用中心下载 frpc 客户端

打开后粘贴刚才复制的配置文件,点击确定即可
复制帕斯内网穿透控制台的访问 IP 和端口
可以看到已经正常穿透成功了
本篇教程结束