# SimpleDocker **Repository Path**: czpinggo/SimpleDocker ## Basic Information - **Project Name**: SimpleDocker - **Description**: SimpleDocker 是一个简单的Docker控制面板，致力于可以让开发者更方便，更无障碍的使用Docker, 其界面简洁，操作便捷，更多功能欢迎探索 ! - **Primary Language**: Go - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: https://www.zhoutao123.com - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 398 - **Created**: 2021-02-25 - **Last Updated**: 2021-02-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # SimpleDocker README [![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
> 🎉 🔥 ✨ 新发布的 V0.0.3 版本支持 容器在线终端、在线文件浏览及文件下载 、容器性能监控等新功能 SimpleDocker 是一个简单的Docker控制面板，致力于可以让你更方便，更无障碍的使用Docker,其界面简洁，操作便捷， **后期将开发内部接口API** *个人开发维护不易，麻烦给个 Star ✨ 鼓励一下作者,您的鼓励是我最大的动力 😛！！！* ## 背景 Docker是目前一种非常主流的容器化方案，支持非常多的特性，给开发者带来便利，但是Docker 镜像以及容器管理复杂的参数让新手望而却步，基于此开发 SimpleDocker 控制面板，方便大家使用!!! > 本项目是基于学习的目的的，目前的版本安全性以及功能性暂不全面，和同类型软件有功能上的重叠，本项目致力于提供一个 界面清晰、免费的、简单的、专注于Docker服务管理的控制面板，注意本项目是以学习为目的(当然也会持续开发下去~)，请勿和专业软件做类比，只想做一个适合自己的管理软件！！！ > Tip: 您可以在Issues中提出需求和您发现的bug！[需求 & BUG 管理](https://github.com/taoes/SimpleDocker/issues) **🎉 目前支持以下特性:** ✅ 1. 镜像管理 + 镜像拉取 + 镜像运行、导出、导入、删除 + 镜像详情 ✅ 2. 容器管理 + 容器启动、停止、运行、暂停、删除、精简 + 容器导出 + 容器终端(Linux) + 网络连接管理 + 日志导出、下载 + 容器文件浏览、下载(Linux) + 容器性能监控 ✅ 3. 挂载卷管理/创建/删除/精简 ✅ 4. 网络管理/创建/精简 ✅ 5. 安全登录功能/密码重置 **✏️ 正在开发的任务** 🎉 1. 优化导出&导入&拉取等阻塞性任务的操作体验 (进行中 🎉) 🧾 2. API 接口开放(文档整理中) **🛠 计划支持的特性:** 1. 容器文件下载与上传(计划中) 2. 私有仓库的镜像拉取(计划中) 3. DockerCompose 镜像编排管理(计划中) 4. DockerSwarm 集群管理(计划中) ## 应用安装 使用前，请先安装 unzip 命令用于解压压缩包以及确保 Docker 服务正常 > + ubuntu系统下使用 `sudo apt-get install unzip` > + centos 下使用 `yum install -y unzip` + Docker 安装 (推荐👍🏻) ```sh docker run -d -p 8080:4050 -v /var/run/docker.sock:/var/run/docker.sock --name SimpleDocker registry.cn-hangzhou.aliyuncs.com/seven-tao/simple-docker:0.0.4 // 浏览器访问 http://localhost:8080 ``` + 手动安装 1.通过 [https://github.com/taoes/SimpleDocker/releases/](https://github.com/taoes/SimpleDocker/releases/) 下载最新发布的版本 2. 创建文件夹`~/.local/simpleDocker` 并解压文件,将解压后的文件复制到 `~/.local/simpleDocker` 目录 3. 将文件夹 `~/.local/simpleDocker` 配置到环境变量 PATH中(可选) 4. 注意: **一定要解压后的文件放到 `~/.local/simpleDocker` 下，否则会出现容器文件浏览功能无法使用** + 手动编译 1. 克隆代码到本地，并启动 beego项目 ```shell git clone https://gitee.com/taoes_admin/SimpleDocker cd ./SimpleDocker bee run ``` 2. 新建终端窗口，切换到 `ui` 目录下打开前端项目 3. 修改 `ui/src/api/Config.js` 文件内容，确保请求前缀和 beego 端口一致 ```shell cd ui yarn install && yarn server ``` 4. 打开相应的前端端口，即可访问，调试 ## 应用启动 1. 刷新环境变量设置后，使用命令`simpleDocker` 启动应用(后台运行可使用 `nohup simpleDocker &` 命令启动) 2. 启动应用后，浏览器访问 `http://localhost:4050` 打开应用 3. 账户名：admin 密码: SimpleDocker2020 您可以在登录后修改密码 > 目前存在一个BUG正在修复中，请在 `~/.local/simpleDocker` 目录下执行命令，否则可能报错 ## 预览 + Docker 信息 ![Docker 信息](./img/info.png) + Image 信息 ![Image 信息](./img/image.png) + 运行新的容器 ![Image 信息](./img/runContainer.png) + Container 信息 ![Container 信息](./img/container.png) + 容器终端在线管理 ![终端管理](./img/terminal.png) + 容器文件在线管理 ![终端管理](./img/file.png) + 容器性能监控 ![终端监控](./img/monitor.png) + 容器日志以及日志下载 ![Image 信息](./img/containerLog.png) + Volume 信息 ![Volume 信息](./img/volume.png) + Network 信息 ![Network 信息](./img/network.png) ## Q & A 1. 修改启动端口 > 如果您需要修改启动端口,可以使用 `SimpleDocker -p xxx` 的方式启动即可在指定端口启动 2. 保持后台运行以及关闭后台运行 > 您可以使用 `nohup SimpleDocker &` 命令后台启动 SimpleDocker ，如果关闭应用可以使用 `ps -ef | grep 'SimpleDocker'` 查找到PID，然后通过 `kill -9 pid` 关闭应用 3. 忘记密码 > 忘记密码时候，你可以切换到`~/.local/simpleDocker` 目录，修改auth.json 文件，将password值修改为`B923E7672631F71B510FEDB20A77EA8A` 即可恢复默认密码 `SimpleDocker2020` ## 相关依赖 - [GoLang](https://golang.org/) - [Docker API Engine](https://docs.docker.com/engine/api/sdk/) - [VueJs 2.x](https://vuejs.org/) - [Vuex](https://vuex.vuejs.org/) - [Ant Design Vue](https://www.antdv.com/docs/vue/introduce-cn/) ## 我的信息 + [燕归来兮的 Gitee ](https://github.com/taoes) + [燕归来兮的 Github](https://github.com/taoes) + [燕归来兮的技术博客](https://www.zhoutao123.com) ## 讨论 Feel free to dive in! [Open an issue](https://github.com/taoes/SimpleDocker/issues/new) or submit PRs. Standard Readme follows the [Contributor Covenant](http://contributor-covenant.org/version/1/3/0/) Code of Conduct. ## 开源方案 [GPL](./LICENSE)