dumbwareio/dumbbudget

DumbBudget

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

核心功能

• 🔒 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=12345 \
  -e CURRENCY=USD \
  -e BASE_URL=http://localhost:3000 \
  -e SITE_TITLE='我的账户' \
  docker.xuanyuan.run/dumbwareio/dumbbudget:latest

yaml
services:
  dumbbudget:
    image: docker.xuanyuan.run/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} # 支持的货币代码：https://github.com/DumbWareio/DumbBudget?tab=readme-ov-file#supported-currencies
      - SITE_TITLE=${DUMBBUDGET_SITE_TITLE:-DumbBudget} # 网站显示名称
      - INSTANCE_NAME=${DUMBBUDGET_INSTANCE_NAME:-} # 实例/账户名称
      # （可选）
      # 限制来源 - 例如：https://subdomain.domain.tld,https://auth.proxy.tld,http://internalip:port'（默认是'*'）
      # - ALLOWED_ORIGINS=${DUMBBUDGET_ALLOWED_ORIGINS:-http://localhost:3000}
    # healthcheck:
    #   test: wget --spider -q  http://127.0.0.1:3000
    #   start_period: 20s
    #   interval: 20s
    #   timeout: 5s
    #   retries: 3

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

环境变量

开发设置

1. 克隆仓库：

bash
git clone https://github.com/DumbWareio/DumbBudget.git
cd DumbBudget

2. 安装依赖：

bash
npm install

3. 创建.env文件：

env
DUMBBUDGET_PIN=12345
PORT=3000
NODE_ENV=development
BASE_URL=http://localhost:3000
CURRENCY=USD
SITE_TITLE='DumbBudget'
INSTANCE_NAME='我的账户'
ALLOWED_ORIGINS=* # 限制来源 - 例如：https://subdomain.domain.tld,https://auth.proxy.tld,http://internalip:port'（默认是'*'）

4. 启动开发服务器：

bash
npm run dev

5. 在浏览器中打开 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=12345 \
  -e BASE_URL=http://localhost:3000 \
  -e SITE_TITLE='我的账户' \
  docker.xuanyuan.run/dumbwareio/dumbbudget:latest

贡献

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

安全性

DumbBudget包含多项安全功能：

• 访问PIN保护
• PIN尝试次数限流
• 多次失败尝试后临时锁定
• 不在浏览器存储中保存敏感数据
• 安全会话处理

支持

• 通过提交issue报告错误
• 通过issue请求功能
• 加入社区讨论

支持项目

---

由 https://github.com/DumbWareio 用心打造 ❤️