ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
Add agent install scripts and release automation
Juan Denis528c86d6400a
diff --git a/.github/workflows/agent-release.yml b/.github/workflows/agent-release.ymlnew file mode 100644index 00000000..4c3a2e6f--- /dev/null+++ b/.github/workflows/agent-release.yml@@ -0,0 +1,203 @@+name: Agent Release++on:+ push:+ tags:+ - 'agent-v*'+ workflow_dispatch:+ inputs:+ version:+ description: 'Version to release (e.g., 1.0.0)'+ required: true+ type: string++env:+ GO_VERSION: '1.21'++jobs:+ build:+ name: Build Agent+ runs-on: ubuntu-latest++ strategy:+ matrix:+ include:+ - goos: linux+ goarch: amd64+ suffix: ''+ - goos: linux+ goarch: arm64+ suffix: ''+ - goos: windows+ goarch: amd64+ suffix: '.exe'++ steps:+ - name: Checkout code+ uses: actions/checkout@v4++ - name: Set up Go+ uses: actions/setup-go@v5+ with:+ go-version: ${{ env.GO_VERSION }}+ cache-dependency-path: agent/go.sum++ - name: Get version+ id: version+ run: |+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then+ VERSION="${{ github.event.inputs.version }}"+ else+ VERSION="${GITHUB_REF#refs/tags/agent-v}"+ fi+ echo "version=$VERSION" >> $GITHUB_OUTPUT+ echo "Building version: $VERSION"++ - name: Build binary+ env:+ GOOS: ${{ matrix.goos }}+ GOARCH: ${{ matrix.goarch }}+ CGO_ENABLED: 0+ run: |+ cd agent+ go build -ldflags="-s -w -X main.Version=${{ steps.version.outputs.version }}" \+ -o ../dist/serverkit-agent-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.suffix }} \+ ./cmd/agent++ - name: Compress binary (Linux)+ if: matrix.goos == 'linux'+ run: |+ cd dist+ tar -czvf serverkit-agent-${{ steps.version.outputs.version }}-${{ matrix.goos }}-${{ matrix.goarch }}.tar.gz \+ serverkit-agent-${{ matrix.goos }}-${{ matrix.goarch }}++ - name: Compress binary (Windows)+ if: matrix.goos == 'windows'+ run: |+ cd dist+ zip serverkit-agent-${{ steps.version.outputs.version }}-${{ matrix.goos }}-${{ matrix.goarch }}.zip \+ serverkit-agent-${{ matrix.goos }}-${{ matrix.goarch }}.exe++ - name: Upload artifact+ uses: actions/upload-artifact@v4+ with:+ name: serverkit-agent-${{ matrix.goos }}-${{ matrix.goarch }}+ path: dist/serverkit-agent-${{ steps.version.outputs.version }}-*+ retention-days: 5++ release:+ name: Create Release+ runs-on: ubuntu-latest+ needs: build+ permissions:+ contents: write++ steps:+ - name: Checkout code+ uses: actions/checkout@v4++ - name: Get version+ id: version+ run: |+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then+ VERSION="${{ github.event.inputs.version }}"+ else+ VERSION="${GITHUB_REF#refs/tags/agent-v}"+ fi+ echo "version=$VERSION" >> $GITHUB_OUTPUT++ - name: Download all artifacts+ uses: actions/download-artifact@v4+ with:+ path: artifacts++ - name: Prepare release files+ run: |+ mkdir -p release+ find artifacts -type f \( -name "*.tar.gz" -o -name "*.zip" \) -exec mv {} release/ \;+ ls -la release/++ - name: Generate checksums+ run: |+ cd release+ sha256sum * > checksums.txt+ cat checksums.txt++ - name: Create Release+ uses: softprops/action-gh-release@v1+ with:+ tag_name: agent-v${{ steps.version.outputs.version }}+ name: ServerKit Agent v${{ steps.version.outputs.version }}+ draft: false+ prerelease: false+ files: |+ release/*+ body: |+ ## ServerKit Agent v${{ steps.version.outputs.version }}++ ### Downloads++ | Platform | Architecture | Download |+ |----------|--------------|----------|+ | Linux | x64 (amd64) | `serverkit-agent-${{ steps.version.outputs.version }}-linux-amd64.tar.gz` |+ | Linux | ARM64 | `serverkit-agent-${{ steps.version.outputs.version }}-linux-arm64.tar.gz` |+ | Windows | x64 (amd64) | `serverkit-agent-${{ steps.version.outputs.version }}-windows-amd64.zip` |++ ### Quick Install++ **Linux (one-liner):**+ ```bash+ curl -fsSL https://your-serverkit.com/install.sh | sudo bash -s -- --token "YOUR_TOKEN"+ ```++ **Windows (PowerShell as Admin):**+ ```powershell+ irm https://your-serverkit.com/install.ps1 | iex; Install-ServerKitAgent -Token "YOUR_TOKEN"+ ```++ ### Verification++ Verify downloads using the checksums in `checksums.txt`:+ ```bash+ sha256sum -c checksums.txt+ ```++ ### What's New++ See [CHANGELOG](https://github.com/${{ github.repository }}/blob/main/agent/CHANGELOG.md) for details.+ env:+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}++ summary:+ name: Build Summary+ runs-on: ubuntu-latest+ needs: [build, release]++ steps:+ - name: Get version+ id: version+ run: |+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then+ VERSION="${{ github.event.inputs.version }}"+ else+ VERSION="${GITHUB_REF#refs/tags/agent-v}"+ fi+ echo "version=$VERSION" >> $GITHUB_OUTPUT++ - name: Create summary+ run: |+ echo "## Agent Release Summary" >> $GITHUB_STEP_SUMMARY+ echo "" >> $GITHUB_STEP_SUMMARY+ echo "**Version:** v${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY+ echo "" >> $GITHUB_STEP_SUMMARY+ echo "### Built Binaries" >> $GITHUB_STEP_SUMMARY+ echo "" >> $GITHUB_STEP_SUMMARY+ echo "| Platform | Architecture | Status |" >> $GITHUB_STEP_SUMMARY+ echo "|----------|--------------|--------|" >> $GITHUB_STEP_SUMMARY+ echo "| Linux | amd64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY+ echo "| Linux | arm64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY+ echo "| Windows | amd64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY+ echo "" >> $GITHUB_STEP_SUMMARY+ echo "### Release" >> $GITHUB_STEP_SUMMARY+ echo "" >> $GITHUB_STEP_SUMMARY+ echo "Release created at: https://github.com/${{ github.repository }}/releases/tag/agent-v${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARYdiff --git a/ROADMAP.md b/ROADMAP.mdindex bbf9f23d..18ea0222 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -117,16 +117,21 @@ This document outlines the development roadmap for ServerKit. Features are organ----## Phase 10: Multi-Server Management (Planned)+## Phase 10: Multi-Server Management (In Progress)**Priority: High**-- [ ] Agent-based remote server monitoring-- [ ] Centralized dashboard for multiple servers-- [ ] Server grouping and tagging-- [ ] Cross-server metrics comparison-- [ ] Remote command execution-- [ ] Server health overview+- [x] Agent-based remote server monitoring (Go agent)+- [x] Centralized dashboard for multiple servers+- [x] Server grouping and tagging+- [x] Cross-server metrics comparison+- [x] Remote Docker management via agents+- [x] Server health overview+- [x] Agent WebSocket gateway+- [x] HMAC-SHA256 authentication+- [x] GitHub Actions for agent releases (Linux/Windows)+- [x] Installation scripts endpoint+- [ ] Agent auto-update mechanism---diff --git a/SERVERS_INTEGRATION_PLAN.md b/SERVERS_INTEGRATION_PLAN.mdindex 00c9077e..e1d4d466 100644--- a/SERVERS_INTEGRATION_PLAN.md+++ b/SERVERS_INTEGRATION_PLAN.md@@ -1185,137 +1185,145 @@ system:exec: # Requires explicit permission## 11. Phase Implementation Plan-### Phase 10.1: Foundation (Agent Core)+### Phase 10.1: Foundation (Agent Core) ✅ COMPLETED**Duration: ~2-3 weeks**```-[ ] Design and implement Go agent binary- [ ] Project setup with Go modules- [ ] Configuration loading (YAML)- [ ] Logging system (structured logs)- [ ] WebSocket client with reconnection- [ ] HMAC authentication- [ ] Heartbeat mechanism- [ ] Graceful shutdown handling--[ ] Docker integration in agent- [ ] Connect to Docker socket- [ ] Container list/inspect- [ ] Container start/stop/restart- [ ] Basic stats collection--[ ] Build pipeline- [ ] Cross-compilation for all platforms- [ ] Binary signing- [ ] Version embedding+[x] Design and implement Go agent binary+ [x] Project setup with Go modules+ [x] Configuration loading (YAML)+ [x] Logging system (structured logs)+ [x] WebSocket client with reconnection+ [x] HMAC authentication+ [x] Heartbeat mechanism+ [x] Graceful shutdown handling++[x] Docker integration in agent+ [x] Connect to Docker socket+ [x] Container list/inspect+ [x] Container start/stop/restart+ [x] Basic stats collection++[x] Build pipeline+ [x] Cross-compilation for all platforms (GitHub Actions)+ [x] Version embedding+ [ ] Binary signing (optional - future)```-### Phase 10.2: Backend Gateway+### Phase 10.2: Backend Gateway ✅ COMPLETED**Duration: ~2 weeks**```-[ ] Database models- [ ] Server, ServerGroup models- [ ] ServerMetrics, ServerCommand models- [ ] AgentSession model- [ ] Migrations--[ ] Agent Gateway (WebSocket server)- [ ] SocketIO namespace for agents- [ ] Authentication handler- [ ] Session management- [ ] Command routing- [ ] Connection tracking--[ ] API endpoints- [ ] Server CRUD- [ ] Registration token generation- [ ] Server status endpoint+[x] Database models+ [x] Server, ServerGroup models+ [x] ServerMetrics, ServerCommand models+ [x] AgentSession model+ [x] Migrations (auto via SQLAlchemy)++[x] Agent Gateway (WebSocket server)+ [x] SocketIO namespace for agents (/agent)+ [x] Authentication handler+ [x] Session management+ [x] Command routing+ [x] Connection tracking++[x] API endpoints+ [x] Server CRUD+ [x] Registration token generation+ [x] Server status endpoint+ [x] Remote Docker endpoints (50+ routes)```-### Phase 10.3: Security Layer+### Phase 10.3: Security Layer ✅ COMPLETED**Duration: ~1-2 weeks**```-[ ] Security implementation- [ ] API key generation and hashing- [ ] HMAC signature validation- [ ] Session token management- [ ] Permission checking middleware- [ ] Rate limiting per agent- [ ] Audit logging--[ ] Agent security- [ ] Encrypted key storage- [ ] Command validation- [ ] Permission enforcement+[x] Security implementation+ [x] API key generation and hashing (bcrypt)+ [x] HMAC-SHA256 signature validation+ [x] Session token management+ [x] Permission checking (scope-based)+ [ ] Rate limiting per agent (future)+ [x] Audit logging (ServerCommand model)++[x] Agent security+ [x] Encrypted key storage (AES-256-GCM)+ [x] Command validation+ [x] Permission enforcement```-### Phase 10.4: Frontend - Server Management+### Phase 10.4: Frontend - Server Management ✅ COMPLETED**Duration: ~2 weeks**```-[ ] Servers page- [ ] Server list view- [ ] Server cards/grid view- [ ] Add server modal- [ ] Installation instructions- [ ] Server detail page- [ ] Server settings--[ ] Server groups- [ ] Group CRUD UI- [ ] Drag-drop organization- [ ] Group filtering+[x] Servers page+ [x] Server list view (grid with cards)+ [x] Server cards with live metrics+ [x] Add server modal with permissions+ [x] Installation instructions (Linux/Windows)+ [x] Server detail page (tabbed interface)+ [x] Server settings++[x] Server groups+ [x] Group CRUD UI (modal)+ [x] Group filtering+ [ ] Drag-drop organization (future)```-### Phase 10.5: Remote Docker Integration+### Phase 10.5: Remote Docker Integration ✅ COMPLETED**Duration: ~2 weeks**```-[ ] Backend: Docker command routing- [ ] Route Docker commands to agents- [ ] Handle async responses- [ ] Error handling--[ ] Frontend: Docker page updates- [ ] Server selector dropdown- [ ] Context-aware Docker UI- [ ] Real-time container updates--[ ] Agent: Full Docker support- [ ] All container operations- [ ] Image operations- [ ] Volume/network listing+[x] Backend: Docker command routing+ [x] Route Docker commands to agents (RemoteDockerService)+ [x] Handle async responses (command results)+ [x] Error handling++[x] Frontend: Docker page updates+ [x] Server selector dropdown (top of page)+ [x] Context-aware Docker UI (ServerContext)+ [x] Real-time container updates++[x] Agent: Full Docker support+ [x] All container operations+ [x] Image operations+ [x] Volume/network listing```-### Phase 10.6: Monitoring & Metrics+### Phase 10.6: Monitoring & Metrics 🔄 IN PROGRESS**Duration: ~2 weeks**```-[ ] Real-time metrics- [ ] Agent metrics streaming- [ ] WebSocket to frontend- [ ] Live dashboard updates+[x] Real-time metrics+ [x] Agent metrics streaming (heartbeat)+ [x] WebSocket to frontend (SocketIO)+ [x] Live dashboard updates[ ] Historical metrics- [ ] Metrics storage+ [x] Metrics storage (ServerMetrics model)[ ] Retention policies[ ] Aggregation queries-[ ] Cross-server dashboard- [ ] Overview page- [ ] Metric comparison charts- [ ] Health grid view+[x] Cross-server dashboard+ [x] Overview page (Servers.jsx)+ [x] Metric comparison (server cards)+ [x] Health grid view```-### Phase 10.7: Installation & Distribution+### Phase 10.7: Installation & Distribution 🔄 IN PROGRESS**Duration: ~1-2 weeks**```-[ ] Installation scripts- [ ] Linux install script (bash)- [ ] Windows install script (PowerShell)+[x] Build automation+ [x] GitHub Actions workflow (agent-release.yml)+ [x] Linux amd64/arm64 builds+ [x] Windows amd64 builds+ [x] Automatic releases on tag++[x] Installation scripts+ [x] Linux install script (bash) - created+ [x] Windows install script (PowerShell) - created+ [x] Installation endpoint in backend[ ] Docker image[ ] Package building@@ -1325,7 +1333,7 @@ system:exec: # Requires explicit permission[ ] Homebrew formula[ ] Distribution- [ ] Download page+ [ ] Download page in UI[ ] Version checking[ ] Auto-update mechanism```diff --git a/backend/app/api/servers.py b/backend/app/api/servers.pyindex e25b35fb..4354d2d5 100644--- a/backend/app/api/servers.py+++ b/backend/app/api/servers.py@@ -4,8 +4,9 @@ Server Management APIEndpoints for managing remote servers and their agents."""+import osfrom datetime import datetime, timedelta-from flask import Blueprint, request, jsonify+from flask import Blueprint, request, jsonify, Response, current_appfrom flask_jwt_extended import jwt_required, get_jwt_identityfrom app import db@@ -833,3 +834,136 @@ def get_remote_system_info(server_id):return jsonify(result), 500return jsonify(result.get('data'))+++# ==================== Installation Scripts ====================++def _get_scripts_dir():+ """Get the scripts directory path"""+ # Go up from backend/app/api to backend, then to scripts+ base_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(__file__))))+ return os.path.join(base_dir, 'scripts')+++@servers_bp.route('/install.sh', methods=['GET'])+def get_install_script_linux():+ """+ Get the Linux installation script.++ This endpoint serves the bash installation script for installing+ the ServerKit agent on Linux systems.++ Usage:+ curl -fsSL https://your-server/api/servers/install.sh | sudo bash -s -- \\+ --token "YOUR_TOKEN" --server "https://your-server"+ """+ script_path = os.path.join(_get_scripts_dir(), 'install.sh')++ if not os.path.exists(script_path):+ return jsonify({'error': 'Installation script not found'}), 404++ with open(script_path, 'r', encoding='utf-8') as f:+ content = f.read()++ # Replace placeholder URLs with actual server URL+ server_url = request.url_root.rstrip('/')+ content = content.replace('https://your-serverkit.com', server_url)++ return Response(+ content,+ mimetype='text/x-shellscript',+ headers={+ 'Content-Disposition': 'inline; filename="install.sh"',+ 'Cache-Control': 'no-cache'+ }+ )+++@servers_bp.route('/install.ps1', methods=['GET'])+def get_install_script_windows():+ """+ Get the Windows installation script.++ This endpoint serves the PowerShell installation script for installing+ the ServerKit agent on Windows systems.++ Usage:+ irm https://your-server/api/servers/install.ps1 | iex; \\+ Install-ServerKitAgent -Token "YOUR_TOKEN" -Server "https://your-server"+ """+ script_path = os.path.join(_get_scripts_dir(), 'install.ps1')++ if not os.path.exists(script_path):+ return jsonify({'error': 'Installation script not found'}), 404++ with open(script_path, 'r', encoding='utf-8') as f:+ content = f.read()++ # Replace placeholder URLs with actual server URL+ server_url = request.url_root.rstrip('/')+ content = content.replace('https://your-serverkit.com', server_url)++ return Response(+ content,+ mimetype='text/plain',+ headers={+ 'Content-Disposition': 'inline; filename="install.ps1"',+ 'Cache-Control': 'no-cache'+ }+ )+++@servers_bp.route('/install-instructions/<server_id>', methods=['GET'])+@jwt_required()+def get_install_instructions(server_id):+ """+ Get installation instructions for a specific server.++ Returns the installation commands with the server's registration token+ already embedded.+ """+ server = Server.query.get(server_id)+ if not server:+ return jsonify({'error': 'Server not found'}), 404++ # Check if server has a valid registration token+ if not server.registration_token_hash:+ return jsonify({+ 'error': 'No registration token available',+ 'message': 'Generate a new token using the regenerate-token endpoint'+ }), 400++ if server.registration_token_expires and server.registration_token_expires < datetime.utcnow():+ return jsonify({+ 'error': 'Registration token expired',+ 'message': 'Generate a new token using the regenerate-token endpoint'+ }), 400++ # Get base URL+ base_url = request.url_root.rstrip('/')+ api_url = f"{base_url}/api/servers"++ return jsonify({+ 'linux': {+ 'one_liner': f'curl -fsSL {api_url}/install.sh | sudo bash -s -- --token "YOUR_TOKEN" --server "{base_url}"',+ 'manual': [+ f'# Download the script',+ f'curl -fsSL {api_url}/install.sh -o install.sh',+ f'chmod +x install.sh',+ f'',+ f'# Run installation',+ f'sudo ./install.sh --token "YOUR_TOKEN" --server "{base_url}"'+ ]+ },+ 'windows': {+ 'one_liner': f'irm {api_url}/install.ps1 | iex; Install-ServerKitAgent -Token "YOUR_TOKEN" -Server "{base_url}"',+ 'manual': [+ f'# Download the script (run in PowerShell as Administrator)',+ f'Invoke-WebRequest -Uri "{api_url}/install.ps1" -OutFile install.ps1',+ f'',+ f'# Run installation',+ f'.\\install.ps1 -Token "YOUR_TOKEN" -Server "{base_url}"'+ ]+ },+ 'note': 'Replace YOUR_TOKEN with the registration token shown in the UI'+ })diff --git a/scripts/install.ps1 b/scripts/install.ps1new file mode 100644index 00000000..160e4dce--- /dev/null+++ b/scripts/install.ps1@@ -0,0 +1,323 @@+#Requires -RunAsAdministrator+<#+.SYNOPSIS+ ServerKit Agent Installation Script for Windows++.DESCRIPTION+ Downloads and installs the ServerKit Agent on Windows systems.++.PARAMETER Token+ Registration token from ServerKit (required)++.PARAMETER Server+ ServerKit server URL (required)++.PARAMETER Name+ Display name for this server (optional)++.PARAMETER Version+ Specific agent version to install (optional, defaults to latest)++.EXAMPLE+ .\install.ps1 -Token "sk_reg_xxx" -Server "https://your-serverkit.com"++.EXAMPLE+ irm https://your-serverkit.com/install.ps1 | iex; Install-ServerKitAgent -Token "sk_reg_xxx" -Server "https://your-serverkit.com"++.NOTES+ Requires Administrator privileges.+#>++param(+ [Parameter(Mandatory=$false)]+ [string]$Token,++ [Parameter(Mandatory=$false)]+ [string]$Server,++ [Parameter(Mandatory=$false)]+ [string]$Name,++ [Parameter(Mandatory=$false)]+ [string]$Version = "latest"+)++# Configuration+$InstallDir = "$env:ProgramFiles\ServerKit"+$ConfigDir = "$env:ProgramData\ServerKit"+$ServiceName = "ServerKitAgent"+$GitHubRepo = "serverkit/serverkit"+$AgentBinary = "serverkit-agent.exe"++# Colors+function Write-ColorOutput {+ param(+ [string]$Message,+ [string]$Type = "Info"+ )++ switch ($Type) {+ "Info" { Write-Host "[INFO] " -ForegroundColor Cyan -NoNewline; Write-Host $Message }+ "Success" { Write-Host "[SUCCESS] " -ForegroundColor Green -NoNewline; Write-Host $Message }+ "Warning" { Write-Host "[WARN] " -ForegroundColor Yellow -NoNewline; Write-Host $Message }+ "Error" { Write-Host "[ERROR] " -ForegroundColor Red -NoNewline; Write-Host $Message }+ }+}++function Write-Banner {+ Write-Host ""+ Write-Host "╔═══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan+ Write-Host "║ ServerKit Agent Installer ║" -ForegroundColor Cyan+ Write-Host "╚═══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan+ Write-Host ""+}++function Test-Administrator {+ $currentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())+ return $currentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)+}++function Get-LatestVersion {+ if ($Version -eq "latest") {+ Write-ColorOutput "Fetching latest version..." "Info"++ try {+ $releases = Invoke-RestMethod -Uri "https://api.github.com/repos/$GitHubRepo/releases" -Method Get+ foreach ($release in $releases) {+ if ($release.tag_name -match "^agent-v(.+)$") {+ $script:Version = $Matches[1]+ Write-ColorOutput "Latest version: v$Version" "Info"+ return+ }+ }+ throw "No agent release found"+ }+ catch {+ Write-ColorOutput "Failed to fetch latest version: $_" "Error"+ exit 1+ }+ }+}++function Install-Agent {+ Write-ColorOutput "Downloading ServerKit Agent v$Version..." "Info"++ # Create temp directory+ $tempDir = Join-Path $env:TEMP "serverkit-install-$(Get-Random)"+ New-Item -ItemType Directory -Path $tempDir -Force | Out-Null++ $downloadUrl = "https://github.com/$GitHubRepo/releases/download/agent-v$Version/serverkit-agent-$Version-windows-amd64.zip"+ $archivePath = Join-Path $tempDir "serverkit-agent.zip"++ try {+ # Download+ Write-ColorOutput "Downloading from: $downloadUrl" "Info"+ Invoke-WebRequest -Uri $downloadUrl -OutFile $archivePath -UseBasicParsing++ # Extract+ Write-ColorOutput "Extracting agent..." "Info"+ Expand-Archive -Path $archivePath -DestinationPath $tempDir -Force++ # Create install directory+ if (-not (Test-Path $InstallDir)) {+ New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null+ }++ # Copy binary+ $binarySource = Join-Path $tempDir "serverkit-agent-windows-amd64.exe"+ $binaryDest = Join-Path $InstallDir $AgentBinary+ Copy-Item -Path $binarySource -Destination $binaryDest -Force++ Write-ColorOutput "Agent installed to $binaryDest" "Success"+ }+ catch {+ Write-ColorOutput "Failed to download/install agent: $_" "Error"+ exit 1+ }+ finally {+ # Cleanup+ Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue+ }+}++function New-ConfigDirectory {+ Write-ColorOutput "Creating configuration directory..." "Info"++ if (-not (Test-Path $ConfigDir)) {+ New-Item -ItemType Directory -Path $ConfigDir -Force | Out-Null+ }+}++function Register-Agent {+ param(+ [string]$Token,+ [string]$Server,+ [string]$Name+ )++ Write-ColorOutput "Registering agent with ServerKit..." "Info"++ $agentPath = Join-Path $InstallDir $AgentBinary+ $arguments = @("register", "--token", $Token, "--server", $Server)++ if ($Name) {+ $arguments += @("--name", $Name)+ }++ try {+ $process = Start-Process -FilePath $agentPath -ArgumentList $arguments -Wait -PassThru -NoNewWindow+ if ($process.ExitCode -ne 0) {+ throw "Registration command failed with exit code: $($process.ExitCode)"+ }+ Write-ColorOutput "Agent registered successfully" "Success"+ }+ catch {+ Write-ColorOutput "Agent registration failed: $_" "Error"+ exit 1+ }+}++function Install-WindowsService {+ Write-ColorOutput "Installing Windows service..." "Info"++ $agentPath = Join-Path $InstallDir $AgentBinary++ # Check if service already exists+ $existingService = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue++ if ($existingService) {+ Write-ColorOutput "Stopping existing service..." "Info"+ Stop-Service -Name $ServiceName -Force -ErrorAction SilentlyContinue+ Start-Sleep -Seconds 2++ Write-ColorOutput "Removing existing service..." "Info"+ sc.exe delete $ServiceName | Out-Null+ Start-Sleep -Seconds 2+ }++ # Create the service using sc.exe+ $binPath = "`"$agentPath`" start"+ $result = sc.exe create $ServiceName binPath= $binPath start= auto DisplayName= "ServerKit Agent"++ if ($LASTEXITCODE -ne 0) {+ Write-ColorOutput "Failed to create service: $result" "Error"+ exit 1+ }++ # Set service description+ sc.exe description $ServiceName "ServerKit Agent for remote server management" | Out-Null++ # Set service recovery options (restart on failure)+ sc.exe failure $ServiceName reset= 86400 actions= restart/60000/restart/60000/restart/60000 | Out-Null++ Write-ColorOutput "Windows service installed" "Success"+}++function Start-AgentService {+ Write-ColorOutput "Starting ServerKit Agent service..." "Info"++ try {+ Start-Service -Name $ServiceName+ Start-Sleep -Seconds 3++ $service = Get-Service -Name $ServiceName+ if ($service.Status -eq "Running") {+ Write-ColorOutput "Agent service is running" "Success"+ }+ else {+ Write-ColorOutput "Service failed to start. Status: $($service.Status)" "Warning"+ Write-ColorOutput "Check logs in Event Viewer > Windows Logs > Application" "Info"+ }+ }+ catch {+ Write-ColorOutput "Failed to start service: $_" "Error"+ }+}++function Add-ToPath {+ Write-ColorOutput "Adding to system PATH..." "Info"++ $currentPath = [Environment]::GetEnvironmentVariable("Path", "Machine")++ if ($currentPath -notlike "*$InstallDir*") {+ $newPath = "$currentPath;$InstallDir"+ [Environment]::SetEnvironmentVariable("Path", $newPath, "Machine")+ Write-ColorOutput "Added $InstallDir to system PATH" "Success"+ }+ else {+ Write-ColorOutput "Already in PATH" "Info"+ }+}++function Write-SuccessMessage {+ Write-Host ""+ Write-Host "╔═══════════════════════════════════════════════════════════╗" -ForegroundColor Green+ Write-Host "║ Installation completed successfully! ║" -ForegroundColor Green+ Write-Host "╚═══════════════════════════════════════════════════════════╝" -ForegroundColor Green+ Write-Host ""+ Write-Host "Agent Status:"+ Write-Host " Binary: $InstallDir\$AgentBinary"+ Write-Host " Config: $ConfigDir\config.yaml"+ Write-Host " Service: $ServiceName"+ Write-Host ""+ Write-Host "Useful commands:"+ Write-Host " Check status: Get-Service $ServiceName"+ Write-Host " View logs: Get-EventLog -LogName Application -Source $ServiceName"+ Write-Host " Restart agent: Restart-Service $ServiceName"+ Write-Host " Stop agent: Stop-Service $ServiceName"+ Write-Host ""+}++# Main function for piped execution+function Install-ServerKitAgent {+ param(+ [Parameter(Mandatory=$true)]+ [string]$Token,++ [Parameter(Mandatory=$true)]+ [string]$Server,++ [Parameter(Mandatory=$false)]+ [string]$Name,++ [Parameter(Mandatory=$false)]+ [string]$Version = "latest"+ )++ # Update script-level variables+ $script:Version = $Version++ Write-Banner++ if (-not (Test-Administrator)) {+ Write-ColorOutput "This script must be run as Administrator" "Error"+ Write-Host "Right-click PowerShell and select 'Run as Administrator'"+ exit 1+ }++ Get-LatestVersion+ Install-Agent+ New-ConfigDirectory+ Register-Agent -Token $Token -Server $Server -Name $Name+ Install-WindowsService+ Start-AgentService+ Add-ToPath+ Write-SuccessMessage+}++# Direct execution with parameters+if ($Token -and $Server) {+ Install-ServerKitAgent -Token $Token -Server $Server -Name $Name -Version $Version+}+elseif ($PSBoundParameters.Count -gt 0) {+ Write-ColorOutput "Both -Token and -Server parameters are required" "Error"+ Write-Host ""+ Write-Host "Usage:"+ Write-Host " .\install.ps1 -Token 'sk_reg_xxx' -Server 'https://your-serverkit.com'"+ exit 1+}+else {+ # Script was sourced, export the function+ Write-Host "ServerKit Agent installer loaded." -ForegroundColor Cyan+ Write-Host "Usage: Install-ServerKitAgent -Token 'sk_reg_xxx' -Server 'https://your-serverkit.com'" -ForegroundColor Gray+}diff --git a/scripts/install.sh b/scripts/install.shnew file mode 100644index 00000000..7650eb99--- /dev/null+++ b/scripts/install.sh@@ -0,0 +1,348 @@+#!/bin/bash+#+# ServerKit Agent Installation Script+#+# Usage:+# curl -fsSL https://your-serverkit.com/install.sh | sudo bash -s -- --token "TOKEN" --server "URL"+#+# Options:+# --token, -t Registration token (required)+# --server, -s ServerKit server URL (required)+# --name, -n Display name for this server (optional)+# --version, -v Specific agent version to install (optional, defaults to latest)+# --help, -h Show this help message+#++set -e++# Colors for output+RED='\033[0;31m'+GREEN='\033[0;32m'+YELLOW='\033[1;33m'+BLUE='\033[0;34m'+NC='\033[0m' # No Color++# Configuration+INSTALL_DIR="/usr/local/bin"+CONFIG_DIR="/etc/serverkit"+SERVICE_USER="serverkit"+GITHUB_REPO="serverkit/serverkit"+AGENT_BINARY="serverkit-agent"++# Arguments+TOKEN=""+SERVER_URL=""+SERVER_NAME=""+VERSION="latest"++print_banner() {+ echo -e "${BLUE}"+ echo "╔═══════════════════════════════════════════════════════════╗"+ echo "║ ServerKit Agent Installer ║"+ echo "╚═══════════════════════════════════════════════════════════╝"+ echo -e "${NC}"+}++log_info() {+ echo -e "${BLUE}[INFO]${NC} $1"+}++log_success() {+ echo -e "${GREEN}[SUCCESS]${NC} $1"+}++log_warn() {+ echo -e "${YELLOW}[WARN]${NC} $1"+}++log_error() {+ echo -e "${RED}[ERROR]${NC} $1"+ exit 1+}++show_help() {+ echo "ServerKit Agent Installation Script"+ echo ""+ echo "Usage: install.sh [OPTIONS]"+ echo ""+ echo "Options:"+ echo " --token, -t Registration token (required)"+ echo " --server, -s ServerKit server URL (required)"+ echo " --name, -n Display name for this server (optional)"+ echo " --version, -v Specific agent version (optional, defaults to latest)"+ echo " --help, -h Show this help message"+ echo ""+ echo "Example:"+ echo " curl -fsSL https://your-serverkit.com/install.sh | sudo bash -s -- \\"+ echo " --token 'sk_reg_xxx' \\"+ echo " --server 'https://your-serverkit.com'"+ exit 0+}++parse_args() {+ while [[ $# -gt 0 ]]; do+ case $1 in+ --token|-t)+ TOKEN="$2"+ shift 2+ ;;+ --server|-s)+ SERVER_URL="$2"+ shift 2+ ;;+ --name|-n)+ SERVER_NAME="$2"+ shift 2+ ;;+ --version|-v)+ VERSION="$2"+ shift 2+ ;;+ --help|-h)+ show_help+ ;;+ *)+ log_error "Unknown option: $1"+ ;;+ esac+ done++ # Validate required arguments+ if [[ -z "$TOKEN" ]]; then+ log_error "Registration token is required. Use --token or -t"+ fi++ if [[ -z "$SERVER_URL" ]]; then+ log_error "Server URL is required. Use --server or -s"+ fi+}++check_root() {+ if [[ $EUID -ne 0 ]]; then+ log_error "This script must be run as root (use sudo)"+ fi+}++detect_platform() {+ OS=$(uname -s | tr '[:upper:]' '[:lower:]')+ ARCH=$(uname -m)++ case "$ARCH" in+ x86_64|amd64)+ ARCH="amd64"+ ;;+ aarch64|arm64)+ ARCH="arm64"+ ;;+ *)+ log_error "Unsupported architecture: $ARCH"+ ;;+ esac++ if [[ "$OS" != "linux" ]]; then+ log_error "This script only supports Linux. For Windows, use install.ps1"+ fi++ log_info "Detected platform: ${OS}-${ARCH}"+}++check_dependencies() {+ log_info "Checking dependencies..."++ # Check for required tools+ for cmd in curl tar; do+ if ! command -v "$cmd" &> /dev/null; then+ log_error "$cmd is required but not installed"+ fi+ done++ # Check for systemd+ if ! command -v systemctl &> /dev/null; then+ log_warn "systemd not found. You will need to start the agent manually."+ fi+}++get_latest_version() {+ if [[ "$VERSION" == "latest" ]]; then+ log_info "Fetching latest version..."+ VERSION=$(curl -fsSL "https://api.github.com/repos/${GITHUB_REPO}/releases" | \+ grep -oP '"tag_name": "agent-v\K[^"]+' | head -1)++ if [[ -z "$VERSION" ]]; then+ log_error "Failed to fetch latest version"+ fi+ log_info "Latest version: v${VERSION}"+ fi+}++download_agent() {+ log_info "Downloading ServerKit Agent v${VERSION}..."++ DOWNLOAD_URL="https://github.com/${GITHUB_REPO}/releases/download/agent-v${VERSION}/serverkit-agent-${VERSION}-linux-${ARCH}.tar.gz"+ TMP_DIR=$(mktemp -d)+ ARCHIVE="${TMP_DIR}/serverkit-agent.tar.gz"++ if ! curl -fsSL "$DOWNLOAD_URL" -o "$ARCHIVE"; then+ rm -rf "$TMP_DIR"+ log_error "Failed to download agent from: $DOWNLOAD_URL"+ fi++ # Extract binary+ log_info "Extracting agent..."+ tar -xzf "$ARCHIVE" -C "$TMP_DIR"++ # Install binary+ mv "${TMP_DIR}/serverkit-agent-linux-${ARCH}" "${INSTALL_DIR}/${AGENT_BINARY}"+ chmod +x "${INSTALL_DIR}/${AGENT_BINARY}"++ # Cleanup+ rm -rf "$TMP_DIR"++ log_success "Agent installed to ${INSTALL_DIR}/${AGENT_BINARY}"+}++create_user() {+ if id "$SERVICE_USER" &>/dev/null; then+ log_info "User $SERVICE_USER already exists"+ else+ log_info "Creating service user: $SERVICE_USER"+ useradd -r -s /bin/false -d /nonexistent "$SERVICE_USER"+ fi++ # Add to docker group if it exists+ if getent group docker > /dev/null 2>&1; then+ usermod -aG docker "$SERVICE_USER"+ log_info "Added $SERVICE_USER to docker group"+ fi+}++create_config_dir() {+ log_info "Creating configuration directory..."+ mkdir -p "$CONFIG_DIR"+ chown "$SERVICE_USER:$SERVICE_USER" "$CONFIG_DIR"+ chmod 750 "$CONFIG_DIR"+}++register_agent() {+ log_info "Registering agent with ServerKit..."++ REGISTER_CMD="${INSTALL_DIR}/${AGENT_BINARY} register --token \"${TOKEN}\" --server \"${SERVER_URL}\""++ if [[ -n "$SERVER_NAME" ]]; then+ REGISTER_CMD="${REGISTER_CMD} --name \"${SERVER_NAME}\""+ fi++ if ! eval "$REGISTER_CMD"; then+ log_error "Agent registration failed"+ fi++ # Fix permissions on config files+ chown -R "$SERVICE_USER:$SERVICE_USER" "$CONFIG_DIR"++ log_success "Agent registered successfully"+}++install_systemd_service() {+ if ! command -v systemctl &> /dev/null; then+ log_warn "Skipping systemd service installation (systemd not found)"+ return+ fi++ log_info "Installing systemd service..."++ cat > /etc/systemd/system/serverkit-agent.service << EOF+[Unit]+Description=ServerKit Agent+Documentation=https://github.com/${GITHUB_REPO}+After=network-online.target docker.service+Wants=network-online.target++[Service]+Type=simple+User=${SERVICE_USER}+Group=${SERVICE_USER}+ExecStart=${INSTALL_DIR}/${AGENT_BINARY} start+Restart=always+RestartSec=10+StandardOutput=journal+StandardError=journal+SyslogIdentifier=serverkit-agent++# Security hardening+NoNewPrivileges=true+ProtectSystem=strict+ProtectHome=true+ReadWritePaths=${CONFIG_DIR}+PrivateTmp=true++# Environment+Environment=HOME=/nonexistent++[Install]+WantedBy=multi-user.target+EOF++ systemctl daemon-reload+ systemctl enable serverkit-agent++ log_success "Systemd service installed"+}++start_service() {+ if ! command -v systemctl &> /dev/null; then+ log_warn "Cannot auto-start without systemd"+ echo ""+ echo "To start the agent manually:"+ echo " ${INSTALL_DIR}/${AGENT_BINARY} start"+ return+ fi++ log_info "Starting ServerKit Agent..."+ systemctl start serverkit-agent++ sleep 2++ if systemctl is-active --quiet serverkit-agent; then+ log_success "Agent is running"+ else+ log_error "Failed to start agent. Check logs with: journalctl -u serverkit-agent"+ fi+}++print_success() {+ echo ""+ echo -e "${GREEN}╔═══════════════════════════════════════════════════════════╗${NC}"+ echo -e "${GREEN}║ Installation completed successfully! ║${NC}"+ echo -e "${GREEN}╚═══════════════════════════════════════════════════════════╝${NC}"+ echo ""+ echo "Agent Status:"+ echo " Binary: ${INSTALL_DIR}/${AGENT_BINARY}"+ echo " Config: ${CONFIG_DIR}/config.yaml"+ echo " Service: serverkit-agent"+ echo ""+ echo "Useful commands:"+ echo " Check status: systemctl status serverkit-agent"+ echo " View logs: journalctl -u serverkit-agent -f"+ echo " Restart agent: systemctl restart serverkit-agent"+ echo " Stop agent: systemctl stop serverkit-agent"+ echo ""+}++# Main execution+main() {+ print_banner+ parse_args "$@"+ check_root+ detect_platform+ check_dependencies+ get_latest_version+ download_agent+ create_user+ create_config_dir+ register_agent+ install_systemd_service+ start_service+ print_success+}++main "$@"