InvenTree 库存系统(部署于 maizihehuo,迁移承接实例)

开源库存管理系统 InvenTree 的 Docker 部署:部件/库存/供应商管理,自 kaku2025 迁入的新实例(kucun.bianquezhiyin.cn 流量切换中)。

访问方式

• 域名入口:https://kucun.bianquezhiyin.cn/(nginx 混合反代;InvenTree 直连端口 0.0.0.0:8000)
• 容器 API:docker exec inventree-server invoke --help
• 管理后台:InvenTree 自带 admin,管理员账号 yunmai(密码在 .env INVENTREE_ADMIN_*,不抄录)
• 本机目录:cd /www/docker-data/inventree && docker compose ps

技术架构

• Compose:/www/docker-data/inventree/docker-compose.yml
• 容器:inventree-server(stable, 8000)、inventree-worker、inventree-db(postgres:16, 库 inventree)、inventree-redis
• 数据挂载:./data → /home/inventree/data(媒体文件)
• 品牌/术语定制脚本:apply_brand_patch.sh、apply_term_patch.sh;域名切换脚本 switch_to_domain.sh / switch_to_ip.sh

数据

• PostgreSQL 库 inventree(容器内,无外部端口)
• 媒体/附件:/www/docker-data/inventree/data
• kaku2025 侧备份(源):每日 3:00 backup.sh → backup/db_*.dump + /opt/backups/inventree-*.sql.gz;另有全量 inventree_dump.sql.gz 在目录内
• 本机(maizihehuo)备份:依赖宝塔/脚本情况待确认 —— 迁移切换前必须补本机备份

使用方法

• Web 界面直接操作:部件、库存、供应商、订单
• 数据导入:配套脚本 /opt/inventree-scripts/(build_bom.py、build_parts.py、sale_deduction.py、mock_stock.py)—— 注意这些脚本在 kaku2025 的 /opt,迁移时需一并带走
• 命令行管理:docker exec inventree-server invoke <命令>

维护方式

• 启停:cd /www/docker-data/inventree && docker compose up -d / stop
• 日志:docker compose logs -f server
• 数据库:docker exec inventree-db psql -U inventree -d inventree -c "\dt"
• 备份:沿用 backup.sh(拷贝自 kaku2025),确认 cron 已在本机注册

现状与风险

• 4 容器 Up 10 天(kaku2025 原实例 Up 6 周,双跑中)
• DNS kucun.bianquezhiyin.cn 当前仍指向 103.205.253.150(kaku2025)——切换前须核对解析与两实例数据一致性
• 本机实例的每日备份 cron 未见明确证据

优化建议

1. 【备份】立即在本机建立每日备份:echo "0 3 * * * cd /www/docker-data/inventree && ./backup.sh >> /var/log/inventree-backup.log 2>&1" >> /var/spool/cron/crontabs/root(或用宝塔计划任务),并演练一次恢复
2. 【迁移】切换步骤:比对两库记录数 → DNS 改指 maizihehuo → 观察 1 周 → 停 kaku2025 实例 → 保留其最终 dump
3. 【安全】8000 端口目前 0.0.0.0:改 compose 为 127.0.0.1:8000:8000 后 docker compose up -d,只留 nginx 入口
4. 【可维护性】把 kaku2025 的 /opt/inventree-scripts 同步到本机 /opt 并写入文档
5. 【安全】.env 权限 600;InvenTree 管理账号启用强密码+2FA(如支持)