partdborg/part-db

Part-DB

镜像概述和主要用途

Part-DB是一款开源的电子元件库存管理系统，基于现代框架重写，替代了旧版（<1.0）Part-DB。它部署在Web服务器上，可通过任何浏览器访问，无需安装客户端软件。主要用于管理电子元件的库存信息，包括分类、封装、制造商、存储位置、价格等，并支持多用户协作、项目管理和库存追踪。

核心功能和特性

• 全面的库存管理：电子元件可分配至类别、封装、制造商，支持多个存储位置和价格信息，可通过标签分组，关联 datasheet 或图片等文件。
• 多语言支持：目前支持德语、英语、俄语、日语、法语、捷克语、丹麦语和中文。
• 条形码/标签功能：生成元件和存储位置的条形码/标签，支持通过 webcam 扫描条形码。
• 用户权限系统：支持用户组和细粒度权限，支持双因素认证（Google Authenticator 和 Webauthn/U2F 密钥），可强制用户组启用，支持邮件密码重置。
• 单点登录（SSO）：可选支持 SAML 协议（通过 Keycloak 等中间服务可连接 LDAP 或 Active Directory）。
• 数据导入/导出：支持元件和数据结构的导入/导出，支持从 KiCad 导入 BOM。
• 项目管理：创建项目并分配元件至物料清单（BOM），显示项目可构建次数，直接从库存提取所需元件。
• 事件日志：跟踪库存变更，记录用户操作，支持将元件恢复至历史版本。
• 响应式设计：适配 PC、平板和智能手机，统一界面体验。
• 多数据库支持：兼容 MySQL（≥5.7）、MariaDB（≥10.4）、PostgreSQL（≥10）和 SQLite。
• 富文本支持：元件描述和评论支持富文本格式。
• 多货币与汇率：支持多种货币，自动更新汇率。
• 高级搜索：强大的搜索和筛选功能，包括参数化搜索（按规格搜索元件）。
• 媒体处理：自动生成图片缩略图。
• 云供应商集成：支持通过 Octopart、Digikey、Farnell、LCSC 或 TME 等云供应商自动获取元件信息、datasheet 和价格。
• API 接口：支持从其他应用/脚本访问 Part-DB。
• KiCad 集成：作为 KiCad 的中央数据源，在 KiCad 中直接查看 Part-DB 中的可用元件。

使用场景和适用范围

• 电子爱好者：管理个人电子元件库存，追踪元件位置和数量。
• 创客空间：多用户共享库存，控制不同用户的访问权限。
• 小型公司：管理电子元件库存，跟踪采购和使用情况。
• 大学/研究机构：实验室电子元件的集中管理，支持师生协作访问。

使用方法和配置说明

Docker 部署

基本信息

• Docker 镜像：jbtronics/part-db1
• 支持架构：Linux/amd64、Linux/arm64（可能）

快速启动（SQLite）

适合测试或小型部署，数据存储在容器内（重启后数据可能丢失，建议挂载卷）：

bash
docker run -d -p 8080:80 --name part-db jbtronics/part-db1

访问 http://localhost:8080，初始管理员账户密码在容器日志中（搜索 Initial admin password）。

持久化部署（推荐）

挂载数据卷保存配置和数据库，使用环境变量自定义配置：

bash
docker run -d \
  -p 8080:80 \
  --name part-db \
  -v part-db_data:/app/var \
  -v part-db_uploads:/app/public/uploads \
  -e APP_ENV=prod \
  -e DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db" \
  -e INITIAL_ADMIN_PW="your_secure_password" \
  jbtronics/part-db1

Docker Compose（MySQL 后端）

适合生产环境，使用 MySQL 数据库提高性能：

yaml
version: '3.8'

services:
  part-db:
    image: jbtronics/part-db1
    ports:
      - "8080:80"
    environment:
      - APP_ENV=prod
      - DATABASE_URL="mysql://partdb_user:partdb_pass@db:3306/partdb?serverVersion=8.0"
      - INITIAL_ADMIN_PW="your_admin_password"
      - TRUSTED_PROXIES="172.18.0.0/16"  # 信任 Docker 网络中的代理
    volumes:
      - part-db_uploads:/app/public/uploads
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=partdb
      - MYSQL_USER=partdb_user
      - MYSQL_PASSWORD=partdb_pass
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  part-db_uploads:
  mysql_data:

启动命令：docker-compose up -d

环境变量配置

反向代理配置

若使用反向代理（如 Nginx），需确保代理正确传递 X-Forwarded-* 头，并设置 TRUSTED_PROXIES 环境变量：

nginx
server {
    listen 443 ssl;
    server_name part-db.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://part-db:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

容器启动时添加环境变量：-e TRUSTED_PROXIES="172.18.0.0/16"（替换为代理服务器 IP/CIDR）。

升级方法

1. 拉取最新镜像：docker pull jbtronics/part-db1
2. 停止并删除旧容器：docker stop part-db && docker rm part-db
3. 用原命令重启容器（确保挂载卷不变）：docker run ...（使用之前的 docker run 命令或 docker-compose up -d）

参考链接

• 官方文档
• 在线演示（用户名：user，密码：user）
• https://github.com/Part-DB/Part-DB-server
• https://hub.docker.com/r/jbtronics/part-db1