Tutorial

Novas atualizações e melhorias para a Macfleet.

Aviso importante

Os exemplos de código e scripts fornecidos nestes tutoriais são apenas para fins educacionais. A Macfleet não é responsável por quaisquer problemas, danos ou vulnerabilidades de segurança que possam surgir do uso, modificação ou implementação destes exemplos. Sempre revise e teste o código em um ambiente seguro antes de usá-lo em sistemas de produção.

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

Novas atualizações e melhorias para a Macfleet.

Configurando um Runner do GitHub Actions em um Mac Mini (Apple Silicon)

Runner do GitHub Actions

GitHub Actions é uma plataforma poderosa de CI/CD que permite automatizar seus fluxos de trabalho de desenvolvimento de software. Embora o GitHub ofereça runners hospedados, runners auto-hospedados fornecem maior controle e personalização para sua configuração de CI/CD. Este tutorial o guia através da configuração e conexão de um runner auto-hospedado em um Mac mini para executar pipelines do macOS.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Um Mac mini (registre-se no Macfleet)
  • Um repositório GitHub com direitos de administrador
  • Um gerenciador de pacotes instalado (preferencialmente Homebrew)
  • Git instalado em seu sistema

Passo 1: Criar uma Conta de Usuário Dedicada

Primeiro, crie uma conta de usuário dedicada para o runner do GitHub Actions:

# Criar a conta de usuário 'gh-runner'
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

# Definir a senha para o usuário
sudo dscl . -passwd /Users/gh-runner sua_senha

# Adicionar 'gh-runner' ao grupo 'admin'
sudo dscl . -append /Groups/admin GroupMembership gh-runner

Mude para a nova conta de usuário:

su gh-runner

Passo 2: Instalar Software Necessário

Instale Git e Rosetta 2 (se estiver usando Apple Silicon):

# Instalar Git se ainda não estiver instalado
brew install git

# Instalar Rosetta 2 para Macs Apple Silicon
softwareupdate --install-rosetta

Passo 3: Configurar o Runner do GitHub Actions

  1. Vá para seu repositório GitHub
  2. Navegue para Configurações > Actions > Runners

Runner do GitHub Actions

  1. Clique em "New self-hosted runner" (https://github.com/<username>/<repository>/settings/actions/runners/new)
  2. Selecione macOS como imagem do runner e ARM64 como arquitetura
  3. Siga os comandos fornecidos para baixar e configurar o runner

Runner do GitHub Actions

Crie um arquivo .env no diretório _work do runner:

# arquivo _work/.env
ImageOS=macos15
XCODE_15_DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
  1. Execute o script run.sh em seu diretório do runner para completar a configuração.
  2. Verifique se o runner está ativo e ouvindo por trabalhos no terminal e verifique as configurações do repositório GitHub para a associação do runner e status Idle.

Runner do GitHub Actions

Passo 4: Configurar Sudoers (Opcional)

Se suas ações requerem privilégios de root, configure o arquivo sudoers:

sudo visudo

Adicione a seguinte linha:

gh-runner ALL=(ALL) NOPASSWD: ALL

Passo 5: Usar o Runner em Fluxos de Trabalho

Configure seu fluxo de trabalho do GitHub Actions para usar o runner auto-hospedado:

name: Fluxo de trabalho de exemplo

on:
  workflow_dispatch:

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

O runner está autenticado em seu repositório e rotulado com self-hosted, macOS, e ARM64. Use-o em seus fluxos de trabalho especificando estes rótulos no campo runs-on:

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

Melhores Práticas

  • Mantenha seu software do runner atualizado
  • Monitore regularmente os logs do runner para problemas
  • Use rótulos específicos para diferentes tipos de runners
  • Implemente medidas de segurança adequadas
  • Considere usar múltiplos runners para balanceamento de carga

Solução de Problemas

Problemas comuns e soluções:

  1. Runner não conectando:

    • Verifique conectividade de rede
    • Verifique validade do token GitHub
    • Certifique-se de permissões adequadas
  2. Falhas de build:

    • Verifique instalação do Xcode
    • Verifique dependências necessárias
    • Revise logs do fluxo de trabalho
  3. Problemas de permissão:

    • Verifique permissões do usuário
    • Verifique configuração sudoers
    • Revise permissões do sistema de arquivos

Conclusão

Agora você tem um runner auto-hospedado do GitHub Actions configurado em seu Mac mini. Esta configuração fornece mais controle sobre seu ambiente CI/CD e permite executar fluxos de trabalho específicos do macOS de forma eficiente.

Lembre-se de manter regularmente seu runner e mantê-lo atualizado com os patches de segurança e versões de software mais recentes.

Aplicativo Nativo

Aplicativo nativo do Macfleet

Guia de Instalação do Macfleet

Macfleet é uma solução poderosa de gerenciamento de frota projetada especificamente para ambientes Mac Mini hospedados na nuvem. Como provedor de hospedagem na nuvem Mac Mini, você pode usar o Macfleet para monitorar, gerenciar e otimizar toda sua frota de instâncias Mac virtualizadas.

Este guia de instalação o conduzirá através da configuração do monitoramento do Macfleet em sistemas macOS, Windows e Linux para garantir supervisão abrangente de sua infraestrutura na nuvem.

🍎 macOS

  • Baixe o arquivo .dmg para Mac aqui
  • Clique duas vezes no arquivo .dmg baixado
  • Arraste o aplicativo Macfleet para a pasta Aplicativos
  • Ejete o arquivo .dmg
  • Abra Preferências do Sistema > Segurança e Privacidade
    • Aba Privacidade > Acessibilidade
    • Marque Macfleet para permitir monitoramento
  • Inicie o Macfleet a partir de Aplicativos
  • O rastreamento inicia automaticamente

🪟 Windows

  • Baixe o arquivo .exe para Windows aqui
  • Clique com o botão direito no arquivo .exe > "Executar como administrador"
  • Siga o assistente de instalação
  • Aceite os termos e condições
  • Permita no Windows Defender se solicitado
  • Conceda permissões de monitoramento de aplicativo
  • Inicie o Macfleet a partir do Menu Iniciar
  • O aplicativo começa o rastreamento automaticamente

🐧 Linux

  • Baixe o pacote .deb (Ubuntu/Debian) ou .rpm (CentOS/RHEL) aqui
  • Instale usando seu gerenciador de pacotes
    • Ubuntu/Debian: sudo dpkg -i Macfleet-linux.deb
    • CentOS/RHEL: sudo rpm -ivh Macfleet-linux.rpm
  • Permita permissões de acesso X11 se solicitado
  • Adicione o usuário aos grupos apropriados se necessário
  • Inicie o Macfleet a partir do menu Aplicativos
  • O aplicativo começa o rastreamento automaticamente

Nota: Após a instalação em todos os sistemas, faça login com suas credenciais do Macfleet para sincronizar dados com seu painel de controle.