# DWSW-Docker-UI

**Repository Path**: zsferhome/DWSW-Docker-UI

## Basic Information

- **Project Name**: DWSW-Docker-UI
- **Description**: 通过 Gitee Api 获取仓库内的容器并且一键部署
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-30
- **Last Updated**: 2025-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DSWS Docker UI

[![Docker Pulls](https://hub.docker.com/r/lastthree/dsws-docker-ui)

一个轻量级 Docker 容器可视化管理工具，简化 Docker Compose 应用的部署与运维流程。

## 🌟 功能特点

- 可视化管理 Docker Compose 应用生命周期（部署、启动、停止、删除）
- 实时查看容器运行状态与日志输出
- 自动适配 Docker Compose v1/v2 版本
- 内置 Docker 仓库连接性测试工具
- 支持跳过 TLS 证书验证（适配特殊网络环境）

## 🚀 快速开始

### 前提条件

- Docker Engine ≥ 20.10
- Docker Compose ≥ v2
- 宿主机需开启 Docker 远程访问（默认通过 `/var/run/docker.sock` 实现）

### 安装步骤

#### 1. 拉取镜像

docker pull lastthree/dsws-docker-ui:1.0

#### 2. 启动容器

```bash
docker run -d \
  --name dsws-docker-ui \
  -p 5000:5000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/your/compose-files:/app/compose \
  --restart always \
  lastthree/dsws-docker-ui:1.0
```

参数说明：

- `-p 5000:5000`：映射 Web 服务端口（主机端口:容器端口）
- `-v /var/run/docker.sock:/var/run/docker.sock`：通过 Docker 套接字控制宿主机 Docker
- `-v /path/to/your/compose-files:/app/compose`：映射本地 Compose 文件目录（替换为实际路径）
- `--restart always`：容器退出时自动重启

#### 3. 访问应用

打开浏览器访问：`http://你的服务器IP:5000`

## ❓ 常见问题

### 1. 提示 "权限不足" 或无法连接 Docker

# 解决 Docker 套接字权限问题

sudo chmod 666 /var/run/docker.sock

### 2. 镜像拉取/推送失败

检查网络连接，或配置 Docker 镜像加速器：# /etc/docker/daemon.json（Linux）或 Docker Desktop 配置

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

### 3. Web 界面无法访问

# 检查容器运行状态

docker ps | grep dsws-docker-ui

# 查看容器日志排查错误

docker logs dsws-docker-ui

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支：`git checkout -b feature/xxx`
3. 提交修改：`git commit -m "添加xxx功能"`
4. 推送分支：`git push origin feature/xxx`
5. 提交 Pull Request

## 📞 联系方式

- 项目地址：[Gitee 仓库链接]（https://gitee.com/DoubleStackWorkShop/DWSW-Docker-UI）
- 作者：DoubleStackWorkShop
- 邮箱：1563119813@qq.com