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 重构,性能与可维护性更佳,是官方推荐版本。
トラブルシューティング & FAQ (2)
トラブル対応Part-DB 2.9.1でユーザー編集を保存する際に「403 Forbidden」エラーが発生する場合の修正方法は?
このエラーは、config/permissions.yaml内のusersに対する'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'キーのエントリを見つけて、そのうちの1つを削除するかコメントアウトします。その後、php bin/console cache:clearを実行してキャッシュをクリアします(Dockerの場合は、コンテナ内でexecして実行します)。あるいは、公式修正がリリースされるまでバージョン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