Binner元器件库存
说明：以下教程使用官方 Docker 镜像 binnerofficial/binner，适合 Linux 服务器（Ubuntu/Debian）和已经安装 Docker 的环境。Windows 用户也可以使用 Docker Desktop 按同样步骤操作。
步骤一：确认 Docker 环境
docker --version
docker compose version如果两条命令都能正常输出版本号，就可以继续。
步骤二：创建项目目录
mkdir -p /opt/binner
cd /opt/binner步骤三：创建 docker-compose.yml
在 /opt/binner 目录下创建 docker-compose.yml 文件。以下配置基于官方文档和 Unraid 社区模板，使用绑定挂载（bind mounts） 将配置和数据保存在宿主机上，方便备份：
services:
binner:
container_name: binner
image: binnerofficial/binner:latest
restart: unless-stopped
ports:
- "8090:8090"
environment:
- BINNER_USEHTTPS=true
- BINNER_PORT=8090
volumes:
- ./config:/config
- ./data:/data
- ./certificates:/certificates
- ./logs:/logs
- ./userfiles:/userfiles关键配置说明：
| 配置项 | 作用 | 注意事项 |
|---|---|---|
BINNER_USEHTTPS | 启用 HTTPS | 默认为 true，容器会生成自签名证书 |
BINNER_PORT | 服务端口 | 默认 8090 |
./config | 配置目录 | 存放 appsettings.json 等 |
./data | 数据目录 | 存放库存数据 |
./certificates | 证书目录 | 存放 SSL 证书（localhost.pfx / localhost.crt） |
./logs | 日志目录 | 注意：官方说明此目录是符号链接，使用 -L 选项复制时需要留意 |
./userfiles | 用户文件目录 | 上传的 datasheet、图片等 |
关于 HTTPS：Binner 默认使用自签名证书。首次访问时浏览器会显示安全警告，这是正常的。你可以选择信任该证书，或者后续替换为自己的正式证书。官方 Wiki 提供了在 Windows 和 Unix 系统上信任证书的步骤-3。
步骤四：启动容器
docker compose up -d检查容器状态：
docker compose ps
docker compose logs binner步骤五：访问系统
在浏览器中打开：
https://你的服务器IP:8090因为使用的是自签名证书，浏览器会提示“连接不安全”。点击“高级” → “继续前往”即可。
默认登录凭据：
- 用户名：admin
- 密码：admin
登录后立即修改密码。
步骤六：基本配置建议
登录后，建议优先完成以下配置：
修改管理员密码：在用户设置中修改默认的 admin/admin。
申请并配置供应商 API 密钥（可选但强烈推荐）：
- DigiKey：访问 https://developer.digikey.com/ 注册开发者账户，创建 App，获取 ClientId 和 ClientSecret。OAuth 回调地址设置为 https://localhost:8090/Authorization/Authorize。需要启用 Product Information 和 Order Support API 权限-7。
- Mouser：访问 https://www.mouser.com/api-hub/ 注册，需要分别申请 Search API 和 Order API 的密钥-7。
配置好后，在 Binner 的 appsettings.json 中填入对应的 API 密钥即可启用自动零件查询和订单导入功能。
后续维护
查看日志：
docker compose logs -f binner停止服务：
docker compose down重启服务：
docker compose up -d更新到新版本：
cd /opt/binner
docker compose pull
docker compose up -d备份数据：备份整个 /opt/binner 目录即可。核心数据在 ./data 和 ./config 中，./certificates 目录保存了 SSL 证书，./userfiles 保存了上传的附件。
常见问题
问题：浏览器提示证书不安全？
这是自签名证书的正常现象。你可以选择在浏览器中手动信任，或者按照官方 Wiki 的步骤将 certificates/localhost.crt 安装到系统的受信任根证书中。Windows 上右键 .pfx 文件选择“安装 PFX”，密码默认是 password。
问题：想用 HTTP 而不是 HTTPS？
将 docker-compose.yml 中的 BINNER_USEHTTPS 设为 false。但注意，某些功能（如 DigiKey OAuth 回调）可能要求 HTTPS。
问题：想切换到 PostgreSQL/MySQL？
修改 ./config/appsettings.json 中的 StorageProviderConfiguration 部分，将 Provider 改为 Postgresql 或 MySql，并填入连接字符串。具体配置示例可参考官方 README。默认的 Binner 文件数据库对个人使用完全够用，不需要切换。
问题：条形码扫描怎么用？
Binner 支持通过 USB 条形码扫描器输入。如果没有专用扫描器，可以用手机上的“条形码键盘”类 App，扫描后直接输入到浏览器中的 Binner 页面。
问题：Mouser 订单导入报错？
GitHub 上有用户报告过 Mouser 订单导入抛出 JSON 解析异常的问题（v2.6.23）。如果遇到类似情况，建议在 GitHub Issues 中搜索是否有已报告的同类问题，或尝试使用 DigiKey 的订单导入功能（相对更稳定）。