jsonbored/sure-aio

镜像概述

Sure个人财务应用的一体化Docker镜像，专为Unraid家庭实验室设计，整合Web UI、Sidekiq任务运行器、PostgreSQL数据库和Redis缓存，无需配置多个模板或外部服务，提供"一键安装"的简化部署体验。

核心功能

• Web UI：基于Ruby on Rails的核心财务仪表盘，支持财务数据追踪
• 任务运行器：Sidekiq后台任务处理，保障异步操作效率
• 内置数据库：自动安全配置的PostgreSQL，无需外部数据库服务
• 缓存服务：Redis用于后台队列管理，提升系统响应速度

使用场景

适用于Unraid用户快速部署个人财务工具，无需复杂的服务配置，适合初学者及希望简化部署流程的家庭实验室用户。

配置说明

初学者安装步骤

1. 将仓库添加到Unraid模板库：https://github.com/JSONbored/awesome-unraid
2. 搜索并安装Sure-AIO模板
3. 打开Unraid终端，运行以下命令生成安全密钥：

   bash
   openssl rand -hex 64
   

4. 将生成的密钥粘贴到模板的Secret Key Base字段
5. 点击应用，等待30-60秒初始化完成，通过3000端口访问Web UI

高级用户配置

点击模板中的**"显示更多设置..."**可自定义系统，支持以下高级功能：

• 本地AI/Ollama集成：替换OpenAI进行财务数据分类
• 外部代理路由：绕过内置bot，使用OpenClaw/MCP代理
• 本地向量搜索：通过pgvector实现文档嵌入管理
• S3/Cloudflare R2存储：卸载收据和账单上传至云存储
• 外部数据库：连接专用PostgreSQL服务器，绕过内置数据库
• 企业认证与SMTP：设置SSO（OIDC）和密码恢复邮件

数据持久化

数据存储在Unraid缓存盘，更新容器不会丢失数据：

• 文件上传：/mnt/user/appdata/sure-aio/system
• 数据库：/mnt/user/appdata/sure-aio/postgres
• 缓存数据：/mnt/user/appdata/sure-aio/redis

版本控制与上游同步

• 镜像固定特定上游Sure版本，避免浮动标签的不确定性
• 自动监控上游稳定版本，触发更新PR
• 镜像包含元数据标签，记录上游版本和包装信息

许可证与致谢

• 基础应用代码由we-promise/sure社区维护，采用AGPLv3许可证
• 本Docker镜像包装由JSONbored提供，旨在简化Unraid部署流程

Docker部署示例

bash
docker run -d \
  --name sure-aio \
  -p 3000:3000 \
  -v /path/to/appdata:/mnt/user/appdata/sure-aio \
  -e SECRET_KEY_BASE=your_secure_key \
  docker.xuanyuan.run/jsonbored/sure-aio

（替换/path/to/appdata为本地存储路径，your_secure_key为生成的安全密钥）