Docker-Proxy/hubcmdui/README.md

中文 | English

Docker镜像加速命令查询获取、镜像搜索、配置教程文档展示UI面板.

📢 Docker Proxy-交流群

---

🔧 日志系统说明

本项目实现了生产级别的日志系统，支持以下特性：

日志级别

支持的日志级别从低到高依次为：

• TRACE: 最详细的追踪信息，用于开发调试
• DEBUG: 调试信息，包含详细的程序执行流程
• INFO: 一般信息，默认级别
• SUCCESS: 成功信息，通常用于标记重要操作的成功完成
• WARN: 警告信息，表示潜在的问题
• ERROR: 错误信息，表示操作失败但程序仍可继续运行
• FATAL: 致命错误，通常会导致程序退出

环境变量配置

可通过环境变量调整日志行为：

# 设置日志级别
export LOG_LEVEL=INFO  # 可选值: TRACE, DEBUG, INFO, SUCCESS, WARN, ERROR, FATAL

# 启用简化日志输出（减少浏览器请求详细信息）
export SIMPLE_LOGS=true

# 启用详细日志记录（包含请求体、查询参数等）
export DETAILED_LOGS=true

# 启用错误堆栈跟踪
export SHOW_STACK=true

# 禁用文件日志记录
export LOG_FILE_ENABLED=false

# 禁用控制台日志输出
export LOG_CONSOLE_ENABLED=false

# 设置日志文件大小上限(MB)
export LOG_MAX_SIZE=10

# 设置保留的日志文件数量
export LOG_MAX_FILES=14

Docker运行时配置

使用Docker运行时，可以通过环境变量传递配置：

docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 30080:3000 \
  -e LOG_LEVEL=INFO \
  -e SIMPLE_LOGS=true \
  -e LOG_MAX_FILES=7 \
  --name hubcmdui-server \
  dqzboy/hubcmd-ui

日志文件轮转

系统自动实现日志文件轮转：

• 单个日志文件超过设定大小(默认10MB)会自动创建新文件
• 自动保留指定数量(默认14个)的最新日志文件
• 日志文件存储在logs目录下，格式为app-YYYY-MM-DD.log

---

📝 源码构建运行

1. 克隆项目

git clone git@github.com:dqzboy/Docker-Proxy.git

2. 安装依赖

cd Docker-Proxy/hubcmdui
npm install

3. 启动服务

node server.js

📦 Docker 方式运行

1. 下载 hubcmd-ui 镜像

docker pull dqzboy/hubcmd-ui:latest

2. 运行 hubcmd-ui 容器

docker run -d -v /var/run/docker.sock:/var/run/docker.sock -p 30080:3000 --name hubcmdui-server dqzboy/hubcmd-ui

• -v 参数解释：左边是宿主机上的 Docker socket 文件路径，右边是容器内的映射路径

Docker Compose 部署

1. 下载 docker-compose.yaml 文件到你本地机器上

2. 执行 docker compose 或 docker-compose 命令启动容器服务

docker compose up -d

# 查看容器日志
docker logs -f [容器ID或名称]

---

UI界面

• 默认容器监听3000端口，映射宿主机端口30080

浏览器输入 服务器地址:30080 访问前端

浏览器输入 服务器地址:30080/admin 访问后端页面，默认登入账号密码: root / admin@123

---

🫶 赞助

如果你觉得这个项目对你有帮助，请给我点个Star。并且情况允许的话，可以给我一点点支持，总之非常感谢支持😊

Alipay	WeChat Pay

---

😺 其他

开源不易,若你参考此项目或基于此项目修改可否麻烦在你的项目文档中标识此项目？谢谢你！

---

License

Docker-Proxy is available under the Apache 2 license