部署sure私人记账服务,可以下载官方docker compose配置、设置自己的应用密钥与数据库密码,再启动容器并创建首个管理员账号;需要ai查询时,再单独配置模型接口。下面针对新实例和普通收支记账,需要已运行的docker engine与compose,先限制为本机访问,不涉及投资交易或资产配置建议。
为新实例下载配置文件
mkdir -p sure-local cd sure-local curl --fail --location --silent --show-error --output compose.yml https://raw.githubusercontent.com/we-promise/sure/main/compose.example.yml curl --fail --location --silent --show-error --output .env https://raw.githubusercontent.com/we-promise/sure/main/.env.example
只在新建空目录执行。已有实例保留当前compose.yml、.env和数据卷,不用这段下载操作覆盖原配置。当前示例以stable为默认镜像通道;要固定版本时,按项目已发布的实际标签设置SURE_IMAGE_TAG。

Sure项目说明与社区维护背景
设置密钥、密码和本机监听地址
openssl rand -hex 64
把生成值填入.env的SECRET_KEY_BASE,并给POSTGRES_PASSWORD设置独立强密码。不要沿用示例占位符;两项配置均保存在本机配置文件中,不提交到公开代码仓库。已有实例升级必须保留原SECRET_KEY_BASE,否则可能影响已保存数据的读取。
SECRET_KEY_BASE=填入本次生成的随机值 POSTGRES_PASSWORD=填入独立数据库密码
打开compose.yml,把web服务的端口映射限定为下面一行,其余服务关系和数据卷保持原样。本机HTTP访问沿用本地配置;以后需要外网访问时,再单独配置HTTPS与反向代理。
ports:
- "127.0.0.1:${PORT:-3000}:3000"
启动容器,创建自己的管理员
docker compose up -d docker compose ps docker compose logs --tail 80 web worker
确认web、worker及数据库等服务启动,查看日志是否有迁移、数据库认证或密钥缺失错误。打开http://localhost:3000,首次注册自己的账号。新实例的首个注册用户会获得super_admin角色,因此先完成本人注册,再考虑允许其他人加入。

现金流示例:工资收入与日常支出分类
在Settings → Self-Hosting → Onboarding中,按需要将后续注册改为Closed或Invite-only。先用演示收支验证录入、分类和现金流展示,确认数据确实保存,再迁入正式账目。
需要AI助手时再加入模型配置
普通记账先运行正常,再在.env按官方支持的接口填写OPENAI_ACCESS_TOKEN和实际可用的OPENAI_MODEL;只有自定义兼容服务时才按其文档填写OPENAI_URI_BASE。该配置使用独立API权限与计费,不等同于聊天产品订阅。
docker compose up -d --force-recreate web worker

账本助手的对话与查询示意
重建相关服务加载环境配置后,先让助手查询演示账本,例如“列出本月餐饮支出并计算合计”,再与交易明细手工对照。使用外部模型服务会产生相应的数据处理和费用,是否启用由自己的账目范围与服务设置决定。
确认数据卷与备份,再考虑更新
保留数据卷、.env和密钥记录,按项目备份指南验证备份可恢复后再更新镜像。运行docker compose down -v会删除卷,不适合作为排查登录或重启问题的常规命令。启动失败先读具体日志,区分端口冲突、密码错误、镜像下载和迁移问题,避免反复重建实例丢失账目。











