Dumbassets Docker 镜像
dumbwareio查看 Docker Hub 原文页
极其简单的资产追踪器
4 次收藏下载次数: 0状态:社区镜像维护者:dumbwareio仓库类型:镜像最近更新:
DumbAssets
一个极其简单的资产跟踪器,用于记录您的实物资产、其组件以及适用的保修和日常维护信息。
演示
目录
- 镜像概述
- 核心功能和特性
- 使用场景和适用范围
- 使用方法
- 配置说明
- 安全性
- 技术细节
- 贡献指南
- 许可证
镜像概述
DumbAssets 是一个简单易用的实物资产管理工具,专为需要跟踪资产信息、组件、保修和维护记录的个人和小型组织设计。该工具以"简单至上"为理念,提供直观的用户界面和基本但全面的资产跟踪功能,无需复杂的设置或专业知识。
主要用途:
- 记录和管理实物资产信息
- 跟踪资产组件和子组件的层级关系
- 管理保修期限和维护记录
- 存储资产相关照片和收据文档
- 接收保修到期和维护提醒通知
核心功能和特性
- 🚀 跟踪资产详细信息(型号、序列号、保修等)
- 🧩 添加组件和子组件
- 🖼️ 上传和存储照片及收据
- 🔍 按名称、型号、序列号或描述搜索
- 🏷️ 组件的层级组织
- 📅 保修到期通知(可配置)
- 🔧 维护事件通知
- 🏷️ 灵活的标签系统,便于更好地组织
- 🔔 内置 Apprise 通知集成
- 🌗 明暗模式切换,主题持久化
- 🛡️ PIN 认证,带暴力破解保护
- 📦 Docker 支持,便于部署
- 🔗 直接资产链接:通知中包含指向特定资产的链接
使用场景和适用范围
DumbAssets 适用于以下场景:
- 个人用户:跟踪个人电子设备、家电和贵重物品的保修信息
- 小型企业:管理办公设备、工具和固定资产
- 技术爱好者:记录个人项目中的组件和零件信息
- 家庭用户:管理家庭财产,便于保险索赔或财产清点
- 维修人员:跟踪维修物品的保修状态和维护历史
特别适合那些需要简单解决方案而不是复杂企业级资产管理系统的用户。
使用方法
前提条件
- Docker(推荐)
- Node.js >=14.0.0(用于本地开发)
选项 1:Docker 快速启动
shdocker run -p 3000:3000 -v ./data:/app/data docker.xuanyuan.run/dumbwareio/dumbassets:latest
- 访问 http://localhost:3000
- 添加资产,上传照片/收据,跟踪保修
- 体验这个简单易用的工具
选项 2:Docker Compose 自定义部署
创建 docker-compose.yml 文件:
yamlservices: dumbassets: container_name: dumbassets image: docker.xuanyuan.run/dumbwareio/dumbassets:latest restart: unless-stopped ports: - ${DUMBASSETS_PORT:-3000}:3000 volumes: - ${DUMBASSETS_DATA_PATH:-./data}:/app/data environment: NODE_ENV: ${DUMBASSETS_NODE_ENV:-production} DEBUG: ${DUMBASSETS_DEBUG:-true} SITE_TITLE: ${DUMBASSETS_SITE_TITLE:-DumbAssets} BASE_URL: ${DUMBASSETS_BASE_URL:-http://localhost:3000} DUMBASSETS_PIN: ${DUMBASSETS_PIN:-1234} ALLOWED_ORIGINS: ${DUMBASSETS_ALLOWED_ORIGINS:-*} APPRISE_URL: ${DUMBASSETS_APPRISE_URL:-} # ...其他环境变量
然后运行:
shdocker compose up -d
- 访问 http://localhost:3000
- 添加和管理您的资产
选项 3:本地运行(开发者)
shgit clone https://github.com/yourusername/DumbAssets.git cd DumbAssets npm install npm start
在浏览器中打开 http://localhost:3000
配置说明
环境变量
| 变量名 | 描述 | 默认值 | 是否必需 |
|---|---|---|---|
| PORT | 服务器端口 | 3000 | 否 |
| DUMBASSETS_PIN | PIN 保护(4位以上数字) | 无 | 否 |
| APPRISE_URL | 通知用的 Apprise URL | 无 | 否 |
| TZ | 容器时区 | America/Chicago | 否 |
| BASE_URL | 应用程序基础 URL | http://localhost | 否 |
| SITE_TITLE | 网站标题(显示在浏览器标签和页眉) | DumbAssets | 否 |
| ALLOWED_ORIGINS | 允许访问实例的来源 | '*' | 否 |
| DEMO_MODE | 启用只读模式 | false | 否 |
[!提示] DumbAssets 内置了 Apprise 集成,您只需添加 /ntfy/ 等链接,无需单独运行 Apprise 服务!
数据存储
所有数据以 JSON 文件形式存储在 /data 目录中:
/data/Assets.json- 所有资产数据/data/SubAssets.json- 所有组件数据/data/Images- 上传的照片/data/Receipts- 上传的收据/data/config.json- 通知和应用配置
建议通过 Docker 卷挂载此目录,以确保数据持久化。
安全性
- 可变长度 PIN 支持(4位以上)
- 恒定时间 PIN 比较
- 暴力破解保护(多次尝试后锁定)
- 安全会话 cookie
- 不在客户端存储 PIN
- 请求频率限制
技术细节
技术栈
- 后端:Node.js (>=14.0.0) 与 Express
- 前端:原生 JavaScript (ES6+)
- 容器:基于 Alpine 的 Docker
- 通知:Apprise 集成(通过 Python)
- 上传:Multer 文件处理
- 调度:node-cron 用于保修和维护通知
依赖项
- express: Node.js Web 框架
- multer: 文件上传处理和 multipart/form-data 解析
- apprise: 通知系统集成
- cors: 跨域资源共享中间件
- dotenv: 环境变量配置管理
- express-rate-limit: API 保护的频率限制中间件
- express-session: 会话管理和认证
- cookie-parser: Cookie 解析中间件
- node-cron: 任务调度,用于通知
- uuid: 资产唯一 ID 生成
- sharp: 图像处理和优化
- compression: 响应压缩中间件
- helmet: 安全头中间件
- fs-extra: 增强的文件系统操作
- path: 路径操作工具
贡献指南
- Fork 仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 使用 https://www.conventionalcommits.org/ 提交更改
- 推送到分支 (
git push origin feature/amazing-feature) - 打开 Pull Request
有关本地设置和指南,请参见开发指南。
许可证
由 DumbWare.io 制作 ❤️
dumbwareio 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 dumbassets 镜像标签
docker pull docker.xuanyuan.run/dumbwareio/dumbassets:<标签>
DockerHub 原生拉取命令
docker pull dumbwareio/dumbassets:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务