# niche-dind

**Repository Path**: noogel/niche-dind

## Basic Information

- **Project Name**: niche-dind
- **Description**: 小众的 Docker in Docker 管理工具~
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-12
- **Last Updated**: 2025-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docker in Docker Manager

一个强大的Docker容器管理平台,提供直观的Web界面来管理Docker Compose项目和Docker Stack部署。该应用专为需要管理多个Docker环境的团队设计,提供了完整的容器生命周期管理功能。

## 功能特点

- Docker Compose 项目管理
  - 创建、编辑和删除Compose项目
  - 项目配置版本控制
  - 一键部署和更新
- Docker Stack 部署管理
  - 服务扩展和更新
- 容器状态监控
  - 实时容器状态
  - 资源使用统计
  - 健康检查状态
- OIDC 单点登录认证
  - 支持多种OIDC提供商
  - 细粒度的访问控制
  - 会话管理
- 实时容器日志查看
  - 多容器日志聚合
  - 日志过滤和搜索
  - 日志导出功能
- 容器资源使用统计
  - CPU和内存使用率
  - 网络I/O统计
  - 磁盘使用情况
- 容器管理
  - 启动/停止/重启容器
  - 容器配置修改
  - 容器网络管理
- 镜像管理
  - 本地镜像列表
  - 镜像拉取和推送
  - 镜像标签管理
- Docker仓库配置管理
  - 多仓库配置支持
  - 仓库认证管理
  - 连接测试功能
  - 仓库镜像列表

## 技术栈

- 后端: Flask 3.0.2
- 容器管理: Docker SDK 7.1.0
- 认证: Authlib 1.6.0
- 服务器: Gunicorn 21.2.0
- 开发工具: pytest, black, flake8

## 安装说明

1. 克隆项目:
```bash
git clone [项目地址]
cd niche-dind
```

2. 安装依赖:
```bash
pip install -r requirements.txt
```

## 运行说明

### 开发环境

1. 配置环境变量:
```bash
export FLASK_APP=app
export FLASK_ENV=development
```

2. 运行应用:
```bash
flask run
```

### 生产环境

使用 Docker Compose 运行:

```bash
docker-compose up -d
```

应用将在 http://localhost:5002 上运行。

## 认证配置

项目使用 OIDC 进行认证,需要在环境变量中配置以下参数:

- OIDC_CLIENT_ID: OIDC 客户端 ID
- OIDC_CLIENT_SECRET: OIDC 客户端密钥
- OIDC_ISSUER: OIDC 认证服务器地址
- OIDC_REDIRECT_URI: 回调地址
- SECRET_KEY: Flask 会话密钥

## 项目结构

```
.
├── app/                # 应用主目录
│   ├── api/           # API接口定义
│   │   ├── compose/   # Compose相关API
│   │   ├── stack/     # Stack相关API
│   │   └── auth/      # 认证相关API
│   ├── templates/     # HTML模板文件
│   ├── static/        # 静态资源文件
│   ├── views/         # 视图函数
│   ├── models/        # 数据模型
│   ├── utils/         # 工具函数
│   ├── config.py      # 应用配置
│   └── __init__.py    # 应用初始化
├── tests/             # 测试文件
├── docs/              # 文档
│   └── img/          # 文档图片
├── Dockerfile         # Docker 构建文件
├── docker-compose.yml # Docker Compose 配置
├── requirements.txt   # Python 依赖
└── README.md         # 项目文档
```

## 开发指南

1. 代码格式化:
```bash
black .
```

2. 代码检查:
```bash
flake8
```

3. 运行测试:
```bash
pytest
```

## 应用截图

![index.jpg](docs/img/WechatIMG180.jpg)

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 使用说明

### 基本操作

1. 访问应用首页 (http://localhost:5002)
2. 使用OIDC账号登录
3. 在左侧菜单选择要管理的功能
4. 使用相应的功能面板进行操作

### 常见问题

1. 容器无法启动
   - 检查Docker服务状态
   - 查看容器日志
   - 确认资源限制

2. 认证失败
   - 确认OIDC配置正确
   - 检查网络连接
   - 验证客户端凭证

3. 性能问题
   - 检查系统资源使用
   - 优化容器配置
   - 调整应用参数