tonym/NastyNAS
1
0
Fork 0
Code Issues 70 Pull Requests Actions Packages Projects Releases Wiki Activity

Configure IT Tools Utility Suite #44

New Issue
Closed
opened 2025-09-14 08:10:49 +00:00 by tonym · 1 comment
tonym commented 2025-09-14 08:10:49 +00:00
Owner
Copy Link

IT Tools Utility Suite Configuration Guide

Overview

IT Tools is a comprehensive collection of useful tools for developers and system administrators, providing various utilities like hash generators, encoders/decoders, formatters, and network tools in a single web interface.

Container Installation

Docker Run Command

docker run -d \
  --name=it-tools \
  --restart=unless-stopped \
  -p 8080:80 \
  corentinth/it-tools:latest

Docker Compose

version: "3.8"
services:
  it-tools:
    image: corentinth/it-tools:latest
    container_name: it-tools
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - TZ=America/Chicago

Container Configuration

Port Configuration

  • 8080: Web interface (HTTP)

Volume Mounts

  • No persistent storage required (stateless application)

Environment Variables

  • TZ: Timezone setting

Initial Configuration

Web Interface Access

  1. Open browser to http://your-server-ip:8080
  2. No authentication required
  3. Browse available tools by category

Available Tool Categories

Crypto

  • Hash text (MD5, SHA1, SHA256, SHA512)
  • HMAC generator
  • Bcrypt hash generator
  • UUID generator (v1, v4)
  • Crypto key generator
  • Password generator

Converter

  • Base64 encoder/decoder
  • URL encoder/decoder
  • HTML entities encoder/decoder
  • JWT decoder
  • QR code generator
  • ASCII text art generator

Web

  • URL parser
  • Device information
  • Basic auth generator
  • Open graph meta generator
  • User agent parser
  • HTTP status codes

Images & Videos

  • QR code generator
  • SVG placeholder generator
  • Image converter

Development

  • JSON formatter
  • SQL formatter
  • HTML formatter
  • CSS formatter
  • JavaScript formatter
  • XML formatter
  • YAML formatter

Network

  • IPv4 subnet calculator
  • IPv6 subnet calculator
  • IP geolocation
  • DNS lookup
  • Port scanner
  • MAC address lookup

Math

  • Mathematical expression evaluator
  • Base converter
  • Number base converter
  • Roman numeral converter

Measurement

  • Chronometer
  • Date converter
  • Integer converter
  • Temperature converter

Text

  • Lorem ipsum generator
  • Text statistics
  • Text case converter
  • Slugify text
  • Escape/unescape text

Service Configuration

Reverse Proxy Setup (Nginx)

server {
    listen 80;
    server_name it-tools.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:8080;
        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;
    }
}

Traefik Labels

services:
  it-tools:
    image: corentinth/it-tools:latest
    container_name: it-tools
    restart: unless-stopped
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.it-tools.rule=Host(`it-tools.yourdomain.com`)"
      - "traefik.http.routers.it-tools.entrypoints=websecure"
      - "traefik.http.routers.it-tools.tls.certresolver=letsencrypt"
      - "traefik.http.services.it-tools.loadbalancer.server.port=80"
    networks:
      - traefik

Integration Points

With Bookmarks

Create bookmark collection for quick access:

// Bookmark URLs
http://192.168.0.5:8080/hash-text
http://192.168.0.5:8080/base64-string-converter
http://192.168.0.5:8080/json-prettify
http://192.168.0.5:8080/url-encoder
http://192.168.0.5:8080/qr-code-generator
http://192.168.0.5:8080/uuid-generator
http://192.168.0.5:8080/password-strength-analyser

Browser Extensions

Create custom shortcuts for frequently used tools:

// Custom bookmarklet for quick access
javascript:(function(){window.open("http://192.168.0.5:8080/hash-text","_blank");})();

API Integration

Some tools can be automated with browser automation:

# Example: Automated hash generation
import requests
from selenium import webdriver

# Use selenium for browser automation of tools
driver = webdriver.Chrome()
driver.get("http://192.168.0.5:8080/hash-text")
# Automate form filling and result extraction

Monitoring & Notifications

Health Monitoring

# Check service health
curl -I http://localhost:8080

