Download the PHP package filaforge/filament-terminal-console without Composer

Filaforge Terminal Console

A powerful Filament plugin that provides a web-based terminal console directly in your admin panel for command execution and system management.

Features

• Web-based Terminal: Full terminal experience in your browser
• Command Execution: Run system commands and scripts
• File Management: Navigate and manage files through terminal commands
• Process Control: Monitor and manage system processes
• Real-time Output: Live command execution and response display
• Command History: Track and reuse executed commands
• Session Management: Persistent terminal sessions
• Multi-user Support: Separate terminal sessions for each user
• Security Controls: Role-based access and command restrictions
• Audit Logging: Track all terminal activities for security

Installation

1. Install via Composer

2. Publish & Migrate

3. Register Plugin

Add the plugin to your Filament panel provider:

Setup

Prerequisites

Before using this plugin, ensure your system meets these requirements:

• Linux/Unix System: Compatible operating system for terminal operations
• System Permissions: Appropriate permissions for command execution
• Sudo Access: Sudo access for administrative operations
• Required Tools: Essential system utilities installed

Configuration

The plugin will automatically:

• Publish configuration files to config/terminal-console.php
• Publish view files to resources/views/vendor/terminal-console/
• Publish migration files to database/migrations/
• Register necessary routes and middleware

Terminal Configuration

Configure the terminal console in the published config file:

Environment Variables

Add these to your .env file:

Usage

Accessing the Terminal Console

1. Navigate to your Filament admin panel
2. Look for the "Terminal Console" menu item
3. Open a new terminal session

Basic Terminal Operations

1. Command Execution: Type commands and press Enter
2. File Navigation: Use cd, ls, pwd for file operations
3. File Management: Create, edit, and delete files
4. Process Control: Monitor and manage system processes
5. System Information: Get system status and information

Advanced Features

• Tab Completion: Use Tab key for command and file completion
• Command History: Access previous commands with arrow keys
• Session Persistence: Terminal sessions persist across page refreshes
• Multi-tab Support: Open multiple terminal tabs
• Custom Aliases: Create and use command aliases

Security Features

• Command Whitelisting: Only allowed commands can be executed
• Dangerous Command Blocking: Prevents execution of harmful commands
• Directory Restrictions: Limits access to sensitive directories
• User Isolation: Each user has separate terminal sessions
• Activity Logging: All commands are logged for audit purposes

Troubleshooting

Common Issues

• Permission denied: Ensure the user has appropriate system access
• Command not found: Check if the command is in the allowed list
• Session timeout: Increase session timeout in configuration
• Performance issues: Check system resources and command complexity

Debug Steps

1. Check the plugin configuration:

2. Verify routes are registered:

3. Check system permissions:

4. Test basic terminal functionality:

5. Clear caches:

6. Check logs for errors:

Terminal-Specific Issues

Command Execution

• Command blocked: Check allowed_commands configuration
• Permission errors: Verify user permissions for command execution
• Timeout issues: Adjust max_execution_time setting

File Operations

• Access denied: Check directory restrictions and permissions
• File not found: Verify file paths and existence
• Permission errors: Check file and directory permissions

Process Management

• Process not found: Verify process exists and is accessible
• Permission denied: Check user permissions for process operations
• High resource usage: Monitor terminal resource consumption

Security Considerations

Access Control

• Role-based permissions: Restrict terminal access to authorized users only
• Command restrictions: Whitelist allowed commands and block dangerous ones
• Directory restrictions: Limit access to sensitive system directories
• User isolation: Ensure users can only access their own terminal sessions

Best Practices

• Never expose terminal console to public users
• Regularly review and update command whitelists
• Monitor terminal usage and log suspicious activities
• Implement proper user authentication and authorization
• Use HTTPS for secure access
• Regular security audits of terminal access

Command Security

• Whitelist approach: Only allow necessary commands
• Input validation: Validate all command inputs
• Output sanitization: Sanitize command outputs
• Rate limiting: Prevent command flooding attacks

Performance Optimization

System Requirements

• CPU: Sufficient CPU for command execution
• Memory: Adequate RAM for terminal sessions
• Storage: Fast storage for command operations
• Network: Stable network for web terminal access

Optimization Tips

• Use command caching for repeated operations
• Implement session pooling for multiple users
• Monitor system resources during peak usage
• Optimize command execution timeouts

Session Management

• Session pooling: Reuse terminal sessions when possible
• Connection limits: Limit concurrent terminal connections
• Resource monitoring: Monitor terminal resource usage
• Cleanup strategies: Implement proper session cleanup

Uninstall

1. Remove Plugin Registration

Remove the plugin from your panel provider:

2. Roll Back Migrations (Optional)

3. Remove Published Assets (Optional)

4. Remove Package and Clear Caches

5. Clean Up Environment Variables

Remove these from your .env file:

6. Security Cleanup

After uninstalling, consider:

• Reviewing system access permissions
• Cleaning up any custom terminal configurations
• Removing any scheduled tasks or cron jobs
• Updating system security settings

Support

• Documentation: GitHub Repository
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This plugin is open-sourced software licensed under the MIT license.

Made with ❤️ by the Filaforge Team