Part-DB Docker镜像文档

镜像概述

Part-DB是一款开源的电子元件库存管理系统，基于现代框架开发，是旧版Part-DB（版本<1.0）的完整重写，推荐作为当前使用版本。该系统安装在Web服务器上，可通过任何浏览器访问，无需安装额外软件，适用于管理电子元件库存、跟踪库存变动及协作使用。

核心功能特性

库存管理

• 电子元件全生命周期管理，支持为元件分配类别、封装、制造商、存储位置及价格信息
• 支持标签分组，可关联 datasheet、图片等文件
• 多货币支持及汇率自动更新

用户与权限

• 精细化用户组权限管理，支持双因素认证（Google Authenticator、Webauthn/U2F密钥）
• 可选单点登录（SSO）支持，通过SAML集成（可连接LDAP或Active Directory）
• 密码重置邮件功能

数据处理与集成

• 导入/导出功能，支持KiCad BOM导入
• 与KiCad集成，可直接在KiCad中查看Part-DB库存
• 支持Octopart、Digikey、Farnell等云供应商自动获取元件信息、datasheet及价格

实用工具

• 条形码/标签生成器，内置摄像头扫码功能
• 项目管理功能，创建BOM并计算可制造数量，直接从库存提取元件
• 事件日志跟踪库存变动，支持版本回滚
• 强大的搜索过滤功能，包括参数化搜索

技术特性

• 响应式设计，支持PC、平板及智能手机访问
• 多语言支持（德语、英语、俄语、日语、法语、中文等）
• 支持MySQL、SQLite、PostgreSQL数据库后端
• API接口支持第三方应用/脚本访问
• 自动生成图片缩略图

使用场景

• 电子爱好者：管理个人电子元件库存，跟踪元件位置与数量
• 创客空间：多用户共享库存，控制不同用户的访问权限
• 小型企业/实验室：管理研发用电子元件，跟踪库存消耗
• 教育机构：大学实验室电子元件管理，支持教学项目BOM管理

Docker部署指南

环境要求

• Docker Engine 20.10+
• Docker Compose（可选，推荐用于生产环境）
• 至少1GB RAM，2GB可用磁盘空间

镜像获取

bash
docker pull jbtronics/part-db1

快速启动（Docker Run）

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

参数说明：

• -p 8080:80：将容器80端口映射到宿主机8080端口
• -v part-db-data:/app/data：持久化存储数据（数据库、上传文件等）
• APP_ENV=prod：生产环境模式
• DATABASE_URL：数据库连接URL（默认SQLite，支持MySQL/PostgreSQL）
• INITIAL_ADMIN_PW：设置初始管理员密码（未设置则自动生成并输出到日志）

Docker Compose部署（推荐）

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  part-db:
    image: jbtronics/part-db1
    container_name: part-db
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - part-db-data:/app/data
    environment:
      - APP_ENV=prod
      - DATABASE_URL=mysql://user:password@db:3306/partdb?serverVersion=8.0
      - TRUSTED_PROXIES=172.16.0.0/12,192.168.0.0/16
      - INITIAL_ADMIN_PW=secure_admin_pw
      - DEFAULT_CURRENCY=CNY
    depends_on:
      - db

  db:
    image: mysql:8.0
    container_name: part-db-mysql
    restart: unless-stopped
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root_pw
      - MYSQL_DATABASE=partdb
      - MYSQL_USER=user
      - MYSQL_PASSWORD=password

volumes:
  part-db-data:
  mysql-data:

启动服务：

bash
docker-compose up -d

配置说明

核心环境变量

数据库配置示例

MySQL

DATABASE_URL=mysql://user:password@mysql-host:3306/partdb?serverVersion=8.0

PostgreSQL

DATABASE_URL=pgsql://user:password@postgres-host:5432/partdb?serverVersion=13&charset=utf8

访问与登录

1. 部署完成后，通过 http://<服务器IP>:8080 访问
2. 初始登录：
   • 用户名：admin
   • 密码：INITIAL_ADMIN_PW 设置的值（或容器日志中自动生成的密码）
3. 演示账户（公共测试实例）：
   • 地址：[***]
   • 用户名：user，密码：user

升级方法

1. 拉取最新镜像：

   bash
   docker pull jbtronics/part-db1
   

2. 重启容器：

   bash
   docker-compose down && docker-compose up -d
   

   注意：升级前建议备份数据卷

相关资源

• 文档：[]
• Docker镜像：[***]
• GitHub仓库：[***]
• 演示实例：[***]

许可证

Part-DB采用GNU Affero General Public License v3.0许可证，允许商业使用，但修改后的源代码需以相同许可证开源。