# Monitor response time
curl -w "@curl-format.txt" -o /dev/null -s http://localhost:8080

Uptime Monitoring

# Simple uptime check script
#!/bin/bash
if curl -f -s http://localhost:8080 > /dev/null; then
    echo "IT Tools is running"
else
    echo "IT Tools is down" | mail -s "IT Tools Alert" admin@yourdomain.com
fi

Resource Monitoring

# Monitor container resources
docker stats it-tools --no-stream

Backup Configuration

Configuration Backup

#!/bin/bash
# Backup docker-compose configuration
cp docker-compose.yml /mnt/user/backups/it-tools/docker-compose.yml.$(date +%Y%m%d)

No Data Backup Required

  • IT Tools is stateless
  • No persistent data to backup
  • Configuration is contained in docker-compose

Testing Procedures

Functionality Tests

  1. Basic Access Test:

    curl -I http://localhost:8080

  2. Tool Functionality Test:

    • Hash text tool
    • Base64 encoder/decoder
    • JSON formatter
    • QR code generator

  3. Performance Test:

    # Load test with apache bench
ab -n 100 -c 10 http://localhost:8080/

Browser Compatibility

  • Test in Chrome, Firefox, Safari, Edge
  • Test mobile responsiveness
  • Verify all tools function correctly

Troubleshooting

Common Issues

  1. Container Won't Start:

    # Check port conflicts
netstat -tulpn | grep :8080

# Check container logs
docker logs it-tools

  2. Tools Not Working:

    • Check browser console for JavaScript errors
    • Clear browser cache
    • Try different browser

  3. Performance Issues:

    # Check container resources
docker stats it-tools

# Monitor system resources
top

Log Analysis

# View container logs
docker logs it-tools

# Monitor real-time logs
docker logs -f it-tools

Network Issues

# Test network connectivity
curl -v http://localhost:8080

# Check if port is accessible
telnet localhost 8080

Maintenance

Regular Updates

# Update IT Tools container
docker pull corentinth/it-tools:latest
docker stop it-tools
docker rm it-tools
docker-compose up -d

Health Checks

# Automated health check script
#!/bin/bash
HEALTH_CHECK_URL="http://localhost:8080"
RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" $HEALTH_CHECK_URL)

if [ $RESPONSE -eq 200 ]; then
    echo "IT Tools is healthy"
else
    echo "IT Tools health check failed: HTTP $RESPONSE"
    # Restart container if needed
    docker restart it-tools
fi

Resource Optimization

# Monitor memory usage
docker stats it-tools --format "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}"

# Clean up unused resources
docker system prune

Security Considerations

Network Security

  • Bind to localhost only: -p 127.0.0.1:8080:80
  • Use reverse proxy with SSL
  • Implement access controls

Input Validation

  • Tools handle input client-side
  • No sensitive data stored
  • Regular security updates

Privacy Considerations

  • All processing is client-side
  • No data sent to external servers
  • Safe for sensitive information

Advanced Configuration

Custom Build

# Custom IT Tools build
FROM corentinth/it-tools:latest

# Add custom tools or modifications
COPY custom-tools/ /usr/share/nginx/html/custom/

# Custom nginx configuration
COPY nginx.conf /etc/nginx/nginx.conf

Theme Customization

/* Custom theme via reverse proxy injection */
.theme-custom {
    --primary-color: #your-color;
    --background-color: #your-bg;
}

Tool Bookmarks

<!-- Custom bookmark page -->
<!DOCTYPE html>
<html>
<head>
    <title>IT Tools Bookmarks</title>
</head>
<body>
    <h1>Quick Access IT Tools</h1>
    <ul>
        <li><a href="/hash-text">Hash Text</a></li>
        <li><a href="/base64-string-converter">Base64 Converter</a></li>
        <li><a href="/json-prettify">JSON Formatter</a></li>
        <li><a href="/qr-code-generator">QR Code Generator</a></li>
    </ul>
</body>
</html>

Mobile App Integration

// Progressive Web App setup
{
  "name": "IT Tools",
  "short_name": "ITTools",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#000000",
  "icons": [
    {
      "src": "icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ]
}

This guide provides comprehensive coverage of IT Tools utility suite setup and usage for development and system administration tasks.

# IT Tools Utility Suite Configuration Guide ## Overview IT Tools is a comprehensive collection of useful tools for developers and system administrators, providing various utilities like hash generators, encoders/decoders, formatters, and network tools in a single web interface. --- ## Container Installation ### Docker Run Command ```bash docker run -d \ --name=it-tools \ --restart=unless-stopped \ -p 8080:80 \ corentinth/it-tools:latest ``` ### Docker Compose ```yaml version: "3.8" services: it-tools: image: corentinth/it-tools:latest container_name: it-tools restart: unless-stopped ports: - "8080:80" environment: - TZ=America/Chicago ``` --- ## Container Configuration ### Port Configuration - **8080**: Web interface (HTTP) ### Volume Mounts - No persistent storage required (stateless application) ### Environment Variables - `TZ`: Timezone setting --- ## Initial Configuration ### Web Interface Access 1. Open browser to `http://your-server-ip:8080` 2. No authentication required 3. Browse available tools by category ### Available Tool Categories #### Crypto - Hash text (MD5, SHA1, SHA256, SHA512) - HMAC generator - Bcrypt hash generator - UUID generator (v1, v4) - Crypto key generator - Password generator #### Converter - Base64 encoder/decoder - URL encoder/decoder - HTML entities encoder/decoder - JWT decoder - QR code generator - ASCII text art generator #### Web - URL parser - Device information - Basic auth generator - Open graph meta generator - User agent parser - HTTP status codes #### Images & Videos - QR code generator - SVG placeholder generator - Image converter #### Development - JSON formatter - SQL formatter - HTML formatter - CSS formatter - JavaScript formatter - XML formatter - YAML formatter #### Network - IPv4 subnet calculator - IPv6 subnet calculator - IP geolocation - DNS lookup - Port scanner - MAC address lookup #### Math - Mathematical expression evaluator - Base converter - Number base converter - Roman numeral converter #### Measurement - Chronometer - Date converter - Integer converter - Temperature converter #### Text - Lorem ipsum generator - Text statistics - Text case converter - Slugify text - Escape/unescape text --- ## Service Configuration ### Reverse Proxy Setup (Nginx) ```nginx server { listen 80; server_name it-tools.yourdomain.com; location / { proxy_pass http://localhost:8080; 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; } } ``` ### Traefik Labels ```yaml services: it-tools: image: corentinth/it-tools:latest container_name: it-tools restart: unless-stopped labels: - "traefik.enable=true" - "traefik.http.routers.it-tools.rule=Host(`it-tools.yourdomain.com`)" - "traefik.http.routers.it-tools.entrypoints=websecure" - "traefik.http.routers.it-tools.tls.certresolver=letsencrypt" - "traefik.http.services.it-tools.loadbalancer.server.port=80" networks: - traefik ``` --- ## Integration Points ### With Bookmarks Create bookmark collection for quick access: ```javascript // Bookmark URLs http://192.168.0.5:8080/hash-text http://192.168.0.5:8080/base64-string-converter http://192.168.0.5:8080/json-prettify http://192.168.0.5:8080/url-encoder http://192.168.0.5:8080/qr-code-generator http://192.168.0.5:8080/uuid-generator http://192.168.0.5:8080/password-strength-analyser ``` ### Browser Extensions Create custom shortcuts for frequently used tools: ```javascript // Custom bookmarklet for quick access javascript:(function(){window.open("http://192.168.0.5:8080/hash-text","_blank");})(); ``` ### API Integration Some tools can be automated with browser automation: ```python # Example: Automated hash generation import requests from selenium import webdriver # Use selenium for browser automation of tools driver = webdriver.Chrome() driver.get("http://192.168.0.5:8080/hash-text") # Automate form filling and result extraction ``` --- ## Monitoring & Notifications ### Health Monitoring ```bash # Check service health curl -I http://localhost:8080 # Monitor response time curl -w "@curl-format.txt" -o /dev/null -s http://localhost:8080 ``` ### Uptime Monitoring ```bash # Simple uptime check script #!/bin/bash if curl -f -s http://localhost:8080 > /dev/null; then echo "IT Tools is running" else echo "IT Tools is down" | mail -s "IT Tools Alert" admin@yourdomain.com fi ``` ### Resource Monitoring ```bash # Monitor container resources docker stats it-tools --no-stream ``` --- ## Backup Configuration ### Configuration Backup ```bash #!/bin/bash # Backup docker-compose configuration cp docker-compose.yml /mnt/user/backups/it-tools/docker-compose.yml.$(date +%Y%m%d) ``` ### No Data Backup Required - IT Tools is stateless - No persistent data to backup - Configuration is contained in docker-compose --- ## Testing Procedures ### Functionality Tests 1. **Basic Access Test**: ```bash curl -I http://localhost:8080 ``` 2. **Tool Functionality Test**: - Hash text tool - Base64 encoder/decoder - JSON formatter - QR code generator 3. **Performance Test**: ```bash # Load test with apache bench ab -n 100 -c 10 http://localhost:8080/ ``` ### Browser Compatibility - Test in Chrome, Firefox, Safari, Edge - Test mobile responsiveness - Verify all tools function correctly --- ## Troubleshooting ### Common Issues 1. **Container Won't Start**: ```bash # Check port conflicts netstat -tulpn | grep :8080 # Check container logs docker logs it-tools ``` 2. **Tools Not Working**: - Check browser console for JavaScript errors - Clear browser cache - Try different browser 3. **Performance Issues**: ```bash # Check container resources docker stats it-tools # Monitor system resources top ``` ### Log Analysis ```bash # View container logs docker logs it-tools # Monitor real-time logs docker logs -f it-tools ``` ### Network Issues ```bash # Test network connectivity curl -v http://localhost:8080 # Check if port is accessible telnet localhost 8080 ``` --- ## Maintenance ### Regular Updates ```bash # Update IT Tools container docker pull corentinth/it-tools:latest docker stop it-tools docker rm it-tools docker-compose up -d ``` ### Health Checks ```bash # Automated health check script #!/bin/bash HEALTH_CHECK_URL="http://localhost:8080" RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" $HEALTH_CHECK_URL) if [ $RESPONSE -eq 200 ]; then echo "IT Tools is healthy" else echo "IT Tools health check failed: HTTP $RESPONSE" # Restart container if needed docker restart it-tools fi ``` ### Resource Optimization ```bash # Monitor memory usage docker stats it-tools --format "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}" # Clean up unused resources docker system prune ``` --- ## Security Considerations ### Network Security - Bind to localhost only: `-p 127.0.0.1:8080:80` - Use reverse proxy with SSL - Implement access controls ### Input Validation - Tools handle input client-side - No sensitive data stored - Regular security updates ### Privacy Considerations - All processing is client-side - No data sent to external servers - Safe for sensitive information --- ## Advanced Configuration ### Custom Build ```dockerfile # Custom IT Tools build FROM corentinth/it-tools:latest # Add custom tools or modifications COPY custom-tools/ /usr/share/nginx/html/custom/ # Custom nginx configuration COPY nginx.conf /etc/nginx/nginx.conf ``` ### Theme Customization ```css /* Custom theme via reverse proxy injection */ .theme-custom { --primary-color: #your-color; --background-color: #your-bg; } ``` ### Tool Bookmarks ```html <!-- Custom bookmark page --> <!DOCTYPE html> <html> <head> <title>IT Tools Bookmarks</title> </head> <body> <h1>Quick Access IT Tools</h1> <ul> <li><a href="/hash-text">Hash Text</a></li> <li><a href="/base64-string-converter">Base64 Converter</a></li> <li><a href="/json-prettify">JSON Formatter</a></li> <li><a href="/qr-code-generator">QR Code Generator</a></li> </ul> </body> </html> ``` ### Mobile App Integration ```javascript // Progressive Web App setup { "name": "IT Tools", "short_name": "ITTools", "start_url": "/", "display": "standalone", "background_color": "#ffffff", "theme_color": "#000000", "icons": [ { "src": "icon-192.png", "sizes": "192x192", "type": "image/png" } ] } ``` This guide provides comprehensive coverage of IT Tools utility suite setup and usage for development and system administration tasks.
tonym commented 2025-09-29 02:17:26 +00:00
Author
Owner
Copy Link

Works! no config needed

http://192.168.0.5:8092/

Works! no config needed http://192.168.0.5:8092/
tonym closed this issue 2025-09-29 02:17:26 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
tonym
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tonym/NastyNAS#44
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?