Tutorial

Neue Updates und Verbesserungen zu Macfleet.

Wichtiger Hinweis

Die in diesen Tutorials bereitgestellten Codebeispiele und Skripte dienen nur zu Bildungszwecken. Macfleet ist nicht verantwortlich für Probleme, Schäden oder Sicherheitslücken, die durch die Verwendung, Änderung oder Implementierung dieser Beispiele entstehen können. Überprüfen und testen Sie Code immer in einer sicheren Umgebung, bevor Sie ihn in Produktionssystemen verwenden.

Hide and Unhide Files and Folders on macOS

Learn how to control the visibility of files and folders on Mac devices. Essential for protecting sensitive data, organizing workspaces, and managing system file access in enterprise environments.

Hide Specific Files or Folders

Hide individual files or folders from Finder view:

#!/bin/bash

# Configuration
TARGET_PATH="/Users/$(stat -f "%Su" /dev/console)/Desktop/sensitive-file.txt"

echo "Hiding file/folder: $TARGET_PATH"

# Hide the specified file or folder
if [[ -e "$TARGET_PATH" ]]; then
    chflags hidden "$TARGET_PATH"
    echo "✅ Successfully hidden: $TARGET_PATH"
else
    echo "❌ File/folder not found: $TARGET_PATH"
    exit 1
fi

Unhide Specific Files or Folders

Reveal previously hidden files or folders:

#!/bin/bash

# Configuration
TARGET_PATH="/Users/$(stat -f "%Su" /dev/console)/Desktop/sensitive-file.txt"

echo "Unhiding file/folder: $TARGET_PATH"

# Unhide the specified file or folder
if [[ -e "$TARGET_PATH" ]]; then
    chflags nohidden "$TARGET_PATH"
    echo "✅ Successfully unhidden: $TARGET_PATH"
else
    echo "❌ File/folder not found: $TARGET_PATH"
    exit 1
fi

Reveal All Hidden Files

Show all hidden files and folders in Finder (including system files):

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

echo "Revealing all hidden files for user: $CURRENT_USER"

# Enable showing all hidden files in Finder
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.finder AppleShowAllFiles -boolean true

# Restart Finder to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall Finder

echo "✅ All hidden files are now visible"
echo "⚠️  Hidden files appear faded in Finder"

Hide All Revealed Files

Hide all previously revealed hidden files and folders:

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

echo "Hiding all revealed hidden files for user: $CURRENT_USER"

# Disable showing hidden files in Finder
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.finder AppleShowAllFiles -boolean false

# Restart Finder to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall Finder

echo "✅ Hidden files are now concealed"
echo "🔒 System files are protected from view"

Bulk File Hide/Unhide Management

Script to manage multiple files and folders:

#!/bin/bash

# Function to hide multiple items
hide_multiple_items() {
    local items=("$@")
    local hidden_count=0
    
    echo "🔒 Hiding multiple files and folders..."
    
    for item in "${items[@]}"; do
        if [[ -e "$item" ]]; then
            chflags hidden "$item"
            echo "  ✅ Hidden: $item"
            ((hidden_count++))
        else
            echo "  ❌ Not found: $item"
        fi
    done
    
    echo "📊 Successfully hidden $hidden_count items"
}

# Function to unhide multiple items
unhide_multiple_items() {
    local items=("$@")
    local unhidden_count=0
    
    echo "👁️  Unhiding multiple files and folders..."
    
    for item in "${items[@]}"; do
        if [[ -e "$item" ]]; then
            chflags nohidden "$item"
            echo "  ✅ Unhidden: $item"
            ((unhidden_count++))
        else
            echo "  ❌ Not found: $item"
        fi
    done
    
    echo "📊 Successfully unhidden $unhidden_count items"
}

# Configuration - Add your file/folder paths here
CURRENT_USER=$(stat -f "%Su" /dev/console)
ITEMS_TO_MANAGE=(
    "/Users/$CURRENT_USER/Desktop/confidential"
    "/Users/$CURRENT_USER/Documents/private-notes.txt"
    "/Users/$CURRENT_USER/Desktop/temp-folder"
)

# Choose operation: hide or unhide
OPERATION="hide"  # Change to "unhide" to reveal items

case "$OPERATION" in
    "hide")
        hide_multiple_items "${ITEMS_TO_MANAGE[@]}"
        ;;
    "unhide")
        unhide_multiple_items "${ITEMS_TO_MANAGE[@]}"
        ;;
    *)
        echo "❌ Invalid operation. Use 'hide' or 'unhide'"
        exit 1
        ;;
esac

Enterprise File Visibility Management

Comprehensive script for enterprise file management:

#!/bin/bash

