openiamdocker/stash

Stash Docker镜像文档

概述

Stash是一个轻量级的数据存储与备份工具，旨在提供简单高效的文件管理解决方案。该Docker镜像封装了Stash工具的完整功能，让用户能够快速部署和使用，无需复杂的环境配置。

核心功能

• 文件版本控制：自动跟踪文件变更，支持版本历史查看和回滚
• 数据备份：提供定时备份功能，保护重要数据安全
• 轻量级设计：资源占用低，适合各种环境部署
• 跨平台兼容：可在任何支持Docker的系统上运行
• 简单易用：通过命令行界面操作，学习曲线平缓

使用场景

• 个人文件管理与版本控制
• 小型团队的文档协作
• 开发环境中的代码片段管理
• 系统配置文件备份
• 临时数据存储与共享

快速开始

基本用法

使用以下命令启动Stash容器：

bash
docker run -d \
  --name=stash \
  -v /path/to/your/data:/data \
  -p 8080:8080 \
  stash:latest

Docker Compose配置

yaml
version: '3'
services:
  stash:
    image: stash:latest
    container_name: stash
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
      - ./config:/etc/stash
    environment:
      - STASH_USER=admin
      - STASH_PASSWORD=securepassword
      - BACKUP_SCHEDULE=0 3 * * *

配置说明

环境变量

卷挂载

使用方法

访问Web界面

启动容器后，通过浏览器访问以下地址打开Stash的Web界面： http://localhost:8080

使用配置的用户名和密码登录系统。

基本命令行操作

进入容器内部执行命令：

bash
docker exec -it stash stash [command]

常用命令：

• stash add <file> - 添加文件到存储库
• stash commit -m "message" - 提交更改
• stash backup - 手动执行备份
• stash restore <version> - 恢复到指定版本
• stash list - 列出存储的文件

备份与恢复

手动创建备份

bash
docker exec -it stash stash backup

恢复数据

bash
docker exec -it stash stash restore <backup_id>

备份文件默认存储在容器内的/backups目录，建议将此目录挂载到宿主机以确保备份数据安全。

维护与更新

查看日志

bash
docker logs -f stash

更新镜像

bash
docker pull stash:latest
docker stop stash
docker rm stash
# 然后使用初始run命令重新启动容器

注意事项

• 确保挂载的数据卷有足够的磁盘空间
• 定期检查备份状态，确保数据安全
• 在生产环境中，建议修改默认密码并启用HTTPS
• 对于大量数据存储，考虑配置外部存储后端

支持

如需获取更多帮助，请访问项目官方文档或提交issue到GitHub仓库。