dumbwareio/dumbbudget Docker Image Overview

dumbwareio/dumbbudget

一个简单、安全的个人预算应用，带有PIN保护功能，可通过简洁现代的界面跟踪收入和支出，支持多币种、交易分类、CSV导出、实时余额计算等功能。

2 收藏0 次下载

🚀 稳定镜像源 = 更少宕机 + 更低运维成本

中文简介版本下载

🚀 稳定镜像源 = 更少宕机 + 更低运维成本

DumbBudget

一个简单、安全的个人预算应用，带有PIN保护功能。通过简洁现代的界面跟踪收入和支出。

!image

核心功能

🔒 PIN保护访问
💰 跟踪收入和支出
📊 实时余额计算
🏷️ 交易分类
📅 日期范围筛选
🔄 按日期或金额排序
📱 响应式设计
🌓 明暗主题切换
📤 导出为CSV格式
🔍 按交易类型筛选
💱 多币种支持
🌐 PWA支持

支持的货币

DumbBudget支持以下货币：

USD (***) 🇺🇸
EUR (欧元) 🇪🇺
GBP (英镑) 🇬🇧
JPY (日元) 🇯🇵
AUD (澳大利亚元) 🇦🇺
CAD (加拿大元) 🇨🇦
CHF (瑞士法郎) 🇨🇭
CNY (***) 🇨🇳
HKD (港元) 🇭🇰
NZD (新西兰元) 🇳🇿
MXN (墨西哥比索) 🇲🇽
RUB (俄罗斯卢布) 🇷🇺
SGD (新加坡元) 🇸🇬
KRW (韩元) 🇰🇷
INR (印度卢比) 🇮🇳
BRL (巴西雷亚尔) 🇧🇷
ZAR (南非兰特) 🇿🇦
TRY (土耳其里拉) 🇹🇷
PLN (波兰兹罗提) 🇵🇱
SEK (瑞典克朗) 🇸🇪
NOK (挪威克朗) 🇳🇴
DKK (丹麦克朗) 🇩🇰
IDR (印度尼西亚卢比) 🇮🇩

可通过CURRENCY环境变量设置首选货币（未设置时默认使用USD）。

使用Docker

bash
docker run -d \
  -p 3000:3000 \
  -v /path/to/your/data:/app/data \
  -e DUMBBUDGET_PIN=*** \
  -e CURRENCY=USD \
  -e BASE_URL=http://localhost:3000 \
  -e SITE_TITLE='我的账户' \
  dumbwareio/dumbbudget:latest

yaml
services:
  dumbbudget:
    image: dumbwareio/dumbbudget:latest
    container_name: dumbbudget
    restart: unless-stopped
    ports:
      - ${DUMBBUDGET_PORT:-3000}:3000
    volumes:
      - ${DUMBBUDGET_DATA_PATH:-./data}:/app/data
    environment:
      - DUMBBUDGET_PIN=${DUMBBUDGET_PIN:-} # 访问网站的PIN码
      - BASE_URL=${DUMBBUDGET_BASE_URL:-http://localhost:3000} # 网站访问URL
      - CURRENCY=${DUMBBUDGET_CURRENCY:-USD} # 支持的货币代码：[***]
      - SITE_TITLE=${DUMBBUDGET_SITE_TITLE:-DumbBudget} # 网站显示名称
      - INSTANCE_NAME=${DUMBBUDGET_INSTANCE_NAME:-} # 实例/账户名称
      # （可选）
      # 限制来源 - 例如：[***]
      # - ALLOWED_ORIGINS=${DUMBBUDGET_ALLOWED_ORIGINS:-http://localhost:3000}
    # healthcheck:
    #   test: wget --spider -q  [***]
    #   start_period: 20s
    #   interval: 20s
    #   timeout: 5s
    #   retries: 3

注意：将/path/to/your/data替换为主机上用于存储交易数据的实际路径。

环境变量

变量	描述	是否必填	默认值	示例
`DUMBBUDGET_PIN`	用于访问应用的PIN码	是	-	`***`
`PORT`	服务器端口号	否	`3000`	`8080`
`CURRENCY`	交易使用的货币代码	否	`USD`	`EUR`
`BASE_URL`	应用的基础URL	否	`http://localhost:PORT`	`[***]`
`SITE_TITLE`	允许为每个实例命名（如果有多个实例）	否	-	`我的账户`

开发设置

克隆仓库：

bash
git clone [***]
cd DumbBudget

安装依赖：

bash
npm install

创建.env文件：

env
DUMBBUDGET_PIN=***
PORT=3000
NODE_ENV=development
BASE_URL=http://localhost:3000
CURRENCY=USD
SITE_TITLE='DumbBudget'
INSTANCE_NAME='我的账户'
ALLOWED_ORIGINS=* # 限制来源 - 例如：[***]

启动开发服务器：

bash
npm run dev

在浏览器中打开 http://localhost:3000

从源代码构建

bash
# 构建Docker镜像
docker build -t dumbwareio/dumbbudget:latest .

# 创建持久化数据目录
mkdir -p ~/dumbbudget-data

# 运行容器
docker run -d \
  -p 3000:3000 \
  -v ~/dumbbudget-data:/app/data \
  -e DUMBBUDGET_PIN=*** \
  -e BASE_URL=http://localhost:3000 \
  -e SITE_TITLE='我的账户' \
  dumbwareio/dumbbudget:latest