# Enterprise file visibility configuration
COMPANY_NAME="MacFleet"
POLICY_TYPE="security"  # Options: security, organization, compliance

# Define policy-specific file patterns
case "$POLICY_TYPE" in
    "security")
        HIDE_PATTERNS=(
            "*/confidential*"
            "*/private*"
            "*/.ssh*"
            "*/credentials*"
        )
        ;;
    "organization")
        HIDE_PATTERNS=(
            "*/temp*"
            "*/cache*"
            "*/.DS_Store"
            "*/thumbs.db"
        )
        ;;
    "compliance")
        HIDE_PATTERNS=(
            "*/audit*"
            "*/logs*"
            "*/backup*"
            "*/archive*"
        )
        ;;
esac

# Function to apply enterprise visibility policy
apply_enterprise_visibility_policy() {
    local current_user=$(stat -f "%Su" /dev/console)
    local current_user_uid=$(id -u "$current_user")
    
    echo "🏢 Applying Enterprise File Visibility Policy"
    echo "============================================="
    echo "Policy: $POLICY_TYPE"
    echo "Device: $(hostname)"
    echo "User: $current_user"
    echo "Timestamp: $(date)"
    
    local hidden_count=0
    
    # Process each pattern
    for pattern in "${HIDE_PATTERNS[@]}"; do
        echo "🔍 Processing pattern: $pattern"
        
        # Find files matching pattern in user directories
        while IFS= read -r -d '' file; do
            if [[ -e "$file" ]]; then
                chflags hidden "$file"
                echo "  🔒 Hidden: $file"
                ((hidden_count++))
            fi
        done < <(find "/Users/$current_user" -name "${pattern#*/}" -print0 2>/dev/null)
    done
    
    echo "✅ Enterprise visibility policy applied"
    echo "📊 Hidden $hidden_count items on $(hostname)"
}

# Execute enterprise policy
apply_enterprise_visibility_policy

Check File Visibility Status

Script to check if files or folders are hidden:

#!/bin/bash

# Function to check visibility status
check_visibility_status() {
    local target_path="$1"
    
    if [[ ! -e "$target_path" ]]; then
        echo "❌ File/folder does not exist: $target_path"
        return 1
    fi
    
    # Check hidden flag
    local flags=$(ls -lO "$target_path" 2>/dev/null | awk '{print $5}')
    
    if [[ "$flags" == *"hidden"* ]]; then
        echo "🔒 HIDDEN: $target_path"
    else
        echo "👁️  VISIBLE: $target_path"
    fi
}

# Function to scan directory for hidden items
scan_directory_visibility() {
    local scan_dir="$1"
    local hidden_count=0
    local visible_count=0
    
    echo "📊 Scanning directory: $scan_dir"
    echo "=================================="
    
    if [[ ! -d "$scan_dir" ]]; then
        echo "❌ Directory does not exist: $scan_dir"
        return 1
    fi
    
    # Scan all items in directory
    while IFS= read -r -d '' item; do
        local flags=$(ls -lO "$item" 2>/dev/null | awk '{print $5}')
        local basename_item=$(basename "$item")
        
        if [[ "$flags" == *"hidden"* ]]; then
            echo "  🔒 $basename_item (hidden)"
            ((hidden_count++))
        else
            echo "  👁️  $basename_item (visible)"
            ((visible_count++))
        fi
    done < <(find "$scan_dir" -maxdepth 1 -print0 2>/dev/null)
    
    echo ""
    echo "Summary:"
    echo "  Hidden items: $hidden_count"
    echo "  Visible items: $visible_count"
    echo "  Total items: $((hidden_count + visible_count))"
}

# Configuration
CURRENT_USER=$(stat -f "%Su" /dev/console)
CHECK_PATH="/Users/$CURRENT_USER/Desktop"

# Check specific file or scan directory
if [[ -f "$CHECK_PATH" ]]; then
    check_visibility_status "$CHECK_PATH"
elif [[ -d "$CHECK_PATH" ]]; then
    scan_directory_visibility "$CHECK_PATH"
else
    echo "❌ Path does not exist: $CHECK_PATH"
fi

Usage with MacFleet

  1. Configure target files/folders or patterns in script variables
  2. Choose between individual or bulk operations
  3. Deploy through MacFleet's remote script execution
  4. Verify visibility changes in Finder

Common Use Cases

ScenarioCommandPurpose
Hide sensitive filechflags hidden file.txtData protection
Hide temp folderchflags hidden temp/Workspace cleanup
Show system filesAppleShowAllFiles trueTroubleshooting
Hide system filesAppleShowAllFiles falseUser protection

File Visibility Levels

TypeVisibilityDescription
Normal filesAlways visibleStandard user files
Hidden filesInvisibleFiles hidden by chflags
System filesHidden by defaultmacOS system files
Dot filesHidden in FinderUnix-style hidden files

Important Notes

System files: Cannot unhide system files hidden by macOS default Persistence: Hidden flags persist across reboots and file moves Security: Hidden ≠ secure - files are still accessible via Terminal Finder restart: Required when changing AppleShowAllFiles setting

Troubleshooting

Permission denied: Ensure proper file ownership and permissions Finder not updating: Try killall Finder to force refresh Files still visible: Check if system-level hiding is required

Tutorial

Neue Updates und Verbesserungen zu Macfleet.

Konfiguration eines GitHub Actions Runners auf einem Mac Mini (Apple Silicon)

GitHub Actions Runner

GitHub Actions ist eine leistungsstarke CI/CD-Plattform, die es Ihnen ermöglicht, Ihre Software-Entwicklungsworkflows zu automatisieren. Während GitHub gehostete Runner anbietet, bieten selbst-gehostete Runner erhöhte Kontrolle und Anpassung für Ihr CI/CD-Setup. Dieses Tutorial führt Sie durch die Einrichtung, Konfiguration und Verbindung eines selbst-gehosteten Runners auf einem Mac mini zur Ausführung von macOS-Pipelines.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:

  • Einen Mac mini (registrieren Sie sich bei Macfleet)
  • Ein GitHub-Repository mit Administratorrechten
  • Einen installierten Paketmanager (vorzugsweise Homebrew)
  • Git auf Ihrem System installiert

Schritt 1: Ein dediziertes Benutzerkonto erstellen

Erstellen Sie zunächst ein dediziertes Benutzerkonto für den GitHub Actions Runner:

# Das 'gh-runner' Benutzerkonto erstellen
sudo dscl . -create /Users/gh-runner
sudo dscl . -create /Users/gh-runner UserShell /bin/bash
sudo dscl . -create /Users/gh-runner RealName "GitHub runner"
sudo dscl . -create /Users/gh-runner UniqueID "1001"
sudo dscl . -create /Users/gh-runner PrimaryGroupID 20
sudo dscl . -create /Users/gh-runner NFSHomeDirectory /Users/gh-runner

# Das Passwort für den Benutzer setzen
sudo dscl . -passwd /Users/gh-runner ihr_passwort

# 'gh-runner' zur 'admin'-Gruppe hinzufügen
sudo dscl . -append /Groups/admin GroupMembership gh-runner

Wechseln Sie zum neuen Benutzerkonto:

su gh-runner

Schritt 2: Erforderliche Software installieren

Installieren Sie Git und Rosetta 2 (wenn Sie Apple Silicon verwenden):

# Git installieren, falls noch nicht installiert
brew install git

# Rosetta 2 für Apple Silicon Macs installieren
softwareupdate --install-rosetta

Schritt 3: Den GitHub Actions Runner konfigurieren

  1. Gehen Sie zu Ihrem GitHub-Repository
  2. Navigieren Sie zu Einstellungen > Actions > Runners

GitHub Actions Runner

  1. Klicken Sie auf "New self-hosted runner" (https://github.com/<username>/<repository>/settings/actions/runners/new)
  2. Wählen Sie macOS als Runner-Image und ARM64 als Architektur
  3. Folgen Sie den bereitgestellten Befehlen, um den Runner herunterzuladen und zu konfigurieren

GitHub Actions Runner

Erstellen Sie eine .env-Datei im _work-Verzeichnis des Runners:

# _work/.env Datei
ImageOS=macos15
XCODE_15_DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
  1. Führen Sie das run.sh-Skript in Ihrem Runner-Verzeichnis aus, um die Einrichtung abzuschließen.
  2. Überprüfen Sie, dass der Runner aktiv ist und auf Jobs im Terminal wartet, und überprüfen Sie die GitHub-Repository-Einstellungen für die Runner-Zuordnung und den Idle-Status.

GitHub Actions Runner

Schritt 4: Sudoers konfigurieren (Optional)

Wenn Ihre Actions Root-Privilegien benötigen, konfigurieren Sie die sudoers-Datei:

sudo visudo

Fügen Sie die folgende Zeile hinzu:

gh-runner ALL=(ALL) NOPASSWD: ALL

Schritt 5: Den Runner in Workflows verwenden

Konfigurieren Sie Ihren GitHub Actions Workflow, um den selbst-gehosteten Runner zu verwenden:

name: Beispiel-Workflow

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: [self-hosted, macOS, ARM64]
    steps:
      - name: NodeJS installieren
        run: brew install node

Der Runner ist bei Ihrem Repository authentifiziert und mit self-hosted, macOS und ARM64 markiert. Verwenden Sie ihn in Ihren Workflows, indem Sie diese Labels im runs-on-Feld angeben:

runs-on: [self-hosted, macOS, ARM64]

Best Practices

  • Halten Sie Ihre Runner-Software auf dem neuesten Stand
  • Überwachen Sie regelmäßig Runner-Logs auf Probleme
  • Verwenden Sie spezifische Labels für verschiedene Runner-Typen
  • Implementieren Sie angemessene Sicherheitsmaßnahmen
  • Erwägen Sie die Verwendung mehrerer Runner für Lastverteilung

Fehlerbehebung

Häufige Probleme und Lösungen:

  1. Runner verbindet sich nicht:

    • Überprüfen Sie die Netzwerkverbindung
    • Überprüfen Sie die Gültigkeit des GitHub-Tokens
    • Stellen Sie angemessene Berechtigungen sicher
  2. Build-Fehler:

    • Überprüfen Sie die Xcode-Installation
    • Überprüfen Sie erforderliche Abhängigkeiten
    • Überprüfen Sie Workflow-Logs
  3. Berechtigungsprobleme:

    • Überprüfen Sie Benutzerberechtigungen
    • Überprüfen Sie sudoers-Konfiguration
    • Überprüfen Sie Dateisystem-Berechtigungen

Fazit

Sie haben jetzt einen selbst-gehosteten GitHub Actions Runner auf Ihrem Mac mini konfiguriert. Diese Einrichtung bietet Ihnen mehr Kontrolle über Ihre CI/CD-Umgebung und ermöglicht es Ihnen, macOS-spezifische Workflows effizient auszuführen.

Denken Sie daran, Ihren Runner regelmäßig zu warten und ihn mit den neuesten Sicherheitspatches und Software-Versionen auf dem neuesten Stand zu halten.

Native App

Macfleet native App

Macfleet Installationsanleitung

Macfleet ist eine leistungsstarke Flottenmanagement-Lösung, die speziell für Cloud-gehostete Mac Mini-Umgebungen entwickelt wurde. Als Mac Mini Cloud-Hosting-Anbieter können Sie Macfleet verwenden, um Ihre gesamte Flotte virtualisierter Mac-Instanzen zu überwachen, zu verwalten und zu optimieren.

Diese Installationsanleitung führt Sie durch die Einrichtung der Macfleet-Überwachung auf macOS-, Windows- und Linux-Systemen, um eine umfassende Übersicht über Ihre Cloud-Infrastruktur zu gewährleisten.

🍎 macOS

  • Laden Sie die .dmg-Datei für Mac hier herunter
  • Doppelklicken Sie auf die heruntergeladene .dmg-Datei
  • Ziehen Sie die Macfleet-App in den Anwendungsordner
  • Werfen Sie die .dmg-Datei aus
  • Öffnen Sie Systemeinstellungen > Sicherheit & Datenschutz
    • Datenschutz-Tab > Bedienungshilfen
    • Aktivieren Sie Macfleet, um Überwachung zu erlauben
  • Starten Sie Macfleet aus den Anwendungen
  • Die Verfolgung startet automatisch

🪟 Windows

  • Laden Sie die .exe-Datei für Windows hier herunter
  • Rechtsklick auf die .exe-Datei > "Als Administrator ausführen"
  • Folgen Sie dem Installationsassistenten
  • Akzeptieren Sie die Allgemeinen Geschäftsbedingungen
  • Erlauben Sie in Windows Defender, wenn aufgefordert
  • Gewähren Sie Anwendungsüberwachungsberechtigungen
  • Starten Sie Macfleet aus dem Startmenü
  • Die Anwendung beginnt automatisch mit der Verfolgung

🐧 Linux

  • Laden Sie das .deb-Paket (Ubuntu/Debian) oder .rpm (CentOS/RHEL) hier herunter
  • Installieren Sie mit Ihrem Paketmanager
    • Ubuntu/Debian: sudo dpkg -i Macfleet-linux.deb
    • CentOS/RHEL: sudo rpm -ivh Macfleet-linux.rpm
  • Erlauben Sie X11-Zugriffsberechtigungen, wenn aufgefordert
  • Fügen Sie den Benutzer zu entsprechenden Gruppen hinzu, falls erforderlich
  • Starten Sie Macfleet aus dem Anwendungsmenü
  • Die Anwendung beginnt automatisch mit der Verfolgung

Hinweis: Nach der Installation auf allen Systemen melden Sie sich mit Ihren Macfleet-Anmeldedaten an, um Daten mit Ihrem Dashboard zu synchronisieren.