InvenTree 开源库存管理系统：本地快速部署与实用指南

InvenTree 开源库存管理系统本地快速部署与实用指南【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTreeInvenTree 是一款开源库存管理系统面向管理电子元件、机械零件等物品库存的个人与小团队。它把分散在表格和脑子里的零件数据、库存数量和采购记录收进一个可自建的服务器提供 Web 界面、移动应用和 REST API 三种访问方式。 项目速览InvenTree 的核心是一个 Python/Django 后端加 REST API前端为 React 应用另配插件系统和手机 App整体以 MIT 协议开源。项目说明它是什么开源库存管理系统零件、库存、采购、生产订单一体给谁用个人爱好者、小型制造团队、学校实验室怎么跑推荐 Docker Compose 一键部署也可裸机 Python 安装数据存在哪PostgreSQL、MySQL、SQLite 任选上传文件存本地目录 快速上手Docker Compose 最短路径前提是本机已装好 Docker 和 Compose。克隆仓库后配置文件中已经备好contrib/container/目录git clone https://gitcode.com/GitHub_Trending/in/InvenTree cd InvenTree/contrib/container # 编辑 .env至少指定 INVENTREE_EXT_VOLUME 数据目录和数据库账号密码 docker compose run --rm inventree-server invoke update docker compose run inventree-server invoke superuser docker compose up -d第 4 行创建数据库并执行迁移第 5 行按提示创建管理员账号第 6 行启动数据库、Web 服务、后台任务、反向代理、缓存共五个容器。启动后的第一步浏览器打开http://inventree.localhost登录。注意这个地址只在宿主机本地有效局域网其他设备要访问需把.env里的INVENTREE_SITE_URL改为主机可达的地址再重启。Web 服务内部默认监听 8000 端口INVENTREE_WEB_PORT可调对外由代理容器经 80/443 暴露。 核心功能走读先把零件库理出结构场景元件装在几十袋里找货靠记忆重复采购时有发生。能力零件可以放进不限层级的分类树每个零件还能挂自定义参数型号、封装、单价列表支持按参数筛选和排序。上手方式先建两三级分类再录入零件找货时优先用参数过滤而不是翻页翻找。参数与筛选的用法见 docs/docs/concepts/parameters.md。零件模型定义在 src/backend/InvenTree/part/models.py想改字段行为可以从这里查起。库存进出与位置管理场景零件不断买入、消耗你需要随时知道还剩多少、放在哪。能力库存项存放在层级化的位置树里仓库→货架→格位支持按批次或按序列号跟踪序列号可对单个物品记录测试结果每次移动、调整都会留下完整历史记录。上手方式先建顶层位置再接收入库关键器件开序列号易耗品按数量和批次管即可。库存相关 API 与模型见 src/backend/InvenTree/stock/api.py。扫个码就能定位物品场景手拿着一个元件想立刻确认它是什么、还剩多少。能力零件、库存项、位置、采购单等对象都有系统自动生成的内部条码也可以绑定供应商的外部条码。Web 端支持摄像头、扫码枪、键盘输入三种方式手机 App 直接用摄像头扫。上手方式开启扫码后点页面右上角条码图标输入编号即自动跳转到对应物品需要连续操作时进入扫描条码页面一次扫多个再统一执行入库、分配等动作。用 BOM 和生产订单管好消耗场景组装产品前要确认缺哪些子件。能力BOM 支持多种格式导入生产订单可自动或手动从库存分配物料领用后库存自动扣减。用法见 docs/docs/manufacturing/bom.md。 进阶能力API 集成与插件整个系统建在 RESTful API 之上自带文档访问http://127.0.0.1:8000/api-doc/即可在线查阅所有端点。认证推荐用 token用账号密码请求一次即可换取Python 最小调用示例import requests r requests.get(http://localhost:8000/api/user/me/token/, auth(admin, password)) token r.json()[token] # 拉取零件列表 requests.get(http://localhost:8000/api/part/, headers{Authorization: fToken {token}})插件系统用来补足核心功能之外的需求内置插件涵盖条码解析Digi-Key、LCSC 等、标签打印、货币换算、邮件通知等示例代码在 src/backend/InvenTree/plugin/builtin/插件基类在 src/backend/InvenTree/plugin/base/。权限侧支持按组分配角色配置入口见 docs/docs/settings/permissions.md。 避坑与自诊现象宿主机能打开页面局域网其他设备打不开。原因INVENTREE_SITE_URL默认是本地域名 inventree.localhost。解决改成局域网 IP 或域名并重启容器。现象重建容器后数据全部丢失。原因INVENTREE_EXT_VOLUME没指向宿主机目录数据留在了容器内部。解决确认该变量指向本地真实目录并定期用invoke export-records导出备份。现象启动完成却登录不了提示需要管理员账号。原因跳过或没跑成功 superuser 步骤。解决重新执行docker compose run inventree-server invoke superuser按提示建账号。现象页面图片、上传的附件加载不出来。原因静态文件和媒体文件目录没有正确暴露给代理。解决对照 docs/docs/start/processes.md 检查代理配置和数据卷挂载。 收尾拿到手之后先做什么个人爱好者先录入 20 个常用元件、建两三级分类别追求分类完美。第一个动作装好手机 App 并扫码确认其中一个零件。小团队先跑通采购链路——建供应商、下采购订单、收货入库。第一个动作创建两家供应商和一张 PO完整走一遍状态流转。教师与实验室先搞懂权限和分组给学生只读账号避免误操作。第一个动作建一个学生组并分配查看权限。资源入口官方文档docs/安装指南docs/docs/start/API 文档docs/docs/api/后端源码src/backend/前端源码src/frontend/Docker 部署文件contrib/container/【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考