企业官网建设流程全解析

InvenTree｜开源库存管理系统，部署完就能查库存录出入库

【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTree

月底盘库的糟心时刻

月底盘库，你盯着 Excel 里三千行对不上的数据，货架上的实物和账面差了一截；新零件入库，供应商渠道、批次、库存位散落在三个表格里；生产领料时，谁也不知道仓里还剩多少。这些库存管理痛点，InvenTree 这个开源库存管理系统一次解决：零件分类、实时库存、条码入库、采购销售单全在一个系统里。浏览器打开就能录库存，不用装客户端，也不用买授权。

5 分钟 Docker 部署 InvenTree 库存管理系统

推荐路径只有一条：用 Docker Compose 把整套环境拉起来。官方 compose 文件自带数据库、Web 服务器、后台任务、反向代理，不用单独装 nginx 和 redis。

克隆仓库，进入容器配置目录：

git clone https://gitcode.com/GitHub_Trending/in/InvenTree cd InvenTree/contrib/container

后台启动全部服务：

docker compose up -d

最高频启动卡点：Caddy 默认要占用宿主机 80/443 端口。机器上已有 nginx 的话，docker compose logs -f caddy里找 "address already in use"，先释放端口再启动。

浏览器打开http://localhost，按提示创建管理员账号就进系统了。控制台里可以直接浏览并调用库存 API：

InvenTree 部署完成后的 Web 控制台，可浏览并调用库存 API 接口

先试这三件事：扫码入库、建BOM、库存调拨

扫码入库

扫一下条码就定位到零件，不用逐字敲零件号，这是仓库日常最高频的操作。

1. 登录 InvenTree，左侧菜单进入 "Stock Items" 页面
2. 顶部搜索框输入或扫描条码，定位目标零件
3. 点击行内操作里的 "Receive"（收货入库）按钮
4. 选择目标库存位、填写数量，确认入库

💡 技巧：零件若标记为序列号管理，入库时会强制录入唯一序列号，重复扫码直接被系统拦住，别硬敲。

批量建BOM并导出

新产品定型后，BOM 结构在后台一次建好，之后每次投产直接引用，不用再去 Excel 里抄。

1. 进入父零件详情页，切到 "BOM" 标签页
2. 点击 "Add BOM Item"，选择子零件并填写用量
3. 逐层添加，直到产品结构建完整
4. 点右上角下载图标，把 BOM 导出成 CSV

💡 技巧：BOM 支持多层展开，之后创建生产订单时子零件会自动带入，一键发料。

库存调拨

仓库换仓库、货架换货架，每次移动都有记录，月底审计不再拍脑袋。

1. 在库存项详情页点击 "Transfer"（调拨）操作
2. 搜索并选择目标库存位
3. 填写调拨数量，默认全部移走
4. 确认提交，系统自动写入一条调拨历史

💡 技巧：只是数量对不上时用 "Adjust" 而不是调拨；"Stocktake" 盘点模式可以批量校正差异。

按需打开的进阶能力

• REST API：所有库存数据都能通过/api/接口读写，方便和 ERP 对账同步（src/backend/InvenTree/part/api.py）
• 插件系统：标签打印、报表导出、消息通知都有现成内置插件（src/backend/InvenTree/plugin/builtin/）
• 报表模板：用 HTML 定义标签和报告，服务端渲染成 PDF（src/backend/InvenTree/report/）
• SSO / SCIM：企业统一登录、批量同步用户，管理端直接配（src/backend/InvenTree/scim/）

别急着上线，先踩这几个坑

• 启动报错 "You must provide the 'INVENTREE_DB_USER' variable"→ 其实就改一处：同目录.env文件里补齐INVENTREE_DB_USER、INVENTREE_DB_PASSWORD、INVENTREE_EXT_VOLUME三个变量，EXT_VOLUME 指向一个本地目录 → 重跑docker compose up -d。
• 浏览器打开一直 502 或转圈→ 别急，首次启动要跑数据库迁移，正常需要 3-5 分钟 →docker compose logs -f inventree-server盯着进度，看到服务启动完成再刷新页面。
• 升级版本后接口 404、字段报错→ 新版本表结构还没迁移 → 执行docker compose run --rm inventree-server invoke update，再docker compose up -d重启即可。

继续往下挖

• 官方文档总览
• Docker部署详解
• 条码系统文档
• 插件示例源码

【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTree