Part-DB-server
专为电子元件设计的开源库存管理系统，Web 界面，支持条形码、权限控制、KiCad 集成等。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
电子工程师的元件管家，Web 自托管，支持扫码与 KiCad 联动。
核心功能
- 支持分类、封装、厂商、存储位置等多维度管理元件信息
- 内置条形码/标签生成与摄像头扫码，快速盘点
- 细粒度用户权限 + 双因素认证 + SAML 单点登录
- 与 KiCad 深度集成，可实时查看库存并导入 BOM
- 自动从 Octopart、Digikey 等云服务获取元件参数和价格
避坑指南
- •生产环境务必启用 HTTPS，避免密码明文传输；2. 默认 SQLite 适合小规模使用，多用户并发建议改用 MySQL/MariaDB；3. 升级前一定备份数据库，避免数据丢失；4. 首次安装后立即修改 admin 密码；5. 如果使用 Docker，持久化存储 volume 避免容器重启数据丢失。
适用场景
- 个人电子爱好者整理元件柜，扫码出入库
- 创客空间或实验室多用户共享元件库，权限分级管理
- 小批量生产公司管理物料，与 KiCad 设计流程无缝对接
- 大学实验室公用元件库，记录借还和损耗
详细介绍
Part-DB 是一款专门为电子元件设计的开源库存管理系统。它通过 Web 界面运行，无需安装客户端，支持对元件按类别、封装、制造商、存储位置等进行精细化管理。核心功能包括：条形码/标签生成与摄像头扫码、细粒度用户权限与双因素认证、通过 SAML（如 Keycloak）实现单点登录、支持 KiCad BOM 导入/导出、项目管理（物料清单跟踪）、操作日志与版本回滚、富文本描述、参数化搜索、自动生成缩略图，以及集成 Octopart、Digikey 等云服务自动获取元件信息和价格。支持 MySQL、SQLite、PostgreSQL 数据库，并提供 REST API 供外部程序调用。本版本基于 PHP/Symfony 7 重构，性能与可维护性更佳，是官方推荐版本。
常见问题与排障 (2)
故障排除如何修复在Part-DB 2.9.1中保存用户编辑时出现的'403 Forbidden'错误？
错误是由于 config/permissions.yaml 中缺少用户的 'edit' 操作引起的。在 users: operations: 下添加：edit: label: "perm.edit", alsoSet: ['read', 'edit_username', 'edit_infos'], apiTokenRole: ROLE_API_ADMIN。然后更新受影响的用户/组的 permissions_data JSON，在 users 部分设置 "edit": true。重启 Part-DB。
故障排除升级后如何修复Part-DB错误500和“Provider with key digikey already registered”？
此错误出现在Part-DB v1.16+版本中，原因是在查看部件时存在重复的Digikey提供商注册。临时解决方法是从源代码中移除重复的注册：找到定义Digikey提供商的文件（通常在src/Providers/或config/services中），定位重复的'digikey'键条目，删除或注释掉其中一个。然后通过运行php bin/console cache:clear清除缓存（若使用Docker，需进入容器后执行此命令）。或者，在官方修复程序发布前降级至1.15版本。关注GitHub issue #919以获取永久解决方案。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
方案一（推荐）：使用 Docker 一步部署 - docker run -d -p 8080:80 jbtronics/part-db1
方案二（手动）：克隆仓库到 Web 服务器，配置 PHP 8.2+、数据库、Yarn 编译前端
浏览器访问 http://你服务器IP:端口，用默认 admin 账号登录，按向导初始化数据库
- 方案一（推荐）：使用 Docker 一步部署 - docker run -d -p 8080:80 jbtronics/part-db1
- 方案二（手动）：克隆仓库到 Web 服务器，配置 PHP 8.2+、数据库、Yarn 编译前端
- 浏览器访问 http://你服务器IP:端口，用默认 admin 账号登录，按向导初始化数据库
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
若使用 Docker，执行 docker stop 容器名 && docker rm 容器名；若手动安装，删除项目文件夹及数据库表，移除 Web 服务器配置即可。注意备份数据。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs