昱君NAS容器管理系统

DIAN

DianCup - 昱君NAS容器管理系统

一个现代化的 Docker 容器可视化管理面板

🚀 快速开始

Docker Compose 部署（推荐）

services:
diancup:
image: yjnas/diancup:latest
container_name: diancup
network_mode: host
restart: always
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /mnt/cache/docker:/mnt/cache/docker # 你的 Docker Compose 项目目录
- ./config:/config
- /:/host # 可选，用于文件浏览
environment:
- DOCKER_DIR=/mnt/cache/docker # 你的 Docker Compose 项目目录
- WEB_PORT=9527 # 默认端口
labels:
- com.docker.updater.exclude=true


启动：
```bash
docker-compose up -d

访问：http://your-ip:9527

✨ 核心功能

📦 容器管理

  • ✅ 启动/停止/重启/删除容器
  • ✅ 实时查看容器日志
  • ✅ 容器终端（Web Shell）
  • ✅ 容器资源监控（CPU、内存、网络）
  • ✅ 容器更新检测和一键更新
  • ✅ 批量操作容器

🖼️ 镜像管理

  • ✅ 拉取/删除镜像
  • ✅ 镜像加速器支持（10+ 国内加速源）
  • ✅ 清理未使用镜像
  • ✅ 从镜像创建容器

🌐 网络管理

  • ✅ 查看所有 Docker 网络
  • ✅ 创建/删除网络
  • ✅ 查看网络连接的容器

💾 卷管理

  • ✅ 查看所有 Docker 卷
  • ✅ 创建/删除卷
  • ✅ 查看卷使用情况

📋 Compose 项目管理

  • ✅ 自动扫描 Compose 项目
  • ✅ 启动/停止/重启项目
  • ✅ 查看项目日志
  • ✅ 在线编辑 docker-compose.yml
  • ✅ Compose 生成器：从现有容器生成 compose 文件

🔧 Compose 生成器（智能）

  • ✅ 自动过滤镜像默认配置
  • ✅ 只保留用户自定义的环境变量
  • ✅ 智能处理网络配置
  • ✅ 过滤默认的 Command 和 Entrypoint
  • ✅ 生成最简洁的 compose 文件

📝 容器模板

  • ✅ 保存容器配置为模板
  • ✅ 从模板快速部署容器
  • ✅ 模板分类管理

⏰ 定时任务

  • ✅ 定时启动/停止容器
  • ✅ 定时启动/停止 Compose 项目
  • ✅ Cron 表达式支持
  • ✅ 智能跳过已处于目标状态的任务
  • ✅ 自动清理无效任务

🖥️ SSH 终端

  • ✅ 多服务器管理
  • ✅ SSH 密钥认证
  • ✅ SFTP 文件传输
  • ✅ 自定义命令快捷方式

📊 系统监控

  • ✅ 实时 CPU/内存/磁盘监控
  • ✅ 容器资源统计
  • ✅ 端口占用查看

📁 文件管理器

  • ✅ 浏览主机文件系统
  • ✅ 文件上传/下载
  • ✅ 文件编辑/重命名/删除
  • ✅ 文件压缩/解压

🎨 界面特性

  • ✅ 深色/浅色主题切换
  • ✅ 响应式设计（桌面/移动端）
  • ✅ 自动适配移动设备
  • ✅ 自定义容器图标
  • ✅ 实时状态更新（WebSocket）

🔐 安全功能

  • ✅ API Key 认证
  • ✅ 密码加密存储
  • ✅ SSH 密钥管理

📢 消息推送

  • ✅ 企业微信消息推送
  • ✅ 容器状态变化通知

📂 目录结构

/config/
├── yjnas.db           # 数据库文件
├── icons/             # 自定义图标
└── images/            # SSH 背景图片

🔧 环境变量

变量 说明 默认值
DOCKER_DIR Docker Compose 项目目录 无
WEB_PORT Web 服务端口 9527
APSCHEDULER_DEBUG 定时任务调试模式 false

💡 使用技巧

1. 移动端访问

  • 移动设备自动跳转到移动端界面
  • 强制桌面版：访问 http://your-ip:9527?desktop=true

2. Compose 生成器

  1. 选择要导出的容器
  2. 点击"生成 Compose"
  3. 系统自动生成最简洁的配置
  4. 下载或直接部署

3. 容器更新

  1. 点击"检查更新"
  2. 查看可更新的容器
  3. 点击"更新"一键完成

4. 定时任务

  • 使用 Cron 表达式：0 2 * * *（每天凌晨2点）
  • 系统自动跳过已处于目标状态的任务
  • 自动清理容器/项目不存在的任务

🐛 常见问题

Q: 无法连接 Docker

A: 检查 Docker socket 是否正确挂载：

docker exec diancup ls -la /var/run/docker.sock

Q: Compose 项目不显示

A: 确认 DOCKER_DIR 环境变量已设置且目录已挂载：

docker exec diancup env | grep DOCKER_DIR

Q: 图标不显示

A: 刷新浏览器缓存（Ctrl+Shift+R）

📦 数据备份

# 备份配置
docker cp diancup:/config ./backup/

# 恢复配置
docker cp ./backup/config diancup:/config

🔗 相关链接

📄 许可证

MIT License

感谢使用 DianCup！ 🎉

评论