# docker-it-tools

**Repository Path**: meimolihan/it-tools

## Basic Information

- **Project Name**: docker-it-tools
- **Description**: docker-it-tools 工具箱
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: docker-compose

## README

# 🛠️ Docker 部署 IT-Tools 开发者工具箱

![IT Tools 工具箱](https://file.meimolihan.eu.org/img/it-tools-01.webp)

## 📋 目录导航
- [🎯 项目简介](#project-intro)
- [✨ 核心特性](#features)
- [🐳 一、Docker 部署 IT-Tools](#deploy)
  - [1. 创建部署目录和 `docker-compose.yml` 文件 📁](#deploy-setup)
  - [2. 拉取镜像并启动容器 🚀](#deploy-start)
- [🚀 二、使用 IT-Tools](#usage)
  - [1. 访问 Web 界面 💻](#usage-access)
  - [2. 工具分类介绍 🎯](#usage-tools)
- [🌐 三、Nginx 反向代理配置](#nginx)
  - [1. 创建 Nginx 配置文件 🔧](#nginx-config)
  - [2. 测试并重载 Nginx 🔄](#nginx-reload)
- [🔧 四、容器维护命令](#maintenance)
  - [1. Docker Compose 命令 🐳](#docker-compose)
  - [2. Docker 容器命令 📦](#docker)
  - [3. Docker 镜像管理 📀](#docker-images)

<a id="project-intro"></a>
## 🎯 项目简介

IT-Tools 是一个集成了多种实用开发工具的网络应用，为开发者和IT专业人员提供了一站式的工具集合。通过 Docker 部署，您可以轻松访问各种编码、转换、计算和网络工具，无需安装多个独立应用程序。

**Docker Hub 地址：** <https://hub.docker.com/r/qingfeng2336/it-tools>  
**GitHub 地址：** <https://github.com/CorentinTh/it-tools>  
**本地访问地址：** <http://localhost:8088>

<a id="features"></a>
## ✨ 核心特性

| 特性类别         | 功能描述                     | 优势                           |
| ---------------- | ---------------------------- | ------------------------------ |
| **🛠️ 多工具集成** | 包含 100+ 种实用开发工具     | 一站式解决多种开发需求         |
| **🌐 Web 界面**   | 通过浏览器即可访问所有工具   | 无需安装客户端，跨平台使用     |
| **🎨 美观界面**   | 现代化的用户界面设计         | 操作直观，用户体验优秀         |
| **📱 响应式设计** | 完美适配桌面和移动设备       | 随时随地使用工具               |
| **⚡ 实时计算**   | 大多数工具支持实时计算和转换 | 即时反馈，提高工作效率         |
| **🐳 快速部署**   | Docker 容器化部署            | 简单快捷，环境一致             |
| **🔒 本地运行**   | 所有数据处理均在本地完成     | 保障隐私安全，无需担心数据泄露 |

<a id="deploy"></a>
## 🐳 一、Docker 部署 IT-Tools

<a id="deploy-setup"></a>
### 1. 创建部署目录和 `docker-compose.yml` 文件 📁

```bash
mkdir -p /mnt/mydisk/home/it-tools && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  it-tools:
    container_name: it-tools
    image: qingfeng2336/it-tools:latest
    restart: unless-stopped
    ports:
      - "8088:80"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data  # 可选：数据持久化
EOF
```

<a id="deploy-start"></a>
### 2. 拉取镜像并启动容器 🚀

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

<a id="usage"></a>
## 🚀 二、使用 IT-Tools

<a id="usage-access"></a>
### 1. 访问 Web 界面 💻

- **本地访问**：<http://localhost:8088>  
- **域名访问**：<https://tools.yourdomain.com>（配置反向代理后）

<a id="usage-tools"></a>
### 2. 工具分类介绍 🎯

#### 编码/解码工具
- Base64 编码/解码
- URL 编码/解码
- HTML 实体编码/解码
- JWT 解析和验证

#### 加密/哈希工具
- MD5、SHA1、SHA256 哈希计算
- HMAC 生成器
- UUID 生成器
- 密码生成器

#### 网络工具
- IP 地址查询
- 子网计算器
- HTTP 状态码查询
- User-Agent 分析

#### 文本处理工具
- 文本差异比较
- 正则表达式测试
- JSON 格式化验证
- XML 格式化

<a id="nginx"></a>
## 🌐 三、Nginx 反向代理配置

<a id="nginx-config"></a>
### 1. 创建 Nginx 配置文件 🔧

```bash
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/it-tools.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name tools.yourdomain.com;   # 替换为你的域名

    # SSL 证书
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    location / {
        proxy_pass http://127.0.0.1:8088;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
EOF
```

<a id="nginx-reload"></a>
### 2. 测试并重载 Nginx 🔄

```bash
sudo nginx -t && sudo systemctl reload nginx
```

<a id="maintenance"></a>
## 🔧 四、容器维护命令

<a id="docker-compose"></a>
### 1. Docker Compose 命令 🐳

```bash
# 进入项目目录
cd /mnt/mydisk/home/it-tools

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f
```

<a id="docker"></a>
### 2. Docker 容器命令 📦

```bash
# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop it-tools
docker start it-tools  
docker restart it-tools

# 进入容器Shell
docker exec -it it-tools sh
docker exec -it it-tools bash

# 查看容器日志
docker logs it-tools
docker logs -f it-tools
docker logs --tail 100 it-tools
```

<a id="docker-images"></a>
### 3. Docker 镜像管理 📀

```bash
docker images                  # 列出所有镜像
docker rmi qingfeng2336/it-tools:latest    # 删除指定镜像
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像
```

---
**💡 提示**：IT-Tools 提供了丰富的开发工具集合，通过 Docker 部署可以快速搭建并使用这些工具，大大提高开发效率！