本篇咱们来聊一个能改善酒友和饮品收藏爱好者生活的小工具：BarKeep，一个开源的酒柜/库存管理系统。

赛博酒柜，不过话说回来，笔者现实朋友还真没爱好收藏酒的～

项目介绍

BarKeep 是一个基于 Ruby on Rails 开发的开源库存管理系统。它的定位明确：不是给大型企业用的 ERP，也不是玩票性质的半成品，而是一个轻量级、功能刚好的管家，帮你把家里的酒柜、吧台甚至小型店铺的库存都管理起来。

核心功能

分类与搜索：支持按照酒类、原料、饮品等分类，还能快速搜索定位；

图片上传：给每瓶酒、每种原料配上照片，看起来更直观；

库存提醒：能自动标记低库存甚至缺货的物品，不怕临时发现少了朗姆酒；

补货 Dashboard：集中显示需要补充的物品，省去翻箱倒柜；

用户登录与认证：默认有管理员账号，也可以进一步扩展用户体系；

Docker 部署：官方直接提供了容器镜像，一条命令就能跑起来。

简单来说，BarKeep 就是一个数字化酒柜。我们再也不用担心忘记自己买过几瓶威士忌、几瓶精崂，也不用在聚会前临时冲去超市。只要打开网页，库存一目了然。

部署流程

我们以威联通NAS为例，通过Docker Compose的方式进行部署。

首先，SSH输入以下命令，生成KEY：

docker run --rm ghcr.io/nckslvrmn/bar_keep:latest rails secret

可以看到很长一大串，如果你没有下载镜像，会自动下载然后执行命令～将这长串复制备用。

官方的docker cli如下，未做任何改动，个人不太喜欢这种方式：

docker run -d \
  --name barkeep-dev \
  -p 3000:3000 \
  -v $(pwd)/storage:/app/storage \
  -e SECRET_KEY_BASE=YOUR_GENERATED_SECRET_KEY_HERE \
  -e ALLOWED_HOST=localhost \
  -e FORCE_SSL=false \
  bar_keep:latest

建议使用Docker Compose部署，以下代码已经适配威联通NAS：

services:
  barkeep:
    image: ghcr.io/nckslvrmn/bar_keep:latest
    container_name: barkeep-dev
    restart: always
    ports:
      - "2929:3000" # 冒号左侧端口可改
    volumes:
      - /share/Container/barkeep/storage:/app/storage # 左侧目录可改
    environment:
      - SECRET_KEY_BASE=46aa127ab464dbd7272e41484cfb478c3603da85f20fb007d1ac2c4c9d522a5dfb54e03d11078922409c59fac2cdf71b7f79f2e75842f97e5d81931d80109583 # 替换上面的KEY
      - ALLOWED_HOST=192.168.50.20 # 如果反代用域名访问，这里就填写域名
      - FORCE_SSL=false # 强制SSL，这条默认就行，反代工具可以设置
      - SEED_DATABASE=true # 数据库

另外还有RAILS_ENV可配置部署环境（生产/开发）。BarKeep 默认使用 SQLite，数据库存储在storage目录中。

我还要额外强调。你如果后来上了反代，请确保转发的 Host 和 ALLOWED_HOST 一致。README 也强调「反代时 Host 要匹配代理转发的值」。与以往不同的是，这里无需补齐端口号。

将上面内容按照你的实际情况进行修改，打开Container Station创建新的应用程序。

使用流程

因为是远程在搞，所以就用威联通自带的Browser Station来折腾下。输入NAS_IP:2929即可访问服务。默认的账户密码：admin/changeme123。后续我就反代出来演示了。

实际情况是内网虽然能访问登陆界面，但输入账密并不能登录，会卡停留在这个界面。

登陆后如下图所示，添加第一件商品。

逐个填入信息，然后创建项目。

如下所示。

添加多个后的效果。

最后

新项目，用的上的话，体验我认为还可以。

感谢观看，本文完～

饮品分类：

1. Alcohol

指所有基础烈酒和含酒精饮品的统称，例如：啤酒、葡萄酒、伏特加、威士忌、朗姆酒、龙舌兰、白兰地等。它是鸡尾酒的主要酒精基底。

2. Liqueur

指“利口酒”或“甜酒”，通常在烈酒中加入糖、果汁、香草、香料或奶油调味。例如：百利甜（Baileys）、君度橙酒（Cointreau）、咖啡甜酒（Kahlúa）、杏仁甜酒（Amaretto）。它们多用于调味和增加风味层次。

3. Juice

果汁类原料，例如：橙汁、菠萝汁、柠檬汁、蔓越莓汁。一般用于平衡酒精口感或增加清爽感。

4. Syrup

糖浆类原料，通常是高浓度糖水或加入风味的糖浆。例如：单糖浆（Simple Syrup）、红石榴糖浆（Grenadine）、蜂蜜糖浆、枫糖浆。主要用于增加甜度和口感。

5. Ingredient

更广泛的原料类，不一定是液体，可能包括：薄荷叶、盐、胡椒、奶油、蛋清、椰奶、香草等。用于丰富鸡尾酒风味和层次。

6. Other

无法归类到上述分类的特殊原料。例如：苏打水、汤力水、能量饮料、椰子水、茶、咖啡，甚至某些独特的调味品。