Docker镜像导入导出工具 —— 飞牛NAS Docker镜像管理利器
作者： Ghost Z
版本： v1.0.0
适用平台： 飞牛NAS（全平台）
应用简介
你是否曾经在飞牛NAS上折腾Docker镜像时，苦于无法方便地导入本地的 .tar 镜像文件？或者想把手头跑的好用的镜像导出分享给朋友，却发现命令行操作繁琐易出错？
Docker镜像导入导出工具 专为解决这些痛点而生。它是一款运行在飞牛NAS上的FPK应用，提供完整的 Web 图形化管理界面，让你彻底告别命令行，轻松完成 Docker 镜像的导入导出操作。
核心功能
镜像导入
支持三种灵活的导入方式，满足不同场景需求：
| 导入方式 |
说明 |
| 上传导入 |
通过Web界面点击或拖拽上传 .tar 镜像文件，支持多选批量上传 |
| NAS路径导入 |
直接输入NAS本地路径（逗号或换行分隔多个路径），无需重复上传 |
| 文件夹扫描 |
扫描NAS目录下所有 .tar 文件，勾选后一键批量导入 |
导入时自动检测本地是否已有同名镜像，如有重复会弹窗确认后再覆盖导入，避免误操作。
镜像导出
- 自动获取本地所有 Docker 镜像列表（仓库:标签、镜像ID、大小）
- 支持勾选多个镜像批量导出为
.tar 文件
- 可手动指定导出目标目录，灵活选择存储位置
- 导出文件名自动规范命名（
仓库_标签.tar）
通用特性
- 实时日志输出 —— 所有操作都有详细的进度和结果反馈，成功/失败一目了然
- 动画进度条 —— 导入导出过程实时显示进度，操作不焦虑
- 暗色主题 —— 深色界面风格，与飞牛NAS原生体验一致
- 标签页切换 —— 导入/导出独立面板，导出页懒加载，不占用资源
- 端口自动检测 —— 启动时自动检测端口占用，冲突时兜底监听默认端口
安装与使用
安装
- 在飞牛NAS应用中心上传并安装
docker-image-import.fpk
- 安装向导中可自定义服务端口（默认
12312）
- 安装前会自动检测 Docker 环境，未安装Docker会阻止安装
使用
- 点击飞牛桌面「Docker镜像导入导出工具」入口，或通过
/app/docker-image-import 访问
- 导入镜像：切换到「导入镜像」标签 → 上传文件 / 输入NAS路径 / 扫描文件夹 → 点击批量导入
- 导出镜像：切换到「导出镜像」标签 → 等待镜像列表加载 → 勾选目标镜像 → 指定导出目录 → 点击批量导出
卸载
卸载应用不会影响已导入的 Docker 镜像，所有镜像完整保留在 Docker 中。
技术架构
| 层面 |
技术选型 |
| 后端 |
Python 3 + 标准库（http.server 自建HTTP服务） |
| 前端 |
原生 HTML / CSS / JavaScript（零框架依赖） |
| Docker交互 |
Docker CLI（docker images / docker load / docker save） |
| 打包 |
FPK 格式（飞牛NAS应用包标准） |
| UI风格 |
暗色主题，Material Design 配色 |
API 接口
| 方法 |
路径 |
功能 |
| GET |
/ |
返回Web管理页面 |
| GET |
/api/images |
获取Docker镜像列表 |
| GET |
/api/scan-dir?path=xxx |
扫描NAS目录下的 .tar 文件 |
| POST |
/api/batch-import |
批量导入镜像 |
| POST |
/api/batch-export |
批量导出镜像 |
安全说明
- 运行权限：需
root 权限（Docker CLI 要求）
- 路径白名单：目录扫描仅允许
/vol、/home/、/mnt/、/media/、/srv/ 开头的路径
- 临时文件：上传文件写入应用专属临时目录，导入完成自动清理
- 零外部依赖：后端仅使用 Python 标准库，不引入第三方包，安全可控
项目地址与下载
- 应用标识：
docker-image-import
- 下载：见附件
docker-image-import.fpk
更新日志
v1.0.0（2025-06-05）
- 初始版本发布
- 支持上传导入、路径导入、文件夹扫描导入三种方式
- 支持批量导出 Docker 镜像
- 导入前重复镜像检测与覆盖确认
- 实时日志与进度条
- 安装向导：自定义服务端口
- 卸载向导：数据保留选项
有任何问题或建议欢迎在评论区留言交流，感谢支持！
