accupara/subsurface

accupara/subsurface Docker镜像文档

镜像概述

accupara/subsurface是基于开源潜水日志管理软件Subsurface构建的Docker镜像，提供Linux（标签：linux）和Android（标签：android）两个平台版本。该镜像旨在为潜水爱好者、教练及相关专业人士提供便捷的容器化部署方案，用于高效记录、跟踪和分析潜水活动数据。

核心功能与特性

• 多平台支持：提供Linux和Android两种运行环境标签，适应桌面端与移动场景需求
• 潜水日志管理：记录潜水时间、最大深度、平均深度、水温、气瓶压力、潜水地点等关键数据
• 数据持久化：支持通过Docker数据卷挂载本地目录，确保潜水日志数据长期保存不丢失
• 数据兼容性：兼容主流潜水电脑数据格式，支持CSV、XML等格式的日志导入与导出
• 潜水计划工具：提供潜水计划制定功能，辅助规划潜水路线、深度与时间分配

使用场景

• 潜水爱好者个人潜水日志的记录与管理
• 潜水教练跟踪学员潜水活动进度及技术数据
• 潜水中心集中管理客户潜水记录档案
• 科研人员收集、整理潜水环境与活动相关数据

使用方法

镜像拉取

bash
# 拉取Linux平台版本
docker pull docker.xuanyuan.run/accupara/subsurface:linux

# 拉取Android平台版本
docker pull docker.xuanyuan.run/accupara/subsurface:android

基本运行命令

Linux版本运行示例

bash
docker run -it \
  --name subsurface-linux \
  -v /path/to/local/subsurface-data:/data \  # 挂载本地目录用于数据持久化
  accupara/subsurface:linux

Android版本运行示例（需配合Android运行环境）

bash
docker run -it \
  --name subsurface-android \
  -v /path/to/android-data:/data \          # 挂载Android数据目录
  accupara/subsurface:android

数据持久化配置

为避免容器重启或删除导致日志数据丢失，需通过-v参数将本地目录挂载至容器内数据存储路径（通常为/data）：

bash
-v /your/local/subsurface/logs:/data

注意事项

• 确保本地挂载目录具有读写权限，避免数据写入失败
• Android版本可能需要额外的Android运行环境支持（如Docker Android模拟器或设备映射）
• 详细功能使用及高级配置请参考Subsurface官方文档