airpower/shipyard

Shipyard Docker镜像文档

概述

Shipyard 是一款基于Docker API构建的轻量级容器管理工具，专注于提供Docker容器及Swarm集群的可视化管理能力。通过直观的Web界面，替代复杂的命令行操作，帮助用户高效管理Docker主机和Swarm集群，适用于简化中小型Docker环境的运维流程。

核心功能与特性

1. 直观Web界面管理

• 基于现代Web UI设计，提供简洁易用的操作界面，支持多语言切换
• 无需记忆Docker命令，通过图形化操作完成容器生命周期管理

2. 容器全生命周期管理

• 支持容器创建、启动、停止、重启、删除等操作
• 实时查看容器日志、控制台输出及资源占用情况
• 支持容器网络配置（端口映射、环境变量、数据卷挂载）

3. Swarm集群管理

• 支持Swarm集群初始化及节点管理（添加/移除节点、查看节点状态）
• 服务部署与扩缩容（指定副本数、资源限制、更新策略）
• 跨节点容器调度与负载均衡配置

4. 资源监控与告警

• 实时监控容器/主机的CPU、内存、磁盘IO及网络流量
• 支持资源使用阈值设置及告警通知（邮件/日志）
• 提供历史资源使用趋势图表

5. 镜像与仓库管理

• 集成Docker Registry，支持镜像拉取、推送、删除操作
• 查看镜像详情（标签、大小、构建历史）
• 镜像扫描与安全漏洞检测（需配置第三方扫描工具）

使用场景

• 中小型Docker环境管理：替代命令行，降低运维门槛
• 开发测试环境：快速部署、调试容器化应用
• 教学演示：直观展示Docker容器与集群工作原理
• 边缘计算场景：轻量级部署，适合资源受限的边缘节点管理

使用方法

前提条件

• Docker Engine 1.12+ 或 Docker Desktop
• 若管理Swarm集群，需提前初始化Swarm（docker swarm init）
• 网络通畅，确保容器可访问Docker API及外部镜像仓库

快速启动（Docker Run）

通过官方镜像直接启动Shipyard容器：

bash
docker run -d \
  --name shipyard \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart=always \
  shipyard/shipyard:latest

• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程socket，使Shipyard能访问Docker API
• -p 8080:8080：映射Web界面端口
• --restart=always：容器异常退出后自动重启

访问Web界面

启动后，通过 http://<主机IP>:8080 访问Web界面，默认管理员账号：

• 用户名：admin
• 密码：shipyard（首次登录建议修改）

管理Docker主机/Swarm集群

1. 添加Docker主机： 在Web界面左侧导航栏选择「主机」→「添加主机」，输入Docker主机IP及API端口（默认2375，需确保Docker开启远程API）。

2. 管理Swarm集群：

   • 初始化Swarm后，在「集群」页面点击「加入集群」，输入Swarm Manager节点的连接令牌（通过 docker swarm join-token manager 获取）
   • 部署服务：选择「服务」→「创建服务」，指定镜像、副本数、资源限制及网络配置

持久化数据

为避免容器重启后配置丢失，挂载数据卷保存配置：

bash
docker run -d \
  --name shipyard \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/shipyard/data:/var/lib/shipyard \
  --restart=always \
  shipyard/shipyard:latest

• /opt/shipyard/data：本地目录用于持久化Shipyard配置、用户数据及监控指标

配置说明

环境变量配置

启动容器时可通过 -e 指定环境变量调整配置：

安全配置建议

• 修改默认密码：登录后通过「设置」→「用户管理」更新管理员密码
• 限制Docker API访问：生产环境建议通过TLS加密Docker API，避免直接暴露/var/run/docker.sock
• 网络隔离：将Shipyard部署在私有网络，仅允许授权IP访问Web界面端口

注意事项

• Shipyard不支持Docker Swarm Mode以外的集群管理（如Kubernetes）
• 大规模集群（>50节点）建议评估性能，可能存在界面响应延迟
• 数据持久化依赖挂载卷，需定期备份/var/lib/shipyard目录

参考链接

• 官方GitHub：https://github.com/airpwr/shipyard
• Docker Hub镜像：https://hub.docker.com/r/shipyard/shipyard
• 官方文档：[***]