153 lines
3.2 KiB
Markdown
153 lines
3.2 KiB
Markdown
# Docker Installation Scripts for CloudPanel
|
|
|
|
A collection of installation scripts for deploying various Docker applications with CloudPanel integration. These scripts provide automated installation, configuration, and troubleshooting for popular self-hosted applications.
|
|
|
|
## 🚀 Features
|
|
|
|
- Automated Docker and application installation
|
|
- CloudPanel integration support
|
|
- Robust error handling and logging
|
|
- Port conflict detection
|
|
- Automatic service health checks
|
|
- Backup and restore functionality
|
|
- Comprehensive troubleshooting guides
|
|
|
|
## 📋 Available Scripts
|
|
|
|
### CyberChef Installation Script
|
|
- Web-based cyber security toolkit deployment
|
|
- Single container setup
|
|
- Port availability verification
|
|
- Health monitoring
|
|
- CloudPanel reverse proxy support
|
|
|
|
## 🔧 Prerequisites
|
|
|
|
- Ubuntu 24.04 ONLY
|
|
- Root access or sudo privileges
|
|
- CloudPanel pre-installed
|
|
- Domain/subdomain pointing to your server
|
|
|
|
## 📥 Installation
|
|
|
|
1. Download this script:
|
|
```bash
|
|
wget https://git.hhf.technology/hhf/cyberchef_ngx_cloudpanel/raw/branch/main/install-cyberchef.sh
|
|
|
|
```
|
|
|
|
2. Make scripts executable:
|
|
```bash
|
|
chmod +x install-cyberchef.sh
|
|
```
|
|
|
|
3. Run desired installation script:
|
|
```bash
|
|
sudo ./install-cyberchef.sh
|
|
```
|
|
|
|
## 🛠️ Usage Examples
|
|
|
|
|
|
### Installing CyberChef:
|
|
```bash
|
|
sudo ./install-cyberchef.sh
|
|
# Configure CloudPanel reverse proxy after installation
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
Each script includes the following configurable elements:
|
|
|
|
### CyberChef Script
|
|
- Port settings
|
|
- Network configuration
|
|
- Volume mappings
|
|
|
|
## 🔍 Troubleshooting
|
|
|
|
### Common Issues and Solutions
|
|
|
|
1. Port Conflicts:
|
|
```bash
|
|
# Check for port usage
|
|
sudo lsof -i :port_number
|
|
# Kill conflicting process
|
|
sudo kill process_id
|
|
```
|
|
|
|
2. Container Health Check Failures:
|
|
```bash
|
|
# View container logs
|
|
docker compose logs service_name
|
|
# Restart service
|
|
docker compose restart service_name
|
|
```
|
|
|
|
3. Permission Issues:
|
|
```bash
|
|
# Fix volume permissions
|
|
sudo chown -R 1000:1000 /path/to/volume
|
|
```
|
|
|
|
## 🔒 Security Recommendations
|
|
|
|
1. Always use HTTPS with valid SSL certificates
|
|
2. Regularly update Docker and containers
|
|
3. Implement proper firewall rules
|
|
4. Use strong passwords for services
|
|
5. Regular backup of important data
|
|
|
|
## 📝 Logging
|
|
|
|
Logs are stored in the following locations:
|
|
|
|
- Docker: `/var/log/docker.log`
|
|
- CyberChef: `/var/log/cyberchef-install.log`
|
|
|
|
## 🔄 Updates
|
|
|
|
To update installed applications:
|
|
|
|
```bash
|
|
cd /docker/application_name
|
|
docker compose pull
|
|
docker compose up -d
|
|
```
|
|
|
|
## 💾 Backup and Restore
|
|
|
|
### Backup:
|
|
```bash
|
|
# For any application
|
|
cd /docker
|
|
tar -czf application_backup.tar.gz application_name/
|
|
```
|
|
|
|
### Restore:
|
|
```bash
|
|
cd /docker
|
|
tar -xzf application_backup.tar.gz
|
|
cd application_name
|
|
docker compose up -d
|
|
```
|
|
|
|
## 📄 License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
## 🙏 Acknowledgments
|
|
|
|
* CloudPanel team for their excellent platform
|
|
* Docker community for container solutions
|
|
* Original application developers (CyberChef)
|
|
|
|
## 📞 Support
|
|
|
|
For support:
|
|
1. Check the troubleshooting guides
|
|
2. Review the application logs
|
|
3. [Join our community discussions](https://forum.hhf.technology/t/installing-cyberchef-with-cloudpanel-a-complete-guide-2025-ubuntu-24-04-only/456)
|
|
|
|
---
|
|
⌨️ with ❤️ by HHF Technology
|