Skip to content
cimornPublic

About

文件与文件夹备份记录,支持批量登记、历史查询和隐私目录。Self-hosted backup tracker for Docker and Windows.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

DataBack

简体中文 | English

记录文件和文件夹的备份时间、位置与说明,支持批量登记、历史查询和隐私目录。

Docker 部署

支持 Linux 服务器、电脑和 NAS,镜像提供 amd64、arm64 两种架构。

git clone https://github.com/cimorn/DataBack.git
cd DataBack
cp .env.example .env

修改 .env 中的登录密码、隐私密码和会话密钥。登录密码至少 16 字符,会话密钥至少 32 字符;使用独立随机值。

docker compose up -d

打开 http://127.0.0.1:8767。数据保存在 Docker 卷 databack_ledger,自动备份保存在 databack_snapshots。

通过域名访问时配置 HTTPS 反向代理,并在 .env 修改:

DATABACK_PUBLIC_ORIGIN=https://backup.example.com
DATABACK_ALLOWED_HOSTS=backup.example.com,127.0.0.1:8767,localhost:8767

代理在其他设备上时,设置 DATABACK_BIND_IP 为 Docker 主机的内网地址。外部访问使用 HTTPS,本机访问可使用 HTTP。

已有 MongoDB 可按 数据库配置 接入。

使用

  • 添加资料: 新建文件夹/添加文件 → 填写名称、类型和所属目录。
  • 登记备份: 将末级文件或文件夹设为备份对象 → 点击名称 → 新增记录 → 填写时间、位置、说明。
  • 批量登记: 点击批量登记后勾选项目,或粘贴表格,每批最多 20 条。
  • 查询与修改: 历史记录 → 筛选资料、位置、日期 → 编辑或删除记录。
  • 隐私目录: 点击左上角 DataBack → 输入隐私密码;再次点击收起。
  • 撤销删除: 在删除后的提示中点击撤销。

更新

docker compose pull app
docker compose up -d app

镜像更新保留数据卷和 .env。查看运行状态:docker compose ps;查看日志:docker compose logs --tail=100 app。

开发与发布

环境安装、本地运行、修改代码和测试命令见 网页开发文档。

推送分支并创建 PR → 检查通过后合并到 main → 等待 GitHub Actions 发布镜像 → Docker 主机拉取更新。镜像同时提供 latest 和 sha-完整提交编号 标签。

本机构建镜像:docker build -t databack .(在项目根目录执行)。

数据备份与恢复

  • 自动备份: 服务端每天保存一份台账快照,保留最新 30 份;Docker 默认保存在 databack_snapshots 数据卷。
  • 本机完整备份: 关闭程序后复制 data/。
  • Docker 完整备份: 停止服务后备份数据卷和 .env,命令见 数据备份。

台账只记录目录和备份信息,实际文件和部署密码另行保存。

目录

web/               网页界面、API、测试
DEVELOPMENT.md     网页开发说明
deploy/mongodb/    可选 MongoDB 副本集配置
Dockerfile         镜像构建
compose.yaml       Docker 部署

MIT License

About

文件与文件夹备份记录,支持批量登记、历史查询和隐私目录。Self-hosted backup tracker for Docker and Windows.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages